Cloud Tasks 큐 만들기

이 페이지에서는 gcloud CLI의 gcloud 명령어를 사용하여 Cloud Tasks 큐를 만드는 방법을 설명합니다.

시작하기 전에

큐 이름은 프로젝트 ID, 위치, 큐 ID의 세 부분으로 구성됩니다. 모든 대상 유형에는 프로젝트 ID를 제공하는 Google Cloud 프로젝트가 있어야 합니다.

App Engine 대상 태스크를 사용하는 경우 App Engine 앱도 있어야 합니다. 이 앱은 특정 리전에 위치해 있으며, 이 리전은 큐 이름의 위치 부분 역할을 하므로 앱을 추가할 때 기록해 둡니다. 이 위치는 큐와 핸들러가 실행되는 위치입니다.

반면에 HTTP 대상 큐를 사용할 때는 App Engine 앱이 필요하지 않습니다. 큐를 만들 수 있을 때 Google Cloud 위치를 선택합니다.

Cloud Tasks 큐 만들기

Google Cloud SDK를 사용하여 큐를 만듭니다.

    gcloud tasks queues create QUEUE_ID --location=LOCATION

다음을 바꿉니다.

  • LOCATION: asia-south1와 같이 큐가 실행되는 위치입니다.

    • 조직에서 리소스 위치를 제한하고 us-central1 또는 us-central2에서 큐를 만들려면 조직 정책이 us-central1 및 us-central2 모두에서 큐 생성을 허용해야 합니다(리전 중 하나에만 큐가 필요한 경우에도 해당).

  • QUEUE_ID: 큐에 할당한 식별자입니다(예: my-queue).

새로 만든 큐를 사용할 수 있으려면 몇 분 정도 걸릴 수 있습니다. 그런 다음 describe를 사용하여 대기열이 성공적으로 만들어졌는지 확인합니다.

   gcloud tasks queues describe QUEUE_ID --location=LOCATION

다음을 바꿉니다.

  • QUEUE_ID: 큐 ID(닉네임)
  • LOCATION: 큐의 위치

출력은 다음과 같이 표시됩니다.

name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID
rateLimits:
  maxBurstSize: 100
  maxConcurrentDispatches: 1000
  maxDispatchesPerSecond: 500.0
retryConfig:
  maxAttempts: 100
  maxBackoff: 3600s
  maxDoublings: 16
  minBackoff: 0.100s
state: RUNNING

위의 출력이 표시되지 않으면 다음을 시도해 보세요.

  • 대기열이 초기화될 때까지 1분 이상 기다립니다.

  • 동일한 ID의 대기열이 기존에 이미 존재하지 않는지 확인합니다. 다음을 호출하여 프로젝트에 포함된 대기열을 볼 수 있습니다.

    gcloud tasks queues list --location=LOCATION

    여러 위치를 검색하려면 여러 요청을 수행해야 합니다.

  • 큐 한도에 도달했는지 확인합니다.

    Cloud Tasks API 페이지로 이동

    할당량을 선택합니다.

    리소스 한도를 늘리려면 Google Cloud 콘솔의 할당량 페이지에서 할당량 수정을 선택합니다.

  • 명령어의 각 부분을 확인하고 다시 실행합니다.

다음 단계