컨테이너 구성

이 페이지에서는 Cloud Run 작업의 진입점 명령어 및 인수를 구성하는 방법을 설명합니다.

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

각 작업에서 컨테이너당 최대 1,000개의 인수를 사용할 수 있습니다.

필요한 역할

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 콘솔에서 Cloud Run 작업 페이지로 이동합니다.

Cloud Run으로 이동
컨테이너 배포를 클릭하고 작업을 선택하여 초기 작업 설정 페이지를 작성합니다. 기존 작업을 구성하는 경우 작업을 선택한 후 수정을 클릭합니다.
컨테이너, 변수 및 보안 비밀, 연결, 보안을 클릭하여 작업 속성 페이지를 펼칩니다.
일반 탭을 클릭합니다.
- 컨테이너에 정의된 명령어가 아닌 경우 컨테이너를 실행할 명령어를 지정하고, 원할 경우 진입점 명령어에 대한 인수를 지정합니다.
만들기 또는 업데이트를 클릭합니다.

gcloud

새 작업에 대해 시작 명령어 및 인수를 설정하려면 다음 안내를 따르세요.
```
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 JOB_NAME --format export > job.yaml
```
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: 컨테이너 명령어로 전송 중인 인수. 필요한 경우 별도의 줄에 추가 인수를 각각 지정합니다.
또한 환경 변수 또는 메모리 제한과 같은 추가 구성을 지정할 수 있습니다.
기존 작업 구성을 업데이트합니다.
```
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 작업의 현재 컨테이너 설정을 보려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 Cloud Run 작업 페이지로 이동합니다.

Cloud Run 작업으로 이동
관심 있는 작업을 클릭하여 작업 세부정보 페이지를 엽니다.
구성 탭을 클릭합니다.
구성 세부정보에서 컨테이너 설정을 찾습니다.

gcloud

다음 명령어를 사용하세요.
```
gcloud run jobs describe JOB_NAME
```
반환된 구성에서 컨테이너 설정을 찾습니다.