이 페이지에서는 Cloud Run 작업자 풀의 환경 변수를 구성하는 방법을 설명합니다.
구성을 변경하면 새 버전이 생성됩니다. 이를 변경하는 명시적 업데이트가 없으면 이후 버전에도 이 구성 설정이 자동으로 적용됩니다.
필요한 역할
Cloud Run 작업자 풀을 구성하고 배포하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.
-
Cloud Run 작업자 풀에 대한 Cloud Run 개발자(
roles/run.developer) 역할 -
서비스 ID에 대한 서비스 계정 사용자(
roles/iam.serviceAccountUser) 역할
Cloud Run과 연결된 IAM 역할 및 권한 목록은 Cloud Run IAM 역할 및 Cloud Run IAM 권한을 참조하세요. Cloud Run 작업자 풀이 Cloud 클라이언트 라이브러리와 같은Google Cloud API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.
환경 변수 설정하기
새 작업자 풀을 만들거나 새 버전을 배포할 때 Google Cloud CLI를 사용하여 환경 변수를 설정할 수 있습니다.
gcloud
작업자 풀을 배포하는 동안 환경 변수를 지정하려면 --set-env-vars 플래그를 사용합니다.
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2
다음과 같이 바꿉니다.
- WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
- KEY1=VALUE1,KEY2=VALUE2를 쉼표로 구분된 변수 이름 및 값 목록으로 바꿉니다.
- IMAGE_URL을 작업자 풀이 포함된 컨테이너 이미지에 대한 참조로 바꿉니다(예:
us-docker.pkg.dev/cloudrun/container/worker-pool:latest).
환경 변수 업데이트
기존 서비스의 런타임 환경 변수를 업데이트할 수 있습니다. 이는 비파괴적인 방식으로, 런타임 환경 변수를 변경 또는 추가하지만 삭제하지는 않습니다.
gcloud
기존 작업자 풀의 환경 변수를 업데이트하려면 --update-env-vars 플래그를 사용합니다.
gcloud beta run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2
다음과 같이 바꿉니다.
- WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
- KEY1=VALUE1,KEY2=VALUE2를 쉼표로 구분된 변수 이름 및 값 목록으로 바꿉니다.
환경 변수 삭제
gcloud
기존 작업자 풀에서 환경 변수를 선택적으로 삭제하려면 --remove-env-vars 플래그를 사용합니다.
gcloud beta run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2
다음과 같이 바꿉니다.
- WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
- KEY1,KEY2를 쉼표로 구분된 변수 이름 목록으로 바꿉니다.
또는 --clear-env-vars 플래그를 사용하여 이전에 설정된 모든 환경 변수를 삭제할 수 있습니다.
gcloud beta run worker-pools update WORKER_POOL --clear-env-vars
WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
작업자 풀의 환경 변수 구성 보기
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
작업자 풀을 클릭하여 배포된 작업자 풀 목록을 표시합니다.
검사하려는 작업자 풀을 클릭하여 세부정보 창을 표시합니다.
컨테이너 탭을 클릭하여 작업자 풀 컨테이너 구성을 표시합니다.
샘플 코드
코드에서 환경 변수에 액세스하는 방법을 보여주는 코드 샘플은 최종 사용자 인증 튜토리얼의 Secret Manager로 민감한 구성 처리를 참조하세요.
다음 단계
환경 변수를 사용하여 빌드팩 구성을 설정할 수 있습니다. 언어별 세부정보는 다음에 대한 빌드팩 문서를 참조하세요.