작업 실행 관리

이 페이지에서는 작업 실행을 보고 삭제하는 방법을 설명합니다. 작업 구성을 실행, 취소 또는 재정의하려면 작업 실행을 참조하세요.

필요한 역할

Cloud Run 작업을 관리하는 데 필요한 권한을 얻으려면 관리자에게 Cloud Run 작업에 대한 Cloud Run 개발자(roles/run.developer) IAM 역할을 부여해 달라고 요청하세요.

Cloud Run과 연결된 IAM 역할 및 권한 목록은 Cloud Run IAM 역할 및 Cloud Run IAM 권한을 참조하세요. Cloud Run 작업이 Cloud 클라이언트 라이브러리와 같은 Google Cloud API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

프로젝트의 작업 실행 보기

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 프로젝트에서 작업 실행 목록을 볼 수 있습니다.

콘솔

작업 실행 목록을 보려면 다음 안내를 따르세요.

Cloud Run 작업 페이지로 이동합니다.
목록에서 실행을 관리하려는 작업을 찾습니다.
작업을 클릭하여 실행 목록을 표시합니다.
실행 세부정보 페이지의 목록에서 관심 있는 실행을 선택합니다. 필요에 따라 원하는 기준으로 필터(예: 완료 값을 가진 상태) 세트를 사용할 수 있습니다.

gcloud

프로젝트의 모든 작업에 대해 모든 작업 실행을 나열하려면 다음 안내를 따르세요.

gcloud run jobs executions list

특정 작업에 대한 실행만 나열하려면 다음 안내를 따르세요.

gcloud run jobs executions list --job JOB_NAME

JOB_NAME을 필터링하려는 작업 이름으로 바꿉니다.

필터 사용을 포함하여 반환된 목록을 세분화하는 다른 방법은 작업 실행 목록을 참조하세요.

특정 작업의 최신 실행 이름을 가져오려면 --format 플래그를 사용합니다.

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

JOB_NAME을 필터링하려는 작업 이름으로 바꿉니다.

클라이언트 라이브러리

코드에서 모든 작업 실행을 나열하려면 다음 안내를 따르세요.

REST API

작업 실행을 나열하려면 GET HTTP 요청을 Cloud Run Admin API jobs 엔드포인트로 보냅니다.

예를 들어 다음과 같이 curl을 사용합니다.

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions

다음과 같이 바꿉니다.

ACCESS_TOKEN을 작업 실행을 볼 수 있는 IAM 권한이 있는 계정의 유효한 액세스 토큰으로 바꿉니다. 예를 들어 gcloud에 로그인한 경우 gcloud auth print-access-token을 사용하여 액세스 토큰을 검색할 수 있습니다. Cloud Run 컨테이너 인스턴스 내에서 컨테이너 인스턴스 메타데이터 서버를 사용하여 액세스 토큰을 검색할 수 있습니다.
JOB-NAME을 작업 이름으로 바꿉니다.
REGION을 작업의 Google Cloud 리전으로 바꿉니다.
PROJECT-ID를 Google Cloud 프로젝트 ID로 바꿉니다.

작업 실행 세부정보 보기

최근 7일 내에 발생한 모든 실행 내역과 함께 실행 세부정보 창을 사용해서 최근 10,000회의 작업 실행에 대해 작업 실행 세부정보를 볼 수 있습니다. 이전 실행 세부정보는 제거되고 실행 세부정보 창에 더 이상 표시되지 않습니다. 그러나 이전 실행에 대한 로그 및 모니터링 데이터는 해당 제품의 보존 정책에 따라 관리되는 Cloud Logging 및 Cloud Monitoring에 계속 제공됩니다.

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 작업 실행에 대한 세부정보를 볼 수 있습니다.

콘솔

특정 작업 실행에 대한 세부정보를 보려면 다음 안내를 따르세요.

Cloud Run 작업 페이지로 이동합니다.
작업을 클릭하여 작업 세부정보 창을 엽니다.
확인하려는 작업 실행을 클릭합니다. 실행 세부정보가 오른쪽 패널에 표시됩니다.
태스크, 컨테이너, 볼륨, 네트워킹, 보안, YAML 탭과 로그 보기 링크를 확인합니다.
- 태스크에는 작업 실행의 태스크에 대한 정보가 표시됩니다.
- YAML은 YAML 형식의 작업 구성을 보여줍니다.
- 로그 보기 링크를 클릭하여 실행과 관련된 로그를 확인합니다.
- 다른 탭에는 실행에 사용된 작업, 컨테이너, 보안, 연결 등에 대한 정보가 표시됩니다.

