환경 변수 설정

이 페이지에서는 Cloud Composer에서 환경 변수를 설정할 때 적용되는 요구사항을 설명합니다.

환경을 만들거나 업데이트할 때 Cloud Composer가 Apache Airflow 스케줄러, 작업자, 웹 서버 프로세스에 제공하는 환경 변수를 추가할 수 있습니다. 예를 들어 Cloud Composer는 이메일 알림에 Apache Airflow sendgrid 모듈을 사용합니다. 이메일 알림을 구성하려면 SENDGRID_API_KEYSENDGRID_MAIL_FROM 환경 변수를 설정해야 합니다.

요구사항

환경 변수는 정규 표현식 [a-zA-Z_][a-zA-Z0-9_]*와 일치해야 합니다.

환경 변수는 Apache Airflow 소프트웨어 구성 재정의를 지정하지 않아야 합니다. 즉, 변수는 $AIRFLOW__{SECTION}__{KEY} 형식을 사용하거나 정규 표현식 AIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+) 와 일치할 수 없습니다.

예약된 이름

다음 이름은 예약되어 있으므로 사용될 수 없습니다.

  • AIRFLOW_HOME
  • C_FORCE_ROOT
  • COMPOSER_ENVIRONMENT
  • COMPOSER_GKE_NAME
  • COMPOSER_GKE_ZONE
  • COMPOSER_LOCATION
  • COMPOSER_PYTHON_VERSION
  • CONTAINER_NAME
  • DAGS_FOLDER
  • GCP_PROJECT
  • GCS_BUCKET
  • GKE_CLUSTER_NAME
  • GOOGLE_APPLICATION_CREDENTIALS
  • SQL_DATABASE
  • SQL_INSTANCE
  • SQL_PASSWORD
  • SQL_PROJECT
  • SQL_REGION
  • SQL_USER

시작하기 전에

  • 환경 변수를 설정하려면 다음 권한이 필요합니다.

    • composer.environments.create - 환경 생성 중에 환경 변수를 설정합니다.
    • composer.environments.update - 환경 변수를 업데이트합니다.

      자세한 내용은 Cloud Composer 액세스 제어를 참조하세요.

  • 대부분 gcloud composer 명령어에는 위치가 필요합니다. 위치를 지정하려면 --location 플래그를 사용하거나 기본 위치를 설정하면 됩니다.

환경 변수 추가 및 업데이트

환경 변수를 설정하려면 다음 안내를 따르세요.

콘솔

환경 변수를 추가하려면 다음 안내를 따르세요.

  1. Google Cloud Console에서 환경 만들기 페이지를 엽니다.

    환경 만들기 페이지 열기

  2. 노드 구성에서 환경 변수 추가를 클릭합니다.

  3. 환경 변수에 NAMEVALUE를 입력합니다.

gcloud

gcloud composer environments update ENVIRONMENT_NAME \
  --location LOCATION \
  --update-env-variables=KEY=VALUE,KEY=VALUE...

각 항목의 의미는 다음과 같습니다.

  • ENVIRONMENT_NAME은 환경 이름입니다.
  • LOCATION은 환경이 위치한 Compute Engine 리전입니다.
  • KEY=VALUE는 만들거나 업데이트할 환경 변수를 지정합니다.

예:

gcloud composer environments update test-environment 
--location us-central1
--update-env-variables=SENDGRID_MAIL_FROM=updated-email@domain.com

API

Cloud Composer REST API를 사용하려면 environments.patch를 실행합니다.

환경 변수 삭제

환경 변수를 삭제하려면 다음 안내를 따르세요.

콘솔

  1. 환경 페이지를 엽니다.

    환경 페이지 열기

  2. 환경 나열 페이지에서 세부정보를 볼 환경의 이름을 클릭합니다.
  3. 환경 변수에서 수정을 클릭합니다.
  4. 변수 값 오른쪽에 있는 휴지통 아이콘을 클릭합니다.

gcloud

모든 환경 변수를 삭제하려면 다음을 사용하세요.

gcloud composer environments update ENVIRONMENT_NAME 
--location LOCATION
--clear-env-variables

각 항목의 의미는 다음과 같습니다.

  • ENVIRONMENT_NAME은 환경 이름입니다.
  • LOCATION은 환경이 위치한 Compute Engine 리전입니다.

예:

gcloud composer environments update test-environment 
--location us-central1
--clear-env-variables

환경 변수 목록을 삭제하려면 다음을 사용하세요.

gcloud composer environments update ENVIRONMENT_NAME 
--location LOCATION
--remove-env-variables=NAME,NAME,...
각 매개변수는 다음과 같습니다.

  • ENVIRONMENT_NAME은 환경 이름입니다.
  • LOCATION은 환경이 위치한 Compute Engine 리전입니다.
  • NAME은 삭제할 환경 변수입니다.

API

Cloud Composer REST API를 사용하려면 environments.patch를 실행합니다.