Airflow Entrypoint

Entrypoint

 프로덕션 이미지의 기본 진입점을 사용하는 경우 컨테이너가 시작될 때 자동으로 수행되는 몇 가지 동작이 있습니다. 어떤 경우에는 환경 변수를 이미지에 전달하여 해당 동작 중 일부를 트리거할 수 있습니다.

임의의 사용자가 컨테이너를 실행하도록 허용

 Airflow 이미지는 Open-Shift와 호환되므로 임의의 사용자 ID와 그룹 ID 0( root)로 시작할 수 있습니다. Airflow와 다른 사용자로 이미지를 실행하려면 사용자의 GID를 .으로 설정해야 합니다 0. 다른 그룹을 사용하려고 하면 진입점이 오류와 함께 종료됩니다.

OpenShift는 컨테이너를 시작할 때 UID를 무작위로 할당하지만, 이미지를 수동으로 실행하는 경우에도 이 유연한 UID를 활용할 수 있습니다. 이는 예를 들어 Linux에서 호스트 시스템의 폴더를 마운트하려는 경우 유용할 수 있으며 dag, logs이 경우 UID는 호스트 사용

자와 동일한 ID로 설정해야 합니다.

 

 이미지를 확장하거나 사용자 정의할 때 USER를 변경할 수도 있고, 다음 형식 중 하나로 플래그를 추가하여 사용자를 명령 에 동적으로 전달할 수도 있습니다( 자세한 내용은 Docker Run 참조).

 

docker run --user

[ user | user:group | uid | uid:gid | user:gid | uid:group ]

 

주의

 Docker Compose 환경의 경우 docker-compose.yaml의 user: 항목을 통해 변경할 수 있습니다. 자세한 내용은 Docker Compose 참조를 확인하세요. Docker-Compose를 사용하는 Quickstart Guide에서는 초기화 단계에서 AIRFLOW_UID 변수를 통해 UID를 전달할 수 있습니다.

 

 사용자는 어떤 UID라도 사용할 수 있습니다. 기본 airflow (UID=50000)와 다른 UID를 사용하는 경우, 컨테이너에 들어갈 때 사용자가 자동으로 생성됩니다.

 

 다양한 외부 라이브러리와 프로젝트를 수용하기 위해, Airflow는 해당 사용자를 (/etc/passwd)에 자동으로 생성하고 홈 디렉토리를 /home/airflow로 설정합니다. 많은 서드파티 라이브러리와 패키지들은 사용자의 홈 디렉토리가 존재해야 캐시 정보를 기록할 수 있으므로, 이러한 동적 사용자 생성이 필요합니다.

 

 임의 사용자는 특정 디렉토리에 쓰기 권한을 가져야 하며, 보안상의 이유로 “other”에 쓰기 권한을 부여하는 것은 권장되지 않습니다. OpenShift 지침에서는 모든 필요한 폴더에 0 (root) 그룹 ID (GID)를 부여하는 개념을 도입했습니다. Airflow 프로덕션 이미지에서 쓰기 권한이 필요한 모든 디렉토리는 GID가 0으로 설정되어 있으며, 그룹에 쓰기 권한이 있습니다. 우리는 이 개념을 따르며, 쓰기 권한이 필요한 모든 디렉토리는 이를 따릅니다.

 

 airflow 사용자의 기본 GID는 0으로 설정되어 있어, 사용자가 생성하는 모든 디렉토리는 기본적으로 GID가 0으로 설정됩니다. entrypoint는 umask를 0002로 설정합니다 - 이는 사용자가 생성하는 모든 디렉토리가 그룹 0에 대한 "그룹 쓰기" 권한을 가지게 하며, root 그룹의 다른 사용자들도 이를 쓸 수 있게 합니다. 또한, 임의의 사용자가 폴더를 생성하는 경우 (예: 마운트된 볼륨에서), 해당 폴더는 "그룹 쓰기" 권한과 GID=0을 가지게 되어, 나중에 다른 임의의 사용자가 해당 디렉토리를 마운트하더라도 실행이 계속되도록 합니다.

 

 그러나 umask 설정은 컨테이너 실행 시간 동안에만 적용되며, 이미지 빌드 시에는 적용되지 않습니다. 이미지를 확장하고 자체 패키지를 추가하려면 docker 명령어 앞에 umask 0002를 추가해야 합니다 - 이를 통해 설치 중 생성된 디렉토리가 그룹에 대한 쓰기 권한을 가지게 됩니다.

 

예를 들어 다음과 같이 할 수 있습니다:

RUN umask 0002; \
    do_something; \
    do_otherthing;

---

 

정리

1. Airflow의 기본 UID는 50000이다.

2. Airflow는 /etc/passwd에 사용자의 권한을 등록한다.

3. GID는 프로덕션에서 사용하기 위한 쓰기 권한을 관리한다. 마운트 되어도 유지