컨테이너 구성

이 페이지에서는 Cloud Run 서비스의 컨테이너 포트, 진입점 명령어, 인수를 구성하는 방법과 Cloud Run 작업의 진입점 명령어 및 인수를 구성하는 방법을 설명합니다.

Cloud Run은 컨테이너를 시작할 때 이미지의 기본 진입점 명령어 및 기본 명령어 인수를 실행합니다. 이미지의 기본 진입점 및 명령어 인수를 재정의하려면 컨테이너 구성에서 commandargs 필드를 사용하면 됩니다. command 필드는 컨테이너에서 실행하는 실제 명령어를 지정합니다. args 필드는 해당 명령어로 전달되는 인수를 지정합니다.

컨테이너 포트 구성(서비스)

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

Cloud Run 서비스의 경우 Cloud Run이 PORT 환경 변수를 컨테이너에 삽입합니다. 컨테이너는 하드코딩된 특정 포트가 아닌 PORT 환경 변수에서 정의된 포트를 리슨해야 합니다. 하지만 이렇게 할 수 없는 경우 컨테이너로 전송되는 포트 요청을 구성할 수 있습니다. 포트 설정은 Cloud Run 작업에 적용되지 않습니다.

콘솔

  1. Cloud Run으로 이동

  2. 배포할 새 서비스를 구성하려면 서비스 만들기를 클릭합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 다음 새 버전 수정 및 배포를 클릭합니다.

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

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

    이미지

    • 기본값이 '8080'이 아닌 경우 요청을 전송할 포트를 지정합니다. 이렇게 하면 'PORT' 환경 변수도 설정됩니다.
  5. 만들기 또는 배포를 클릭합니다.

명령줄

다음 명령어를 사용하여 서비스의 포트 구성을 업데이트할 수 있습니다.

gcloud run services update SERVICE --port PORT

다음과 같이 바꿉니다.

  • SERVICE: 서비스 이름
  • PORT: 요청을 전송할 포트. 기본 포트는 8080입니다.

배포 중에 다음 명령어를 사용하여 포트를 구성할 수도 있습니다.

gcloud run deploy --image IMAGE_URL --port PORT

IMAGE_URL을 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest)로 바꿉니다. Artifact Registry를 사용하는 경우 URL은 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 형식입니다. .

YAML

YAML 형식으로 정리된 결과를 생성하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드해서 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud run services replace 명령어를 사용하여 수정된 YAML을 업로드할 수 있습니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    gcloud run services describe SERVICE --format export > service.yaml
  2. containerPort: 속성을 업데이트합니다.

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
    spec:
      template:
        metadata:
          name: REVISION
        spec:
          containers:
          - image: IMAGE_URL
            ports:
            - containerPort: PORT
    

    다음과 같이 바꿉니다.

    • SERVICE를 Cloud Run 서비스 이름으로 바꿉니다.
    • IMAGE_URL을 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest)로 바꿉니다. Artifact Registry를 사용하는 경우 URL은 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 형식입니다.
    • PORT: 요청을 전송할 포트
    • REVISION: 새 버전 이름으로 변경하거나 이미 있는 경우 삭제 가능. 새 버전 이름을 제공할 경우 다음 기준을 반드시 충족해야 합니다.
      • SERVICE-로 시작해야 합니다.
      • 소문자, 숫자, -만 포함합니다.
      • -로 끝나면 안 됩니다.
      • 63자(영문 기준) 이하여야 합니다.
  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

컨테이너 진입점 명령어 및 인수 구성

Cloud Run 작업 및 서비스에 대해 진입점 명령어 및 인수를 구성할 수 있습니다.

Cloud Run 서비스

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

지정된 컨테이너 명령어 및 인수는 기본 이미지 ENTRYPOINTCMD를 재정의합니다.

새 서비스를 만들거나 새 버전을 배포할 때 Google Cloud 콘솔, gcloud 명령줄 또는 .yaml 파일을 사용하여 진입점 명령어 및 인수를 설정할 수 있습니다.

콘솔

  1. Cloud Run으로 이동

  2. 배포할 새 서비스를 구성하려면 서비스 만들기를 클릭합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 다음 새 버전 수정 및 배포를 클릭합니다.

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

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

    이미지

    • 컨테이너에 정의된 명령어가 아닌 경우 컨테이너를 실행할 명령어를 지정하고, 원할 경우 진입점 명령어에 대한 인수를 지정합니다.
  5. 만들기 또는 배포를 클릭합니다.

