Cloud Tasks를 사용하면 비동기 워크로드 실행을 제어하고, 큐 처리를 일시중지하고, 활성 태스크 흐름 문제를 해결할 수 있습니다. Google Cloud 콘솔, Google Cloud CLI 또는 Cloud Tasks API를 사용하여 큐와 태스크를 구성하고 유지보수할 수 있습니다.
시작하기 전에
- 기존 Cloud Tasks 태스크 큐가 있는지 확인합니다. 자세한 내용은 Cloud Tasks 큐 만들기를 참조하세요.
- 큐와 태스크를 관리하는 데 필요한 Identity and Access Management(IAM) 역할(예: Cloud Tasks 관리자(
roles/cloudtasks.admin), Cloud Tasks 큐 관리자(roles/cloudtasks.queueAdmin), Cloud Tasks 태스크 삭제자(roles/cloudtasks.taskDeleter))가 있는지 확인합니다.
큐에서 태스크 삭제
예약되거나 전달된 작업은 삭제할 수 있습니다. 예를 들어 몇 번을 재시도해도 성공적으로 완료할 수 없는 태스크를 삭제해야 할 수 있습니다. 태스크가 성공적으로 완료되었거나 계속 실패한 후 재시도 횟수가 소진된 경우에는 태스크를 삭제할 수 없습니다. 최대 태스크 보관 한도에 도달하면 태스크가 자동으로 삭제됩니다.
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 큐 페이지로 이동합니다.
삭제할 태스크의 큐 이름을 클릭합니다.
삭제할 태스크의 체크박스를 선택합니다.
할 일 삭제를 클릭합니다.
메시지가 표시되면 삭제를 클릭합니다.
gcloud
gcloud tasks delete 명령어를 사용하여 태스크를 삭제합니다.
gcloud tasks delete TASK_NAME \ --queue=QUEUE_ID \ --location=LOCATION
다음을 바꿉니다.
TASK_NAME: 삭제할 태스크의 ID 또는 전체 리소스 이름QUEUE_ID: 태스크가 속한 큐의 이름LOCATION: 큐가 배포되는 리전입니다(예:us-central1).
REST
태스크를 삭제하려면 projects.locations.queues.tasks.delete 메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
QUEUE_ID: 태스크가 속한 큐의 이름TASK_NAME: 삭제할 태스크의 이름PROJECT_ID: Google Cloud프로젝트 IDLOCATION: 큐가 있는 리전입니다(예:us-central1).
요청 본문은 비어 있어야 합니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공한 경우 응답 본문은 비어 있습니다.
큐에서 태스크 일괄 삭제
projects.locations.queues.tasks.batchDelete 메서드를 사용하여 태스크 이름 목록을 삭제하면 큐에서 태스크 배치를 삭제할 수 있습니다.
다음에 유의하세요.
모든 태스크는 동일한 큐에서 삭제되어야 합니다.
단일 배치에서 삭제할 수 있는 태스크 수에는 한도가 있습니다. 자세한 내용은 할당량 및 한도를 참조하세요.
개별 작업을 단일 요청으로 합산하는 일괄 요청은 배치에 포함된 작업 중 일부는 실패하고 다른 작업은 성공할 수 있기 때문에 원자적이지 않습니다.
예약되거나 디스패치된 작업만 삭제할 수 있습니다. 태스크가 성공적으로 완료되었거나 계속 실패한 후 재시도 횟수가 소진된 경우에는 태스크를 삭제할 수 없습니다. 최대 태스크 보관 한도에 도달하면 태스크가 자동으로 삭제됩니다.
태스크 배치를 만들 수도 있습니다. 자세한 내용은 태스크 배치 만들기를 참조하세요.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
TASK_NAME: 삭제할 태스크의 이름이며 형식은projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID입니다.PROJECT_ID: Google Cloud프로젝트 IDREGION: 큐가 있는 리전입니다(예:us-central1).QUEUE_ID: 태스크가 속한 큐의 이름
요청 본문에는 태스크 이름 목록이 포함됩니다.
JSON 요청 본문:
{
"names": [
"TASK_NAME"
]
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공하면 응답 본문에 Operation 인스턴스가 포함됩니다.
{
"name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.tasks.v2.BatchDeleteTasksMetadata"
},
"done": false
}
큐에서 모든 태스크 삭제
큐에서 모든 태스크를 삭제할 수 있습니다. 삭제 호출 전에 생성된 모든 태스크가 영구적으로 삭제됩니다. 하지만 삭제 태스크는 최대 1분이 걸릴 수 있으며 삭제가 적용되기 전에 태스크가 전달될 수 있습니다.
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 큐 페이지로 이동합니다.
삭제하려는 태스크의 큐 이름을 클릭합니다.
큐 삭제를 클릭합니다.
메시지가 표시되면 삭제를 클릭합니다.
gcloud
gcloud tasks queues purge 명령어를 사용하여 큐를 삭제합니다.
gcloud tasks queues purge QUEUE_ID \ --location=LOCATION
다음을 바꿉니다.
QUEUE_ID: 삭제하려는 큐의 이름LOCATION: 큐가 배포되는 리전입니다(예:us-central1).
REST
큐를 삭제하려면 projects.locations.queues.purge 메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
QUEUE_ID: 삭제하려는 큐의 이름PROJECT_ID: Google Cloud프로젝트 IDLOCATION: 큐가 배포되는 리전입니다(예:us-central1).
요청 본문은 비어 있어야 합니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공하면 응답 본문에 Queue 인스턴스가 포함됩니다.
{
"name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
"rateLimits": {
"maxDispatchesPerSecond": 500,
"maxBurstSize": 100,
"maxConcurrentDispatches": 1000
},
"retryConfig": {
"maxAttempts": 100,
"minBackoff": "0.100s",
"maxBackoff": "3600s",
"maxDoublings": 16
},
"state": "RUNNING",
"purgeTime": "2025-03-28T13:06:30.110255Z"
}
큐 일시중지 또는 재개
큐를 일시중지하거나 재개할 수 있습니다. 큐를 일시중지하면 태스크 실행 및 전송이 중지됩니다. 태스크를 만들고 큐에 푸시하거나 추가할 수 있지만 큐가 재개될 때까지 태스크가 처리되지 않습니다. 큐를 재개하면 Cloud Tasks는 정의된 실행 순서 없이 백로그된 태스크를 디스패치하기 시작합니다. 백로그가 큰 트래픽이 많은 큐를 재개하는 경우 대상 오버로드를 방지하기 위해 램프업 안내를 따르세요.
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 큐 페이지로 이동합니다.
일시중지하거나 재개하려는 큐의 체크박스를 선택합니다.
큐를 일시중지하려면 큐 일시중지를 클릭한 다음 프롬프트에서 일시중지를 클릭합니다.
일시중지된 큐를 재개하려면 큐 재개를 클릭합니다.
gcloud
gcloud tasks queues pause명령어를 사용하여 큐를 일시중지합니다.gcloud tasks queues pause QUEUE_ID \ --location=LOCATION
다음을 바꿉니다.
QUEUE_ID: 일시중지할 큐의 이름LOCATION: 큐가 배포되는 리전입니다(예:us-central1).
gcloud tasks queues resume명령어를 사용하여 큐를 재개합니다.gcloud tasks queues resume QUEUE_ID \ --location=LOCATION
REST
큐를 일시중지하려면
projects.locations.queues.pause메서드를 사용합니다.요청 데이터를 사용하기 전에 다음을 바꿉니다.
QUEUE_ID: 일시중지할 큐의 이름PROJECT_ID: Google Cloud프로젝트 IDLOCATION: 큐가 배포되는 리전입니다(예:us-central1).
요청 본문은 비어 있어야 합니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공하면 응답 본문에
Queue인스턴스가 포함됩니다.{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "PAUSED" }큐를 재개하려면
projects.locations.queues.resume메서드를 사용합니다.요청 데이터를 사용하기 전에 다음을 바꿉니다.
QUEUE_ID: 재개하려는 큐의 이름PROJECT_ID: Google Cloud프로젝트 IDLOCATION: 큐가 배포되는 리전입니다(예:us-central1).
요청 본문은 비어 있어야 합니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공하면 응답 본문에
Queue인스턴스가 포함됩니다.{ "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID", "rateLimits": { "maxDispatchesPerSecond": 500, "maxBurstSize": 100, "maxConcurrentDispatches": 1000 }, "retryConfig": { "maxAttempts": 100, "minBackoff": "0.100s", "maxBackoff": "3600s", "maxDoublings": 16 }, "state": "RUNNING" }
큐 나열
큐를 나열할 수 있습니다. 큐를 나열할 때 일부 비율 제한 및 재시도 매개변수 세부정보가 반환됩니다. 다음 필드는 동일합니다.
- 최대 비율(콘솔),
MAX_RATE(gcloud),maxDispatchesPerSecond(REST) 최대 동시 실행(콘솔),
MAX_NUM_OF_TASKS(gcloud),maxConcurrentDispatches(REST)
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 큐 페이지로 이동합니다.
Google Cloud 프로젝트의 모든 큐가 나열됩니다.
자세한 내용을 보려면 큐 이름을 클릭한 후 구성 탭을 클릭합니다.
비율 제한 및 재시도 매개변수 세부정보가 표시됩니다.
gcloud
gcloud tasks queues list 명령어를 사용하여 큐를 나열합니다.
gcloud tasks queues list \ --location=LOCATION
LOCATION을 큐가 배포
된
리전으로 바꿉니다(예: us-central1). 위치를 지정하지 않으면 Google Cloud 프로젝트의 App Engine 앱 위치가 사용됩니다(있는 경우). 그렇지 않으면 위치를 지정해야 합니다.
출력은 다음과 비슷하게 표시됩니다.
QUEUE_NAME: my-queue STATE: PAUSED MAX_NUM_OF_TASKS: 1000 MAX_RATE (/sec): 500.0 MAX_ATTEMPTS: 100 ...
REST
큐를 나열하려면 projects.locations.queues.list 메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID: Google Cloud프로젝트 IDLOCATION: 큐가 생성되는 리전(예:us-central1)
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공하면 응답 본문에 Queue 리소스 인스턴스가 포함되고 응답은 다음과 유사해야 합니다.
{
"queues": [
{
"name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
"rateLimits": {
"maxDispatchesPerSecond": 500,
"maxBurstSize": 100,
"maxConcurrentDispatches": 1000
},
"retryConfig": {
"maxAttempts": 100,
"minBackoff": "0.100s",
"maxBackoff": "3600s",
"maxDoublings": 16
},
"state": "PAUSED",
"purgeTime": "2025-03-28T13:37:32.292552Z"
},
...
],
"nextPageToken": "CjQKCHppcHBlcjIAEgwI9-GExAYQ_oDc1AMaGioLeWlrZXMtYWdhaW4yC3VzLWNlbnRyYWwx"
}
큐 삭제
App Engine default 큐를 제외하고 더 이상 필요하지 않은 큐는 삭제할 수 있습니다.
큐를 삭제한 후 이름이 같은 큐를 다시 만들려면 3일을 기다려야 합니다. 이 대기 기간은 Google Cloud 콘솔, gcloud CLI, REST 또는 RPC API, Terraform을 비롯한 모든 인터페이스를 통해 삭제된 큐에 적용됩니다. 이렇게 하면 삭제 시 실행 중인 태스크에서 예기치 않은 동작이 방지되고 삭제 및 재생성 주기 동안 내부 프로세스 오류가 방지됩니다.
최대 3일의 이 삭제보관 기간 동안 큐 생성 요청은 큐를 다시 만들지 않고 성공한 것으로 표시될 수 있습니다. 동일한 이름의 큐가 다시 생성되었는지 확인하려면 gcloud tasks queues describe 명령어 또는 projects.locations.queues.get 메서드를 사용하여 큐를 검색합니다. 성공(200 OK) 응답은 큐가 다시 생성되었음을 확인합니다.
큐를 삭제하거나 3일의 대기 기간을 트리거하지 않고 CI/CD 파이프라인에서 태스크를 지우거나, 큐 구성을 수정하거나, 큐를 관리하려면 큐를 삭제하고 다시 만드는 대신 다음 대안을 사용하세요.
큐 삭제:
gcloud tasks queues purge명령어 또는projects.locations.queues.purge메서드를 사용하여 큐에서 모든 태스크를 삭제하여 큐를 활성 상태로 유지하면서 큐의 모든 태스크를 삭제합니다.큐를 제자리에서 업데이트:
gcloud tasks queues update명령어 또는projects.locations.queues.patch메서드를 사용하여 기존 큐의 비율 제한, 재시도 매개변수 또는 라우팅을 수정합니다. 자세한 내용은 큐 라우팅, 한도, 재시도 구성을 참조하세요.큐 일시중지:
gcloud tasks queues pause명령어 또는projects.locations.queues.pause메서드를 사용하여 큐를 일시중지하여 큐에 추가된 태스크를 보존하면서 태스크 디스패치를 일시적으로 중지합니다.수명 주기 보호 장치 구성: Terraform
lifecycle블록에서prevent_destroy = true를 설정하는 등 코드형 인프라 템플릿에서 삭제 방지를 구성하여 자동 배포 중에 실수로 큐가 삭제되지 않도록 합니다.
큐를 삭제하려면 Google Cloud 콘솔, gcloud CLI 또는 Cloud Tasks API를 사용합니다.
콘솔
Google Cloud 콘솔에서 Cloud Tasks > 큐 페이지로 이동합니다.
삭제할 큐의 체크박스를 선택합니다.
큐 삭제를 클릭합니다.
메시지가 표시되면 큐 이름을 입력한 다음 확인을 클릭합니다.
gcloud
gcloud tasks queues delete 명령어를 사용하여 큐를 삭제합니다.
gcloud tasks queues delete QUEUE_ID \ --location=LOCATION
다음을 바꿉니다.
QUEUE_ID: 삭제할 큐의 ID 또는 정규화된 식별자LOCATION: 큐가 배포되는 리전입니다(예:us-central1).
gcloud CLI는 --quiet 플래그를 전달하지 않는 한 큐를 삭제하기 전에 확인을 요청하는 메시지를 표시합니다.
REST
큐를 삭제하려면 projects.locations.queues.delete 메서드를 사용합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
QUEUE_ID: 삭제하려는 큐의 이름PROJECT_ID: Google Cloud프로젝트 IDLOCATION: 큐가 배포되는 리전입니다(예:us-central1).
요청 본문은 비어 있어야 합니다.
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공한 경우 응답 본문은 비어 있습니다.