실행 환경 선택(서비스)

이 페이지에서는 Cloud Run 인스턴스의 실행 환경을 지정하는 방법을 설명합니다. Cloud Run 서비스는 기본적으로 실행 환경을 지정하지 않으므로, Cloud Run이 사용되는 기능에 따라 실행 환경을 선택합니다. 서비스의 실행 환경을 지정하지 않으면 Cloud Run이 1세대 또는 2세대 환경을 선택할 수 있습니다.

Cloud Run 작업은 2세대 실행 환경만 사용하며 작업에 대해 이를 변경할 수 없습니다.

서비스에 가장 적합한 환경을 선택하는 데 도움이 필요하면 실행 환경 개념 문서를 참조하세요.

필요한 역할

Cloud Run 서비스를 구성하고 배포하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

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

실행 환경 설정 및 업데이트

구성을 변경하면 새 버전이 생성됩니다. 이를 변경하는 명시적 업데이트가 없으면 이후 버전에도 이 구성 설정이 자동으로 적용됩니다.

Cloud Run 서비스의 기본값은 지정되지 않습니다. 즉, Cloud Run이 적합한 실행 환경을 선택합니다. 또는 실행 환경을 지정할 수 있습니다. 2세대를 사용하려면 최소 512MiB 메모리를 지정해야 합니다.

새 서비스를 만들거나 새 버전을 배포할 때 Google Cloud 콘솔, gcloud 명령줄 또는 YAML 파일을 사용하여 실행 환경을 설정할 수 있습니다.

콘솔

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

    Cloud Run으로 이동

  2. 컨테이너 배포를 클릭하고 서비스를 선택하여 새 서비스를 구성합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 후 새 버전 수정 및 배포를 클릭합니다.

  3. 새 서비스를 구성하는 경우 초기 서비스 설정 페이지를 작성한 후 컨테이너, 볼륨, 네트워킹, 보안을 클릭하여 서비스 구성 페이지를 펼칩니다.

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

    이미지

    • 옵션 버튼을 사용하여 원하는 실행 환경을 선택합니다. Cloud Run이 적합한 실행 환경을 선택할 수 있도록 "기본값"을 유지합니다.

  5. 만들기 또는 배포를 클릭합니다.

gcloud

다음 명령어를 사용하여 지정된 서비스의 실행 환경을 업데이트할 수 있습니다.

gcloud run services update SERVICE --execution-environment ENVIRONMENT

SERVICE를 서비스 이름으로, ENVIRONMENT를 원하는 실행 환경으로 바꿉니다. 1세대의 경우 gen1 값을, 2세대의 경우 gen2 값을 지정합니다.

배포 중에 다음 명령어를 사용하여 실행 환경을 설정할 수도 있습니다.

gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT

다음과 같이 바꿉니다.

  • IMAGE_URL: 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest). Artifact Registry를 사용하는 경우 저장소 REPO_NAME이 이미 생성되어 있어야 합니다. URL의 형식은 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG입니다.
  • ENVIRONMENT: 원하는 실행 환경. 1세대의 경우 gen1 값을, 2세대의 경우 gen2 값을 지정합니다.

YAML

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

    gcloud run services describe SERVICE --format export > service.yaml

  2. run.googleapis.com/execution-environment 주석을 설정합니다.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/execution-environment: ENVIRONMENT

    다음과 같이 바꿉니다.

    • SERVICE: Cloud Run 서비스 이름
    • ENVIRONMENT: 선택한 실행 환경. 1세대의 경우 gen1 값을, 2세대의 경우 gen2 값을 지정합니다.

    기본 동작에 대한 run.googleapis.com/execution-environment 주석을 삭제합니다.

  3. 다음 명령어를 사용하여 서비스를 만들거나 업데이트합니다.

    gcloud run services replace service.yaml

실행 환경 설정 보기

Cloud Run 서비스의 현재 실행 환경 설정을 보려면 다음 안내를 따르세요.

콘솔

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

    Cloud Run으로 이동

  2. 관심이 있는 서비스를 클릭하여 서비스 세부정보 페이지를 엽니다.

  3. 버전 탭을 클릭합니다.

  4. 오른쪽의 세부정보 패널의 컨테이너 탭에 실행 환경 설정이 나열됩니다.

gcloud

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

    gcloud run services describe SERVICE

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