명령줄

기존 서비스의 시작 명령어 및 인수를 업데이트하려면 다음 안내를 따르세요.

gcloud run services update SERVICE --command COMMAND --args ARG1,ARG-N

다음과 같이 바꿉니다.

  • COMMAND: 기본 명령어를 사용하지 않는 경우 컨테이너가 시작되는 명령어
  • ARG1: 컨테이너 명령어로 전송 중인 인수. 두 개 이상의 인수에는 쉼표로 구분된 목록을 사용합니다.

새 서비스 또는 기존 서비스를 배포하는 동안 진입점 및 인수를 지정하려면 다음 명령어를 실행합니다.

gcloud run deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

IMAGE_URL을 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest)로 바꿉니다. Artifact Registry를 사용하는 경우 URL은 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 형식입니다.

설정한 진입점 명령어 및 인수를 삭제하려면(컨테이너 기본값으로 복원) 다음과 같이 빈 문자열을 제공합니다.

gcloud run deploy --image IMAGE_URL --command "" --args ""

YAML

YAML 형식으로 정리된 결과를 생성하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드해서 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud run services replace 명령어를 사용하여 수정된 YAML을 업로드할 수 있습니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    gcloud run services describe SERVICE --format export > service.yaml
  2. command 속성과 args 속성을 업데이트합니다.

    spec:
      containers:
      - image: IMAGE_URL
        command:
        - COMMAND
        args:
        - "ARG1"
        - "ARG-N"
    

    바꾸기

    • IMAGE_URL을 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/hello:latest)로 바꿉니다. Artifact Registry를 사용하는 경우 URL은 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 형식입니다.
    • COMMAND: 기본 명령어를 사용하지 않는 경우 컨테이너가 시작되는 명령어
    • ARG1: 컨테이너 명령어로 전송 중인 인수. 여러 인수를 사용하는 경우 각 행에 각각 지정합니다(예: ARG-N).
  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

Terraform

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

다음 코드를 Terraform 구성의 google_cloud_run_service 리소스에 추가합니다. /server를 컨테이너를 시작하는 데 사용되는 명령어로 바꾸고 필요한 인수를 args 배열에 추가합니다.

template {
  spec {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      # Container "entry-point" command
      # https://cloud.google.com/run/docs/configuring/containers#configure-entrypoint
      command = ["/server"]

      # Container "entry-point" args
      # https://cloud.google.com/run/docs/configuring/containers#configure-entrypoint
      args = []
    }
  }

Cloud Run 작업

작업에 대한 명령어 진입점 및 인수를 구성하려면 다음 안내를 따르세요.

콘솔

  1. Cloud Run으로 이동

  2. 새 작업을 구성하는 경우 작업 탭을 클릭하고 원하는 대로 초기 작업 설정 페이지를 작성합니다. 기존 작업을 구성하는 경우 작업을 클릭한 후 수정을 클릭합니다.

  3. 컨테이너, 변수 및 보안 비밀, 연결, 보안을 클릭하여 작업 속성 페이지를 펼칩니다.

  4. 일반 탭을 클릭합니다.

    이미지

    • 컨테이너에 정의된 명령어가 아닌 경우 컨테이너를 실행할 명령어를 지정하고, 원할 경우 진입점 명령어에 대한 인수를 지정합니다.
  5. 만들기 또는 업데이트를 클릭합니다.

명령줄

  1. 새 작업에 대해 시작 명령어 및 인수를 설정하려면 다음 안내를 따르세요.

    gcloud run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

    다음과 같이 바꿉니다.

    • JOB_NAME: 작업 이름
    • COMMAND: 기본 명령어를 사용하지 않는 경우 컨테이너가 시작되는 명령어
    • ARG1: 컨테이너 명령어로 전송 중인 인수. 두 개 이상의 인수에는 쉼표로 구분된 목록을 사용합니다.
    • IMAGE_URL: 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/job:latest)

기존 작업의 명령어 및 인수를 업데이트하려면 다음 안내를 따르세요.

gcloud run jobs update JOB_NAME --command COMMAND --args ARG1,ARG-N 

YAML

