작업 관리

이 페이지에서는 작업 관리 방법을 설명합니다. 작업을 만들려면 작업 만들기를 참조하세요. 작업을 실행하려면 작업 실행을 참조하세요.

필요한 역할

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 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

프로젝트의 작업 보기

다음 방법 중 하나를 사용하여 프로젝트의 작업 목록을 볼 수 있습니다.

Console

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

Cloud Run 작업 페이지로 이동합니다.
선택적으로 드롭다운 메뉴에서 작업 이름, 실행 시간, 리전 등의 기준 중 하나로 작업을 필터링합니다.

명령줄

프로젝트의 모든 작업을 나열하려면 다음 안내를 따르세요.
```
gcloud run jobs list
```
리전별로 작업을 필터링하려면 다음 안내를 따르세요.
```
gcloud run jobs list --region REGION
```
REGION을 필터링하려는 리전 이름으로 바꿉니다(예: us-central1).

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

클라이언트 라이브러리

코드에서 프로젝트의 작업을 보려면 다음 안내를 따르세요.

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

다음과 같이 바꿉니다.

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

작업 세부정보 보기

gcloud 명령줄을 사용하여 작업에 대한 추가 세부정보를 확인합니다.

콘솔

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

Cloud Run 작업 페이지로 이동합니다.
관심 있는 작업을 찾습니다.
작업을 클릭하여 작업 세부정보 페이지를 표시합니다.
기록, 구성, 로그, YAML 탭을 확인하세요.
- 기록 탭에는 작업 실행의 태스크에 대한 정보가 표시됩니다.
- 로그에는 로그 정보가 표시됩니다.
- 구성에는 작업, 컨테이너, 보안, 연결 등에 대한 정보가 표시됩니다.
- YAML은 YAML 형식의 작업 구성을 보여줍니다.

명령줄

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

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

gcloud run jobs describe  JOB_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

다음과 같이 바꿉니다.

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

작업 삭제

현재 실행 중인 작업의 작업 실행이 없는 경우에만 작업을 삭제할 수 있습니다.

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

콘솔

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

Cloud Run 작업 페이지로 이동합니다.
작업을 선택합니다.
삭제를 클릭합니다.

명령줄

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

다음 명령어를 사용합니다.
```
gcloud run jobs delete JOB_NAME
```
JOB_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

다음과 같이 바꿉니다.

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