Apache Airflow - Load control environment

This article outlines a potential setup for an environment for Apache Airflow load control.

Please note that the installation and configuration of this target environment fall outside the scope of biGENIUS support.

We will not offer assistance beyond the provided example in this article.

An Apache Airflow load control environment has numerous alternative configurations and installations.

Below is a potential environment setup for an Apache Airflow load control.

Tools

Please install the following tools:

Docker Desktop (download available here)
Powershell 7 or higher (download available here)

Prerequisites

Before creating the Apache Airflow environment, please execute the following steps:

Create the following repository structure where you want to use Airflow:

The main repository called airflow in the previous picture can be adapted to your choice. The sub-repositories must have the same names as in the picture.

Download and copy the following files inside the main repository (airflow in this example):
- docker-compose.yaml: It is a YAML file that defines and configures all the containers to create for our Airflow environment
  - Please uncomment between lines 64 to 71: the line for the connection to the target solution environment corresponding to the target technology you want to use
- .env: It defines an environment variable mandatory for the environment
- requirements.txt: It defines the dependencies to add depending on the target technology
  - Please uncomment the provider corresponding to the target technology you want to use
- Dockerfile: It permits the use of the requirements.txt during the container's creation
Copy the generated Python artifacts (XXX_dag.py) for Airflow load control in the dags sub-repository:

Microsoft SQL Server on Docker Target solution

If you are using Microsoft SQL Server on Docker as a Target solution, please execute the following command in Powershell to find out the IP address to set up in Airflow:

docker inspect -f '' training-sqlserver-2022

Update accordingly the IP address in line 65 in the docker-compose.yaml, for example:

AIRFLOW__CORE__SQL_ALCHEMY_CONN: sql+pythosmssql://sa:Admin2022!@192.168.112.8:1433/airflow

Databricks Target solution

If you are using Databricks as a Target solution, please:

Create a Personal Access Token (PAT): https://docs.databricks.com/en/dev-tools/auth/pat.html
Find your host URL: this is the link used to open Databricks from Azure without the https://

Update the connection in the docker-compose.yaml file:

--Replace host-url by your databricks host
--Replace yourtoken by the PAT created
AIRFLOW_CONN_DATABRICKS_DEFAULT: 'databricks://:@host-url?token=yourtoken'

Environment setup

To set up the Airflow environment, please execute the following steps:

Create a network with the following command in Powershell:

docker network create training-network

If you want to use Microsoft SQL Server on Docker as a Target solution, you must create and use the same Docker network.

If you already created it, skip this step.

Initialize the Postgres database used by the Airflow application, run database migrations, and create the first user account with the following command in Powershell:

docker compose up airflow-init

Let’s wait for the operations to complete, and you should see the following feedback after some minutes:
Your Postgres database is created, and credentials are as follows:
- username: airflow
- password: airflow
Start your local Airflow instance with the following command in Powershell:

docker compose up

When you can see the following feedback, the Airflow instance is ready:
Navigate to the Airflow homepage http://localhost:8080
Enter the following credentials:
- username: airflow
- password: airflow
You should have the following result:

You can now load data with Apache Airflow.