YAML 형식으로 정리된 결과를 반환하는 gcloud run jobs describe --format export 명령어를 사용하면 기존 작업 구성을 다운로드하고 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud run jobs replace 명령어를 사용하여 수정된 YAML을 업로드합니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. args: 속성과 command 속성을 업데이트합니다.

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB_NAME
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - args:
                - 'ARG1'
                - 'ARG-N'
                command:
                - COMMAND
                image: IMAGE

    다음과 같이 바꿉니다.

    • COMMAND: 기본 명령어를 사용하지 않는 경우 컨테이너가 시작되는 명령어
    • ARG1: 컨테이너 명령어로 전송 중인 인수. 선택적으로 별도의 인수를 각각 별도의 줄에 지정합니다.

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

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

    gcloud run jobs replace job.yaml

설정한 진입점 명령어 및 인수를 삭제하려면(컨테이너 기본값으로 복원) 다음과 같이 빈 문자열을 제공합니다.

gcloud run jobs update JOB_NAME --command "" --args "" 

인수에 등호 또는 쉼표 사용

인수에 등호를 사용하는 경우 다음 형식을 사용합니다.

gcloud run deploy  \
  --args="--repo-allowlist=github.com/example/example_demo"

인수에 쉼표를 사용하는 경우 쉼표 이스케이프 처리에 대한 자세한 내용은 환경 변수 구성을 참조하세요.

사이드카 배포를 위한 컨테이너 시작 순서 구성(서비스)

사이드카 배포에서 컨테이너 시작 순서를 지정하려면 컨테이너 종속 항목 기능을 사용합니다. 종속 항목이 있는 컨테이너를 지정하고 종속된 컨테이너를 나열합니다. 해당 컨테이너는 먼저 시작됩니다. 종속 항목이 없는 컨테이너는 항상 먼저, 그리고 동시에 시작됩니다.

상태 확인 프로브를 사용하면 Cloud Run은 종속 컨테이너의 상태를 검사하고 다음 컨테이너를 시작하기 전에 성공적으로 통과했는지 확인합니다. 상태 확인을 사용하지 않으면 종속된 컨테이너 시작에 실패하더라도 컨테이너가 지정된 순서로 시작됩니다.

미리보기 중에는 YAML 메서드를 사용하여 컨테이너 시작 순서를 구성해야 합니다. 시작 순서를 지정하려면 다음 안내를 따르세요.

YAML

YAML 형식으로 정리된 결과를 생성하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드해서 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud run services replace 명령어를 사용하여 수정된 YAML을 업로드할 수 있습니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    gcloud run services describe SERVICE --format export > service.yaml
  2. container-dependencies 속성을 업데이트합니다.

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      annotations:
        run.googleapis.com/launch-stage: BETA
      name: SERVICE
    spec:
      template:
        metadata:
          annotations:
            run.googleapis.com/container-dependencies: '{"CONTAINER1":["CONTAINER2"], "CONTAINER3":["CONTAINER1","CONTAINER2"]}'
    

    바꾸기

    • CONTAINER1을 하나 이상의 컨테이너에 종속된 첫 번째 컨테이너의 이름으로 바꿉니다. YAML에서 컨테이너 이름을 설정할 수 있습니다. 컨테이너 이름을 지정하지 않으면 Cloud Run이 자동으로 이름을 생성합니다.
    • CONTAINER2CONTAINER1 전에 시작해야 하는 컨테이너 이름으로 바꿉니다.
    • CONTAINER3을 하나 이상의 컨테이너에 종속된 두 번째 컨테이너 이름으로 바꿉니다.

    YAML 스니펫에 표시된 예시에서 CONTAINER2가 먼저 시작되고 CONTAINER1가 두 번째로 시작되며, CONTAINER3이 마지막으로 시작됩니다.

  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

컨테이너 설정 보기

Cloud Run 서비스의 현재 컨테이너 설정을 보려면 다음 안내를 따르세요.

콘솔

  1. Cloud Run으로 이동

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

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

  4. 오른쪽의 세부정보 패널에서 컨테이너 설정이 일반 탭에 표시됩니다.

명령줄

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

    gcloud run services describe SERVICE
  2. 반환된 구성에서 컨테이너 설정을 찾습니다.

Cloud Run 작업의 현재 컨테이너 설정을 보려면 다음 안내를 따르세요.

콘솔

  1. Cloud Run 작업으로 이동

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

  3. 구성 탭을 클릭합니다.

  4. 구성 세부정보에서 컨테이너 설정을 찾습니다.

명령줄

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

    gcloud run jobs describe JOB_NAME
  2. 반환된 구성에서 컨테이너 설정을 찾습니다.