이 문서에서는 일괄 작업 및 태스크를 보는 방법을 설명합니다.
시작하기 전에
- Batch를 사용한 적이 없으면 Batch 시작하기를 검토하고 프로젝트 및 사용자 기본 요건을 완료하여 Batch를 사용 설정하세요.
-
작업 및 태스크를 보는 데 필요한 권한을 얻으려면 프로젝트에 대한 Batch 작업 뷰어(
roles/batch.jobsViewer
) 또는 Batch 작업 편집자(roles/batch.jobsEditor
) IAM 역할을 부여해 달라고 관리자에게 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.
작업 보기
작업을 보려면 다음 방법 중 하나를 선택합니다.
프로젝트의 모든 작업을 보려면 작업 목록을 확인합니다.
특정 작업의 모든 구성 세부정보를 보려면 작업 세부정보를 확인합니다.
작업 목록 보기
Google Cloud 콘솔, gcloud CLI, Batch API, Go, 자바, Node.js, Python 또는 C++를 사용하여 현재 프로젝트의 작업 목록을 볼 수 있습니다.
작업 목록을 필터링하려면(예: 특정 위치에 있거나 하나 이상의 특정 라벨이 있는 작업만 나열) gcloud CLI 또는 Batch API를 사용해야 합니다.
콘솔
Google Cloud 콘솔을 사용하여 현재 프로젝트의 작업 목록을 보려면 작업 목록 페이지로 이동합니다.
gcloud
gcloud CLI를 사용하여 현재 프로젝트의 작업 목록을 보려면 gcloud batch jobs list
명령어를 사용합니다.
gcloud batch jobs list
필요한 경우 하나 이상의 플래그를 추가하여 필터링된 작업 목록을 볼 수 있습니다.
특정 위치의 작업만 보려면
--location
플래그를 포함합니다.필터 표현식을 기준으로 작업만 보려면
--filter
플래그를 지정합니다.
예를 들어 다음 명령어를 사용합니다.
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
다음을 바꿉니다.
LOCATION
: 하나 이상의 작업이 있는 위치입니다.FILTER_EXPRESSION
: 필터 표현식입니다.예를 들어 프로젝트에서 다음 커스텀 라벨을 정의했다고 가정해 보겠습니다.
Cloud Billing 보고서를 볼 때 리서치팀에서 만든 작업과 해당 리소스를 표시하기 위해 일부 작업 및 해당 리소스에는
research
로 설정된team
라벨이 있습니다.시간에 민감한 워크로드를 표시하기 위해 일부 작업에는 다양한 값으로 설정된
deadline
라벨이 있습니다.개발팀이 성공적으로 테스트한 실행 가능 항목을 나타내기 위해 일부 실행 가능 항목에는
true
로 설정된tested
라벨이 있습니다.
다음 필터 표현식을 지정하여 다음 기준을 모두 충족하는 작업만 볼 수 있습니다.
research
로 설정된 작업 할당 정책에team
라벨이 있는 리서치팀의 작업입니다.다음 기준 중 하나 이상을 충족하는 작업:
임의의 값으로 설정된 작업에
deadline
라벨이 있는 시간에 민감한 작업성공적으로 테스트된 실행 가능한 항목이 하나 이상 있는 작업, 즉
true
로 설정된tested
라벨을 사용한 실행 가능한 항목이 하나 이상 있는 작업
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
API
Batch API를 사용하여 특정 위치의 현재 프로젝트에 있는 작업 목록을 보려면 jobs.list
메서드에 대해 GET
요청을 실행합니다.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
다음을 바꿉니다.
필요한 경우 필터 표현식에 따라 필터링된 작업 목록을 보기 위해 filter
쿼리 매개변수를 지정할 수 있습니다.
예를 들어 다음 GET
요청을 수행합니다.
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
FILTER_EXPRESSION
을 URL 인코딩을 사용하는 필터 표현식으로 바꿉니다.
예를 들어 다음 커스텀 라벨을 정의했다고 가정해 보겠습니다.
Cloud Billing 보고서를 볼 때 리서치팀에서 만든 작업과 해당 리소스를 표시하기 위해 일부 작업 및 해당 리소스에는
research
로 설정된team
라벨이 있습니다.시간에 민감한 워크로드를 표시하기 위해 일부 작업에는 다양한 값으로 설정된
deadline
라벨이 있습니다.개발팀이 성공적으로 테스트한 실행 가능 항목을 나타내기 위해 일부 실행 가능 항목에는
true
로 설정된tested
라벨이 있습니다.
다음 필터 표현식을 지정하여 다음 기준을 모두 충족하는 작업만 볼 수 있습니다.
research
로 설정된 작업 할당 정책에team
라벨이 있는 리서치팀의 작업입니다.다음 기준 중 하나 이상을 충족하는 작업:
임의의 값으로 설정된 작업에
deadline
라벨이 있는 시간에 민감한 작업성공적으로 테스트된 실행 가능한 항목이 하나 이상 있는 작업, 즉
true
로 설정된tested
라벨을 사용한 실행 가능한 항목이 하나 이상 있는 작업
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
URL로 인코딩된 필터 표현식은 다음 디코딩된 필터 표현식을 나타냅니다.
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
Go
Go
자세한 내용은 Batch Go API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
자세한 내용은 Batch Java API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
자세한 내용은 Batch Node.js API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
자세한 내용은 Batch Python API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
C++
C++
자세한 내용은 Batch C++ API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
작업 세부정보 보기
Google Cloud 콘솔, gcloud CLI, Batch API, Go, 자바, Node.js, Python, C++를 사용하여 현재 프로젝트의 작업 세부정보를 볼 수 있습니다.
작업에 지정된 라벨을 보려면 gcloud CLI 또는 Batch API를 사용해야 합니다.
콘솔
Google Cloud 콘솔을 사용하여 현재 프로젝트의 작업 세부정보를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 작업 목록 페이지로 이동합니다.
작업 이름 열에서 작업 이름을 클릭합니다.
작업 세부정보 페이지가 열립니다.
세부정보 탭이 기본적으로 열립니다. 자세한 내용을 보려면 다른 탭을 클릭하세요.
gcloud
gcloud CLI를 사용하여 현재 프로젝트의 작업 세부정보를 보려면 --location
플래그와 함께 gcloud batch jobs describe
명령어를 사용합니다.
gcloud batch jobs describe JOB_NAME \
--location=LOCATION
다음을 바꿉니다.
JOB_NAME
: 기존 작업의 이름입니다.LOCATION
: 작업이 있는 위치입니다.
API
Batch API를 사용하여 현재 프로젝트의 작업 세부정보를 보려면 jobs.get
메서드에 GET
요청을 수행합니다.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME
다음을 바꿉니다.
Go
Go
자세한 내용은 Batch Go API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
자세한 내용은 Batch Java API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
자세한 내용은 Batch Node.js API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
자세한 내용은 Batch Python API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
C++
C++
자세한 내용은 Batch C++ API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
태스크 보기
작업 중 하나의 태스크를 보려면 다음 방법 중 하나를 선택합니다.
작업 또는 작업의 태스크 그룹에 있는 모든 태스크를 보려면 작업의 태스크 목록을 확인합니다.
특정 태스크의 모든 구성 세부정보를 보려면 태스크 세부정보를 확인합니다.
작업 태스크 목록 보기
Google Cloud 콘솔, gcloud CLI, Batch API, Go, 자바, Node.js, Python, C++를 사용하여 작업 또는 작업의 태스크 그룹에서 태스크 목록을 볼 수 있습니다.
작업 또는 작업의 태스크 그룹에 있는 태스크 목록을 필터링하려면(예: 실행이 완료된 작업만 나열) gcloud CLI 또는 Batch API를 사용해야 합니다.
콘솔
Google Cloud 콘솔을 사용하여 작업의 태스크 목록 및 태스크 세부정보를 보려면 작업 세부정보를 보고 작업 세부정보 페이지를 연 다음 태스크 세부정보 섹션을 확인하세요.
gcloud
gcloud CLI를 사용하여 작업 태스크 그룹의 태스크 목록을 보려면 다음 플래그와 함께 gcloud batch tasks list
명령어를 사용합니다.
gcloud batch tasks list \
--job=JOB_NAME \
--location=LOCATION
다음을 바꿉니다.
JOB_NAME
: 기존 작업의 이름입니다.LOCATION
: 작업이 있는 위치입니다.
원하는 경우 --filter
플래그를 추가하여 필터 표현식을 기준으로 작업의 태스크 그룹에 있는 필터링된 태스크 목록을 확인할 수 있습니다.
예를 들어 다음 명령어를 사용합니다.
gcloud batch tasks list \
--job=example-job \
--location=us-central1 \
--filter="FILTER_EXPRESSION"
FILTER_EXPRESSION
을 필터 표현식으로 바꿉니다.
예를 들어 실행 중이거나 실행을 성공적으로 마친 작업의 태스크 그룹에 있는 태스크만 표시하도록 다음 필터 표현식을 지정할 수 있습니다.
STATE=RUNNING OR STATE=SUCCEEDED
API
Batch API를 사용하여 작업의 태스크 그룹에 있는 태스크 목록을 보려면 tasks.list
메서드에 대한GET
요청을 수행합니다.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
다음을 바꿉니다.
PROJECT_ID
: 현재 프로젝트의 프로젝트 ID입니다.LOCATION
: 작업이 있는 위치입니다.JOB_NAME
: 기존 작업의 이름입니다.TASK_GROUP_NAME
: 세부정보를 보려는 태스크 그룹의 이름입니다. 값을group0
으로 설정해야 합니다.
원하는 경우 필터 표현식에 따라 작업의 태스크 그룹에 있는 필터링된 태스크 목록을 보기 위해 filter
쿼리 매개변수를 지정할 수 있습니다.
예를 들어 다음 GET
요청을 수행합니다.
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs/example-job/taskGroups/group0/tasks?filter=FILTER_EXPRESSION
FILTER_EXPRESSION
을 URL 인코딩을 사용하는 필터 표현식으로 바꿉니다.
예를 들어 실행 중이거나 실행을 성공적으로 마친 작업의 태스크 그룹에 있는 태스크만 표시하도록 다음 필터 표현식을 지정할 수 있습니다.
STATE=RUNNING%20OR%20STATE=SUCCEEDED
URL로 인코딩된 필터 표현식은 다음 디코딩된 필터 표현식을 나타냅니다.
STATE=RUNNING OR STATE=SUCCEEDED
Go
Go
자세한 내용은 Batch Go API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
자세한 내용은 Batch Java API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
자세한 내용은 Batch Node.js API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
자세한 내용은 Batch Python API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
C++
C++
자세한 내용은 Batch C++ API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
태스크 세부정보 보기
Google Cloud 콘솔, gcloud CLI, Batch API, Go, 자바, Node.js, Python, C++를 사용하여 태스크의 세부정보를 볼 수 있습니다.
콘솔
Google Cloud 콘솔을 사용하여 작업의 태스크 그룹에 있는 태스크의 세부정보를 보려면 작업의 세부정보를 보고 작업 세부정보 페이지를 연 다음 태스크 세부정보 섹션을 확인합니다.
gcloud
gcloud CLI를 사용하여 태스크의 세부정보를 보려면 다음 플래그와 함께 gcloud batch tasks describe
명령어를 사용합니다.
gcloud batch tasks describe TASK_INDEX \
--location=LOCATION \
--job=JOB_NAME \
--task_group=TASK_GROUP_NAME
다음을 바꿉니다.
API
Batch API를 사용하여 태스크의 세부정보를 보려면 tasks.get
메서드에 대해 GET
요청을 수행합니다.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX
다음을 바꿉니다.
Go
Go
자세한 내용은 Batch Go API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
자세한 내용은 Batch Java API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
자세한 내용은 Batch Node.js API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
자세한 내용은 Batch Python API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
C++
C++
자세한 내용은 Batch C++ API 참조 문서를 확인하세요.
Batch에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
다음 단계
Pub/Sub 알림을 사용하여 작업을 모니터링하고 BigQuery에서 이러한 알림을 쿼리하는 방법 알아보기
로그를 이용한 작업 분석 방법 알아보기
라벨을 사용한 리소스 구성 방법 알아보기
작업 삭제 및 내보내기 방법 알아보기