작업 환경 변수 구성

이 페이지에서는 Cloud Run 작업 환경 변수를 구성하는 방법을 설명합니다.

환경 변수를 설정하면 이러한 변수가 컨테이너에 삽입되고 코드에서 액세스할 수 있습니다. 환경 변수는 키-값 쌍으로 설정됩니다.

예약된 이름

컨테이너 런타임 계약에 정의된 환경 변수는 예약되어 있으며 설정할 수 없습니다.

최대 환경 변수 수

각 Cloud Run 작업에서 컨테이너당 최대 1,000개의 환경 변수를 설정할 수 있습니다.

필요한 역할

Cloud Run 작업을 구성하는 데 필요한 권한을 얻으려면 관리자에게 작업에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • Cloud Run 개발자(roles/run.developer) - Cloud Run 작업
  • 서비스 계정 사용자(roles/iam.serviceAccountUser) - 서비스 ID

Cloud Run과 연결된 IAM 역할 및 권한 목록은 Cloud Run IAM 역할 및 Cloud Run IAM 권한을 참조하세요. Cloud Run 작업이 Cloud 클라이언트 라이브러리와 같은Google Cloud API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여 방법에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

환경 변수 설정하기

신규 및 기존 작업의 환경 변수를 설정할 수 있습니다. --set-env-vars 플래그는 새 환경 변수 목록에 포함되지 않은 이전에 설정한 환경 변수를 삭제하는 파괴적인 작업입니다.

Google Cloud 콘솔, gcloud CLI 또는 YAML 파일을 사용하여 환경 변수를 설정할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Run 작업 페이지로 이동합니다.

    Cloud Run으로 이동

  2. 메뉴에서 작업을 선택하고 컨테이너 배포를 클릭하여 초기 작업 설정 페이지를 작성합니다. 기존 작업을 구성하는 경우 작업을 선택한 후 수정을 클릭합니다.

  3. 컨테이너, 볼륨, 연결, 보안을 클릭하여 작업 속성 페이지를 펼칩니다.

  4. 변수 탭을 클릭합니다.

    이미지

    • 다음 단계를 따르세요.
      • 변수를 추가하려면 변수 추가를 클릭하고 이름 및 값 텍스트 상자에 변수의 이름과 해당 값을 지정합니다.
      • 변수의 값을 변경하려면 값 텍스트 상자의 현재 값을 원하는 값으로 바꿉니다.
      • 1개 이상의 환경 변수를 삭제하려면 마우스 커서를 삭제할 변수의 값 텍스트 상자 왼쪽으로 가져가서 휴지통 아이콘을 표시하고 클릭합니다.

  5. 만들기 또는 업데이트를 클릭합니다.

gcloud

작업을 배포할 때 환경 변수를 지정하려면 --set-env-vars 플래그를 사용합니다.

gcloud run jobs deploy JOB_NAME --image IMAGE_URL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

작업을 업데이트할 때 환경 변수를 지정하려면 작업 생성 후에 --set-env-vars 플래그를 사용합니다.

gcloud run jobs create JOB_NAME --image IMAGE_URL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

gcloud run jobs update JOB_NAME --update-env-vars KEY1=VALUE1,KEY2=VALUE2

다음과 같이 바꿉니다.

  • JOB_NAME을 작업 이름으로 바꿉니다.
  • KEY1=VALUE1,KEY2=VALUE2을 쉼표로 구분된 변수 이름 및 값 목록으로 바꿉니다.
  • IMAGE_URL을 컨테이너 이미지에 대한 참조로 바꿉니다(예: us-docker.pkg.dev/cloudrun/container/job:latest).

여러 환경 변수 설정

KEY1=VALUE1,KEY2=VALUE2 형식으로 나열할 수 없는 환경 변수가 많은 경우 --set-env-vars 플래그를 여러 번 반복할 수 있습니다. 
   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

쉼표 문자 이스케이프 처리

쉼표 문자(,)는 환경 변수를 분할하는 데 사용되므로 환경 변수에 쉼표 문자가 값으로 포함되어 있으면 다른 구분 기호 문자(예: @)를 지정하여 구분 기호를 이스케이프 처리해야 합니다. 
--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

YAML

  1. 새 작업을 만드는 경우에는 이 단계를 건너뜁니다. 기존 작업을 업데이트하는 경우 YAML 구성을 다운로드합니다.

    gcloud run jobs describe JOB_NAME --format export > job.yaml
    1. containers: 아래에 표시된 것처럼 env 아래의 name 및 value 속성을 업데이트합니다.
    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
            env:
            - name: KEY-1
              value: VALUE-1
            - name: KEY-N
              value: VALUE-N

    KEY-1 및 VALUE-1을 각각 환경 변수와 값으로 바꿉니다. 필요에 따라 변수와 값을 더 추가해도 됩니다.

    또한 환경 변수 또는 메모리 제한과 같은 추가 구성을 지정할 수 있습니다.

  3. 기존 작업 구성을 업데이트합니다.

    gcloud run jobs replace job.yaml

