큐 및 태스크 관리

다음과 같은 방법으로 큐와 작업을 관리할 수 있습니다.

  • Google Cloud 콘솔에서 다음을 수행합니다.
  • 터미널 또는 Cloud Shell에서 Google Cloud CLI 사용
  • Cloud Tasks API에 요청을 전송하는 방법

큐에서 태스크 삭제

할 일이 예약되었거나 디스패치된 경우 삭제할 수 있습니다. 예를 들어 여러 번 재시도해도 완료가 안되는 태스크의 경우 삭제가 필요할 수 있습니다. 작업이 성공적으로 완료되었거나 일관되게 실패한 후 재시도 횟수가 소진된 경우에는 작업을 삭제할 수 없습니다. 최대 작업 보관 기간 한도에 도달하면 작업이 자동으로 삭제됩니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

    대기열로 이동

  2. 삭제할 태스크가 있는 큐의 이름을 클릭합니다.

  3. 삭제할 작업의 체크박스를 선택합니다.

  4. 할 일 삭제를 클릭합니다.

  5. 메시지가 표시되면 삭제를 클릭합니다.

gcloud

gcloud tasks delete 명령어를 사용하여 작업을 삭제합니다.

gcloud tasks delete TASK_NAME \
    --queue=QUEUE_ID \
    --location=LOCATION

다음을 바꿉니다.

  • TASK_NAME: 삭제할 작업의 이름
  • QUEUE_ID: 태스크가 속한 큐의 이름
  • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

REST

작업을 삭제하려면 projects.locations.queues.tasks.delete 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • QUEUE_ID: 태스크가 속한 큐의 이름
  • TASK_NAME: 삭제할 작업의 이름
  • PROJECT_ID: Google Cloud프로젝트 ID
  • LOCATION: 큐가 있는 리전입니다(예: us-central1).

요청 본문은 비어 있어야 합니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

성공한 경우 응답 본문은 비어 있습니다.

큐에서 태스크 일괄 삭제

projects.locations.queues.tasks.batchDelete 메서드를 사용하여 태스크 이름 목록을 삭제하면 큐에서 태스크 일괄 처리를 삭제할 수 있습니다.

다음에 유의하세요.

  • 모든 작업은 동일한 대기열에서 삭제해야 합니다.

  • 단일 배치에서 삭제할 수 있는 작업 수에는 제한이 있습니다. 자세한 내용은 할당량 및 한도를 참조하세요.

  • 개별 작업을 단일 요청으로 합산하는 일괄 요청은 배치에 포함된 작업 중 일부는 실패하고 다른 작업은 성공할 수 있기 때문에 원자적이지 않습니다.

  • 할 일은 예약되었거나 디스패치된 경우에만 삭제할 수 있습니다. 작업이 성공적으로 완료되었거나 일관되게 실패한 후 재시도 횟수가 소진된 경우에는 작업을 삭제할 수 없습니다. 최대 작업 보관 기간 한도에 도달하면 작업이 자동으로 삭제됩니다.

  • 할 일 일괄 처리를 만들 수도 있습니다. 자세한 내용은 작업 일괄 만들기를 참고하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • TASK_NAME: 삭제할 작업의 이름입니다(projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID 형식).
  • PROJECT_ID: Google Cloud프로젝트 ID
  • REGION: 큐가 있는 리전입니다(예: 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.v2beta3.BatchDeleteTasksMetadata"
  },
  "done": false
}

큐에서 모든 태스크 삭제

태스크를 삭제하여 큐에서 모든 태스크를 삭제할 수 있습니다. 삭제 호출 전에 생성된 모든 태스크는 완전히 삭제됩니다. 하지만 삭제 작업이 적용되는 데 최대 1분이 걸릴 수 있으며 삭제가 적용되기 전에 작업이 디스패치될 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

    대기열로 이동

  2. 삭제할 태스크가 있는 큐의 이름을 클릭합니다.

  3. 큐 삭제를 클릭합니다.

  4. 메시지가 표시되면 삭제를 클릭합니다.

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프로젝트 ID
  • LOCATION: 큐가 배포되는 리전입니다(예: 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"
}

