작업자 풀 버전 관리

작업자 풀에 배포하거나 작업자 풀의 구성을 변경하면 Cloud Run에서 변경할 수 없는 버전을 만듭니다.

버전을 관리할 때는 다음 사항을 고려해야 합니다.

  • 원할 경우 가능하지만 버전을 수동으로 삭제할 필요는 없습니다.
  • 비활성 버전은 어떠한 리소스도 사용하지 않으며 비용도 청구되지 않습니다.
  • 작업자 풀별 버전 수는 최대 1,000개입니다. 이 한도를 초과하면 이전 버전이 자동으로 삭제됩니다.
  • 버전 서픽스는 자동으로 할당됩니다. 자체 버전 서픽스를 사용하려면 gcloud CLI 파라미터 --revision-suffix를 사용하면 됩니다.

필요한 역할

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 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

작업자 풀 버전 목록 보기

gcloud

지정된 작업자 풀의 버전 목록을 보려면 다음 안내를 따르세요.

  1. 프로젝트에서 사용 가능한 작업자 풀 목록에서 작업자 풀 이름을 찾습니다.

    gcloud beta run worker-pools list

  2. 다음 명령어를 사용하여 해당 작업자 풀의 모든 버전을 가져옵니다.

    gcloud beta run worker-pools revisions list
   --worker-pool=WORKER_POOL
   --region=REGION

    다음과 같이 바꿉니다.

    • WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
    • REGION을 작업자 풀의 Google Cloud 리전으로 바꿉니다.

버전 세부정보 보기

gcloud

프로젝트에서 한 버전의 세부정보를 보려면 다음 안내를 따르세요.

  1. 프로젝트에서 사용 가능한 작업자 풀 목록에서 작업자 풀 이름을 찾습니다.

    gcloud beta run worker-pools list

  2. 다음 명령어를 사용하여 방금 찾은 작업자 풀의 모든 버전을 가져옵니다. 

    gcloud beta run worker-pools revisions list
    --worker-pool=WORKER_POOL
    --region=REGION

    다음과 같이 바꿉니다.

    • WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
    • REGION을 작업자 풀의 Google Cloud 리전으로 바꿉니다.

  3. 다음 명령어를 사용하여 특정 버전에 대한 세부정보를 확인합니다.

    gcloud beta run worker-pools revisions describe REVISION --region=REGION --worker-pool=WORKER_POOL

    다음과 같이 바꿉니다.

    • REVISION을 자세히 알아보려는 버전 이름으로 바꿉니다.
    • REGION을 작업자 풀의 Google Cloud 리전으로 바꿉니다.
    • WORKER_POOL을 작업자 풀 이름으로 바꿉니다.

    --format 플래그를 사용하여 출력 형식을 지정할 수 있습니다. 예를 들어 출력 형식을 YAML로 지정하려면 다음을 실행합니다. 

    gcloud beta run worker-pools revisions describe REVISION
    --region=REGION
    --worker-pool=WORKER_POOL
    --format yaml

현재 버전이 아닌 경우 버전 상태가 RETIRED일 수 있습니다. 즉, Cloud Run에서 해당 버전에 필요한 인프라가 사용 중지되었을 수 있습니다.

버전 삭제

일반적으로 특정 버전이 실수로 사용되지 않도록 하기 위해 버전을 삭제합니다.

다음과 같은 경우에는 버전을 삭제할 수 없습니다.

  • 작업자 풀의 유일한 버전
  • 작업자 풀의 최신 버전

버전을 삭제할 때 이 버전에 사용되는 컨테이너 이미지는 Artifact Registry에서 자동으로 삭제되지 않습니다. Artifact Registry에서 컨테이너 이미지를 삭제하려면 Artifact Registry의 삭제 안내를 참조하세요.

버전 삭제는 실행취소할 수 없습니다.

Google Cloud CLI를 사용하여 버전을 삭제합니다.

gcloud

버전을 삭제하려면 다음 명령어를 사용하세요.

gcloud beta run worker-pools revisions delete REVISION 
    --region=REGION
    --worker-pool=WORKER_POOL

다음과 같이 바꿉니다.

  • REVISION을 삭제할 버전의 이름으로 바꿉니다.
  • WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
  • REGION을 작업자 풀의 Google Cloud 리전으로 바꿉니다.

다음 단계

버전을 배포한 후에는 다음을 수행할 수 있습니다.