Terraform

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

Terraform 구성에서 다음을 google_cloud_run_v2_job 리소스에 추가합니다.

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
        env {
          name = "KEY-1"
          value = "VALUE-1"
        }
        env {
          name = "KEY-N"
          value = "VALUE-N"
        }
      }
    }
  }
}

다음과 같이 바꿉니다.

  • JOB_NAME을 Cloud Run 작업 이름으로 바꿉니다.
  • REGION을 Google Cloud 리전으로 바꿉니다. 예를 들면 europe-west1입니다.
  • KEY-1을 환경 변수로 바꿉니다.
  • VALUE-1을 값으로 바꿉니다.

원하는 경우 env 블록을 추가하여 추가 환경 변수를 설정합니다.

컨테이너에 기본 환경 변수 설정

Dockerfile에서 ENV 문을 사용하여 환경 변수의 기본값을 설정할 수 있습니다.

ENV KEY1=VALUE1,KEY2=VALUE2

우선 순위: 컨테이너와 작업 변수 비교

컨테이너에서 기본 환경 변수를 설정하고 Cloud Run 작업에서도 이름이 같은 환경 변수를 설정하면 작업에 설정된 값이 우선 적용됩니다.

환경 변수 업데이트

기존 작업의 환경 변수를 업데이트할 수 있습니다. 이는 비파괴적인 방식으로, 환경 변수를 변경 또는 추가하지만 이전에 설정된 환경 변수를 삭제하지는 않습니다.

콘솔

Google Cloud 콘솔을 사용하여 환경 변수를 업데이트하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 Cloud Run으로 이동합니다.

    Cloud Run으로 이동

  2. 목록에서 작업을 선택하고 새 버전 수정 및 배포를 클릭합니다.

  3. 컨테이너 탭을 클릭합니다.

  4. 변수 및 보안 비밀 탭에서 이름 또는 값 필드를 수정한 다음 완료를 클릭합니다.

  5. 배포를 클릭합니다.

gcloud

기존 작업의 환경 변수를 업데이트하려면 --update-env-vars 플래그를 사용합니다.

gcloud run jobs update JOB_NAME --update-env-vars KEY1=VALUE1,KEY2=VALUE2

다음과 같이 바꿉니다.

  • JOB_NAME을 작업 이름으로 바꿉니다.
  • KEY1=VALUE1,KEY2=VALUE2를 쉼표로 구분된 변수 이름 및 값 목록으로 바꿉니다.

환경 변수 설정 보기

Cloud Run 작업의 현재 환경 변수 설정을 보려면 다음 안내를 따르세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Run 작업 페이지로 이동합니다.

    Cloud Run 작업으로 이동

  2. 관심 있는 작업을 클릭하여 작업 세부정보 페이지를 엽니다.

  3. 작업 구성 보기 및 수정을 클릭합니다.

  4. 구성 세부정보에서 환경 변수 설정을 찾습니다.

gcloud

  1. 다음 명령어를 사용하세요.

    gcloud run jobs describe JOB_NAME

  2. 반환된 구성에서 환경 변수 설정을 찾습니다.

환경 변수 삭제

기존 작업의 환경 변수를 삭제할 수 있습니다.

콘솔

Google Cloud 콘솔을 사용하여 환경 변수를 삭제하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 Cloud Run으로 이동합니다.

    Cloud Run으로 이동

  2. 목록에서 작업을 선택하고 새 버전 수정 및 배포를 클릭합니다.

  3. 컨테이너 탭을 클릭합니다.

  4. 변수 및 보안 비밀 탭에서 삭제할 환경 변수의 값 필드 왼쪽으로 커서를 이동하여 삭제 아이콘을 표시하고 클릭합니다.

  5. 완료를 클릭합니다.

  6. 배포를 클릭합니다.

gcloud

기존 작업의 환경 변수를 선택적으로 삭제하려면 --remove-env-vars 플래그를 사용합니다.

gcloud run jobs update JOB_NAME --remove-env-vars KEY1,KEY2

다음과 같이 바꿉니다.

  • JOB_NAME을 작업 이름으로 바꿉니다.
  • KEY1,KEY2를 쉼표로 구분된 변수 이름 목록으로 바꿉니다.

또는 --clear-env-vars 플래그를 사용하여 이전에 설정된 모든 환경 변수를 삭제할 수 있습니다.

gcloud run jobs update JOB_NAME --clear-env-vars

다음과 같이 바꿉니다.

  • JOB_NAME을 작업 이름으로 바꿉니다.