이 페이지에서는 작업자 풀에 대한 정보를 보고 작업자 풀을 삭제하는 방법을 설명합니다.
필요한 역할
Cloud Run 작업자 풀과 작업자 풀 버전을 관리하는 데 필요한 권한을 얻으려면 관리자에게 Cloud Run 작업자 풀에 대한 Cloud Run 개발자(roles/run.developer) IAM 역할을 부여해 달라고 요청하세요.
Cloud Run과 연결된 IAM 역할 및 권한 목록은 Cloud Run IAM 역할 및 Cloud Run IAM 권한을 참조하세요. Cloud Run 작업자 풀이 Cloud 클라이언트 라이브러리와 같은Google Cloud API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.
작업자 풀 만들기
개발자가 컨테이너 이미지를 처음 배포하면 Cloud Run에서 새 작업자 풀을 만듭니다. 자세한 내용은 새 작업자 풀 배포를 참조하세요.
프로젝트의 작업자 풀 목록 보기
Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 프로젝트에서 사용 가능한 작업자 풀 목록을 봅니다.
콘솔
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
메뉴에서 작업자 풀을 선택합니다. 사용 가능한 작업자 풀이 페이지에 나열됩니다.
gcloud
프로젝트의 작업자 풀을 나열하려면 다음을 실행합니다.
gcloud beta run worker-pools list
이 목록을 할당된 라벨과 같은 작업자 풀 정의 속성별로 필터링할 수 있습니다.
작업자 풀에 대한 세부정보 보기
Google Cloud 콘솔, Google Cloud CLI 또는 YAML을 사용하여 작업자 풀에 대한 세부정보를 확인합니다.
콘솔
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
메뉴에서 작업자 풀을 선택하여 사용 가능한 작업자 풀을 표시합니다.
작업자 풀을 클릭하여 세부정보 창을 표시합니다.
gcloud
작업자 풀에 대한 세부정보를 보려면 다음 안내를 따르세요.
gcloud beta run worker-pools describe WORKER_POOL
--format 플래그를 사용하여 출력 형식을 지정할 수 있습니다. 예를 들어 출력 형식을 YAML로 지정하려면 다음을 실행합니다.
gcloud beta run worker-pools describe WORKER_POOL --region REGION --format yaml
다음과 같이 바꿉니다.
- WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
- REGION을 작업자 풀의 Google Cloud 리전으로 바꿉니다.
YAML
작업자 풀에 대한 세부정보를 보려면 YAML 구성을 다운로드하세요.
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
기존 작업자 풀 사용 중지
작업자 풀을 사용 중지하면 해당 작업자 풀의 모든 인스턴스가 종료됩니다. 작업자 풀을 사용 중지하려면 확장을 0으로 설정합니다.
콘솔
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
메뉴에서 작업자 풀을 선택한 다음 작업자 풀 목록에서 사용 중지할 작업자 풀을 클릭합니다.
스케일링: 수동 (인스턴스: ) 오른쪽에 있는 펜 아이콘을 클릭하고 값을 0으로 변경합니다.
저장을 클릭하여 작업자 풀을 업데이트하고 사용 중지합니다.
gcloud
gcloud beta run worker-pools update WORKER_POOL --scaling=0
WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
YAML
새 작업자 풀을 만드는 경우에는 이 단계를 건너뜁니다. 기존 작업자 풀을 업데이트하는 경우 YAML 구성을 다운로드합니다.
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
작업자 풀을 사용 중지하려면 스케일을
0값으로 설정합니다. 다음 예시에는 YAML 구성이 포함되어 있습니다.apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/launch-stage: BETA run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: `0`
다음을 바꿉니다.
- WORKER_POOL: Cloud Run 작업자 풀의 이름
다음 명령어를 사용하여 작업자 풀을 만들거나 업데이트합니다.
gcloud beta run worker-pools replace workerpool.yaml
기존 작업자 풀 삭제
작업자 풀을 삭제할 때는 다음을 고려해야 합니다.
- 작업자 풀을 삭제하면 워크로드 처리 여부에 관계없이 해당 작업자 풀의 모든 버전을 포함하여 작업자 풀과 관련된 모든 리소스가 삭제됩니다.
- 작업자 풀을 삭제해도 컨테이너 이미지는 Artifact Registry에서 자동으로 삭제되지 않습니다. Artifact Registry에서 삭제된 버전에서 사용한 컨테이너 이미지를 삭제하려면 이미지 삭제를 참조하세요.
- 작업자 풀을 삭제한 후에는 삭제가 완전히 완료될 때까지 작업자 풀이 Google Cloud CLI에 계속 표시됩니다. 하지만 작업자 풀을 업데이트할 수 없습니다.
작업자 풀을 삭제하면 되돌릴 수 없습니다. 실행취소 또는 복원되지 않습니다.
콘솔
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
메뉴에서 작업자 풀을 선택한 다음 작업자 풀 목록에서 삭제할 작업자 풀을 선택합니다.
삭제를 클릭합니다.
gcloud
작업자 풀을 삭제하려면 다음 명령어를 사용합니다.
gcloud beta run worker-pools delete WORKER_POOL --region REGION
다음과 같이 바꿉니다.
- WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
- REGION을 작업자 풀의 Google Cloud 리전으로 바꿉니다.