gcloud

작업 실행에 대한 세부정보를 보려면 다음 안내를 따르세요.

다음 명령어를 사용합니다.

gcloud run jobs executions describe EXECUTION_NAME

EXECUTION_NAME을 실행 이름으로 바꿉니다.

--format 플래그를 사용하여 출력 형식을 지정하고 추가 정보를 가져올 수 있습니다. YAML 형식의 예시는 다음과 같습니다.

gcloud run jobs executions describe EXECUTION_NAME --format yaml

클라이언트 라이브러리

코드에서 작업 실행 세부정보를 보려면 다음 안내를 따르세요.

REST API

작업 실행 세부정보를 보려면 GET HTTP 요청을 Cloud Run Admin API jobs 엔드포인트로 보냅니다.

예를 들어 다음과 같이 curl을 사용합니다.

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

다음과 같이 바꿉니다.

ACCESS_TOKEN을 작업 실행 세부정보를 볼 수 있는 IAM 권한이 있는 계정의 유효한 액세스 토큰으로 바꿉니다. 예를 들어 gcloud에 로그인한 경우 gcloud auth print-access-token을 사용하여 액세스 토큰을 검색할 수 있습니다. Cloud Run 컨테이너 인스턴스 내에서 컨테이너 인스턴스 메타데이터 서버를 사용하여 액세스 토큰을 검색할 수 있습니다.
JOB-NAME을 작업 이름으로 바꿉니다.
EXECUTION-NAME을 작업 실행 이름으로 바꿉니다.
REGION을 작업의 Google Cloud 리전으로 바꿉니다.
PROJECT-ID를 Google Cloud 프로젝트 ID로 바꿉니다.

작업 실행 삭제

작업 실행을 실행 중에도 삭제할 수 있습니다. 실행을 삭제하면 실행이 진행되지 않습니다.

삭제된 실행은 더 이상 실행 목록에 표시되지 않지만 남은 로그 보관 기간동안 Cloud Logging에서 로그를 사용할 수 있고 모니터링 데이터는 Cloud Monitoring에서 계속 사용할 수 있습니다.

콘솔

작업 실행을 삭제하려면 다음 안내를 따르세요.

Cloud Run 작업 페이지로 이동합니다.
작업을 클릭하여 작업 세부정보 창을 엽니다.
삭제하려는 작업 실행을 선택합니다.
작업 메뉴에서 줄임표 아이콘을 클릭한 다음 삭제를 클릭합니다.
삭제를 확인하는 메시지가 표시되면 확인을 클릭합니다.

gcloud

작업 실행을 삭제하려면 다음 안내를 따르세요.

다음 명령어를 사용합니다.
```
gcloud run jobs executions delete EXECUTION_NAME
```
EXECUTION_NAME을 실행 이름으로 바꿉니다.
확인 메시지가 표시되면 y로 응답합니다. 성공하면 성공 메시지가 표시됩니다.

클라이언트 라이브러리

코드에서 작업 실행을 삭제하려면 다음 안내를 따르세요.

REST API

작업 실행을 삭제하려면 DELETE HTTP 요청을 Cloud Run Admin API jobs 엔드포인트로 보냅니다.

예를 들어 다음과 같이 curl을 사용합니다.

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

다음과 같이 바꿉니다.

ACCESS_TOKEN을 작업 실행을 삭제할 수 있는 IAM 권한이 있는 계정의 유효한 액세스 토큰으로 바꿉니다. 예를 들어 gcloud에 로그인한 경우 gcloud auth print-access-token을 사용하여 액세스 토큰을 검색할 수 있습니다. Cloud Run 컨테이너 인스턴스 내에서 컨테이너 인스턴스 메타데이터 서버를 사용하여 액세스 토큰을 검색할 수 있습니다.
JOB_NAME을 작업 이름으로 바꿉니다.
EXECUTION-NAME을 작업 실행 이름으로 바꿉니다.
REGION을 작업의 Google Cloud 리전으로 바꿉니다.
PROJECT-ID를 Google Cloud 프로젝트 ID로 바꿉니다.