이 문서에서는 일괄 작업 및 태스크를 보는 방법을 설명합니다.
시작하기 전에
- Batch를 사용한 적이 없으면 Batch 시작하기를 검토하고 프로젝트 및 사용자 기본 요건을 완료하여 Batch를 사용 설정하세요.
-
작업 및 태스크를 보는 데 필요한 권한을 얻으려면 프로젝트에 대한 일괄 작업 뷰어(
roles/batch.jobsViewer
) 또는 일괄 작업 편집자(roles/batch.jobsEditor
) IAM 역할을 부여해 달라고 관리자에게 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
작업 보기
작업을 보려면 다음 방법 중 하나를 선택합니다.
프로젝트의 모든 작업을 보려면 작업 목록을 확인합니다.
특정 작업의 모든 구성 세부정보를 보려면 작업 세부정보를 확인합니다.
작업 목록 보기
Google Cloud 콘솔, gcloud CLI, Batch API, Go, 자바, Node.js, Python 또는 C++를 사용하여 현재 프로젝트의 작업 목록을 볼 수 있습니다.
콘솔
Google Cloud 콘솔을 사용하여 현재 프로젝트의 작업 목록을 보려면 작업 목록 페이지로 이동합니다.
작업 목록은 페이지가 여러 개일 수 있습니다. 다음 페이지로 계속 진행해야 하는 경우 화면 하단에서
다음을 클릭하세요.(선택사항) 작업 목록을 필터링하려면
필터를 클릭합니다. 그런 다음 속성 및 값을 입력하거나 선택합니다.예를 들어 특정 상태의 작업만 포함하도록 목록을 필터링하려면 다음을 입력합니다.
Status:JOB_STATE
JOB_STATE
을 작업 상태(예:FAILED
)로 바꿉니다.
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
: 나열할 작업을 정의하는 필터 표현식. 필터 표현식은 0개 이상의 불리언 연산자(AND
,OR
,NOT
)로 구분된 하나 이상의 속성-값 쌍을 정의해야 합니다.예를 들어 다음 필터 표현식을 참고하세요.
작업 상태 기반 필터링: 특정 상태의 작업만 표시하려면 다음 필터 표현식을 사용합니다.
status.state="JOB_STATE"
JOB_STATE
을 작업 상태(예:FAILED
)로 바꿉니다.라벨 기반 필터링: 프로젝트에서 다음 커스텀 라벨을 정의했다고 가정합니다.
Cloud Billing 보고서를 볼 때 리서치팀에서 만든 작업과 해당 리소스를 표시하기 위해 일부 작업 및 해당 리소스에는
research
로 설정된team
라벨이 있습니다.시간에 민감한 워크로드를 표시하기 위해 일부 작업에는 다양한 값으로 설정된
deadline
라벨이 있습니다.개발팀이 성공적으로 테스트한 실행 가능 항목을 나타내기 위해 일부 실행 가능 항목에는
true
로 설정된tested
라벨이 있습니다.
그런 다음, 다음 필터 표현식을 지정할 수 있습니다.
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))
이 필터 표현식은 다음 기준을 모두 충족하는 작업만 나열합니다.
research
로 설정된 작업 할당 정책에team
라벨이 있는 리서치팀의 작업입니다.다음 기준 중 하나 이상을 충족하는 작업:
임의의 값으로 설정된 작업에
deadline
라벨이 있는 시간에 민감한 작업성공적으로 테스트된 실행 가능한 항목이 하나 이상 있는 작업, 즉
true
로 설정된tested
라벨을 사용한 실행 가능한 항목이 하나 이상 있는 작업
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 인코딩을 사용하는 필터 표현식으로 바꿉니다.
필터 표현식은 0개 이상의 불리언 연산자(AND
, OR
, NOT
)로 구분된 하나 이상의 속성-값 쌍을 정의해야 합니다.
예를 들어 다음 필터 표현식을 참고하세요.
작업 상태 기반 필터링: 특정 상태의 작업만 표시하려면 다음 필터 표현식을 사용합니다.
status.state="JOB_STATE"
JOB_STATE
을 작업 상태(예:FAILED
)로 바꿉니다.라벨 기반 필터링: 프로젝트에서 다음 커스텀 라벨을 정의했다고 가정합니다.
Cloud Billing 보고서를 볼 때 리서치팀에서 만든 작업과 해당 리소스를 표시하기 위해 일부 작업 및 해당 리소스에는
research
로 설정된team
라벨이 있습니다.시간에 민감한 워크로드를 표시하기 위해 일부 작업에는 다양한 값으로 설정된
deadline
라벨이 있습니다.개발팀이 성공적으로 테스트한 실행 가능 항목을 나타내기 위해 일부 실행 가능 항목에는
true
로 설정된tested
라벨이 있습니다.
그런 다음, 다음 필터 표현식을 지정할 수 있습니다.
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))
이 필터 표현식은 다음 기준을 모두 충족하는 작업만 나열합니다.
research
로 설정된 작업 할당 정책에team
라벨이 있는 리서치팀의 작업입니다.다음 기준 중 하나 이상을 충족하는 작업:
임의의 값으로 설정된 작업에
deadline
라벨이 있는 시간에 민감한 작업성공적으로 테스트된 실행 가능한 항목이 하나 이상 있는 작업, 즉
true
로 설정된tested
라벨을 사용한 실행 가능한 항목이 하나 이상 있는 작업
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 콘솔을 사용하여 현재 프로젝트의 작업 세부정보를 보려면 다음 단계를 따르세요.
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를 사용하여 알림을 분석할 수 있습니다.
작업 관리 방법 알아보기