이 페이지에서는 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
:europe-west4
와 같이 큐가 실행되는 위치입니다.- 조직에서 리소스 위치를 제한하고
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
여러 위치를 검색하려면 여러 요청을 수행해야 합니다.
큐 한도에 도달했는지 확인합니다.
할당량을 선택합니다.
리소스 한도를 늘리려면 Google Cloud 콘솔의 할당량 페이지에서 할당량 수정을 선택합니다.
명령어의 각 부분을 확인하고 다시 실행합니다.
다음 단계
- Cloud Tasks 큐 구성에 대해 알아보기
- RPC API 참조에서 대기열 관리에 대해 자세히 알아보기
- REST API 참조에서 큐 관리에 대해 자세히 알아보기
- Cloud Tasks
gcloud
명령의 전체 목록 참조하기