동시 로드 설정(작업)

parallelism을 사용하여 작업 실행에서 동시에 실행할 수 있는 최대 태스크 수를 지정합니다. 기본적으로 태스크는 사용 중인 CPU 수에 따라 달라지는 최댓값까지 최대한 빨리 시작됩니다.

동시 로드 한도를 낮추면 동시에 실행되는 태스크 수가 제한됩니다. 이는 데이터베이스와 같은 지원 리소스 중 하나가 확장이 제한되어 많은 수의 병렬 요청을 처리할 수 없는 경우에 유용합니다.

필요한 역할

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

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

동시 로드 구성

Cloud Run 작업에 대한 동시 로드를 지정하려면 다음 안내를 따르세요.

콘솔

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

    Cloud Run으로 이동

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

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

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

    이미지

    • 최고의 성능을 위해 최대한 많은 태스크를 동시에 실행을 선택합니다. 예를 들어 지원 리소스가 제한된 경우와 같이 동시 태스크 수를 줄여야 하는 경우 동시 태스크 수 제한을 선택한 다음 텍스트 상자에 0에서 100 사이의 정수를 지정합니다.
  5. 만들기 또는 업데이트를 클릭합니다.

gcloud

  1. 만들고 있는 작업에 다음 명령어를 실행합니다.

    gcloud run jobs create JOB_NAME --image IMAGE_URL --parallelism PARALLELISM

    바꾸기

    • JOB_NAME을 작업 이름으로 바꿉니다.
    • IMAGE_URL: 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/job:latest)
    • PARALLELISM: 태스크 수를 초과하지 않는 0에서 100 사이의 정수 지정
  2. 업데이트하고 있는 작업에 다음 명령어를 실행합니다.

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

YAML

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

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

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB_NAME
    spec:
      template:
        spec:
          parallelism: PARALLELISM
          template:
            spec:
              containers:
              - image: IMAGE

    PARALLELISM을 바꿉니다. 태스크 수를 초과하지 않는 0에서 100 사이의 정수를 지정합니다.

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

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

    gcloud run jobs replace job.yaml

Terraform

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

Cloud Run 작업에 동시 로드를 지정하려면 google_cloud_run_v2_job 리소스를 사용하고 main.tf 파일에 다음 스니펫을 적용합니다.

resource "google_cloud_run_v2_job" "default" {
  name         = "cloud-run-job-parallelism"
  location     = "us-central1"
  launch_stage = "BETA"

  template {
    task_count  = 3
    parallelism = 3

    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

동시 로드 설정 보기

Cloud Run 작업의 현재 동시 로드 설정을 보려면 다음 안내를 따르세요.

콘솔

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

    Cloud Run 작업으로 이동

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

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

  4. 구성 세부정보에서 동시 로드 설정을 찾습니다.

gcloud

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

    gcloud run jobs describe JOB_NAME
  2. 반환된 구성에서 동시 로드 설정을 찾습니다.