대기열 일시중지 또는 다시 시작

대기열을 일시중지하거나 재개할 수 있습니다. 큐를 일시중지하면 태스크의 실행 및 전송이 중지됩니다. 태스크를 만들고 큐에 푸시하거나 추가할 수는 있지만 태스크가 처리되지는 않습니다. 대기열이 재개되면 백로그된 작업은 대기열 백로그에 추가된 순서대로 처리됩니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

    대기열로 이동

  2. 일시중지하려는 대기열의 체크박스를 선택합니다.

  3. 대기열 일시중지를 클릭합니다.

  4. 메시지가 표시되면 일시중지를 클릭합니다.

  5. 대기열을 재개하려면 대기열 재개를 클릭합니다.

gcloud

  1. gcloud tasks queues pause 명령어를 사용하여 대기열을 일시중지합니다.

    gcloud tasks queues pause QUEUE_ID \
    --location=LOCATION

    다음을 바꿉니다.

    • QUEUE_ID: 일시중지할 대기열의 이름
    • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

  2. gcloud tasks queues resume 명령어를 사용하여 대기열을 재개합니다.

    gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION

REST

  1. 대기열을 일시중지하려면 projects.locations.queues.pause 메서드를 사용합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • QUEUE_ID: 일시중지할 대기열의 이름
    • PROJECT_ID: Google Cloud프로젝트 ID
    • LOCATION: 큐가 배포되는 리전입니다(예: 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"
}

  2. 대기열을 재개하려면 projects.locations.queues.resume 메서드를 사용합니다.

    요청 데이터를 사용하기 전에 다음을 바꿉니다.

    • QUEUE_ID: 재개할 큐의 이름
    • PROJECT_ID: Google Cloud프로젝트 ID
    • LOCATION: 큐가 배포되는 리전입니다(예: 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)

콘솔

  1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

    대기열로 이동

    Google Cloud 프로젝트의 모든 대기열이 나열됩니다.

  2. 자세한 내용을 보려면 대기열 이름을 클릭한 후 구성 탭을 클릭합니다.

    비율 제한 및 재시도 매개변수 세부정보가 표시됩니다.

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프로젝트 ID
  • LOCATION: 대기열이 생성되는 리전(예: 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"
}

대기열 삭제

대기열을 삭제할 수 있습니다. 대기열에 있는 모든 작업도 삭제됩니다. 대기열을 삭제한 경우 동일한 이름으로 대기열을 다시 만들려면 3일이 경과해야 합니다. 이 대기 기간은 삭제 시 실행 중이거나 실행 대기 중인 작업에서 예기치 않은 동작을 방지합니다. 또한 삭제 또는 재생성 주기의 내부 프로세스 오류도 방지됩니다.

콘솔

  1. Google Cloud 콘솔에서 Cloud Tasks > 대기열 페이지로 이동합니다.

    대기열로 이동

  2. 삭제할 대기열의 체크박스를 선택합니다.

  3. 큐 삭제를 클릭합니다.

  4. 프롬프트에서 대기열 이름을 입력한 다음 확인을 클릭합니다.

gcloud

gcloud tasks queues delete 명령어를 사용하여 대기열을 삭제합니다.

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

다음을 바꿉니다.

  • QUEUE_ID: 삭제할 큐의 이름
  • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

REST

대기열을 삭제하려면 projects.locations.queues.delete 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • QUEUE_ID: 삭제할 큐의 이름
  • PROJECT_ID: Google Cloud프로젝트 ID
  • LOCATION: 큐가 배포되는 리전입니다(예: us-central1).

요청 본문은 비어 있어야 합니다.

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

성공한 경우 응답 본문은 비어 있습니다.

다음 단계