Batch의 VM OS 이미지 보기

이 페이지에서는 Batch 작업을 실행하는 가상 머신(VM) 인스턴스에 제공되는 운영체제(OS) 이미지를 열람하는 방법을 설명합니다.

특히 이 페이지에서는 Batch에서 VM OS 이미지의 목록과 세부정보를 보는 방법을 설명합니다. VM OS 이미지 및 Batch에서 사용할 수 있는 VM OS 이미지에 관한 자세한 내용은 VM OS 환경 개요를 참고하세요. Compute Engine의 공개 이미지 또는 맞춤 이미지와 같은 다른 VM OS 이미지를 보려면 Compute Engine 이미지 문서를 참고하세요.

시작하기 전에

Batch에서 VM OS 이미지 목록 보기

gcloud CLI 또는 Batch API를 사용하여 Batch의 모든 VM OS 이미지 목록을 볼 수 있습니다.

gcloud

Batch에서 지원되는 모든 VM OS 이미지를 나열하려면 다음 gcloud compute images list 명령어를 사용하세요.

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • Batch의 이미지를 나열하려면 --project=batch-custom-image 플래그가 필요합니다.
  • --no-standard-images 플래그는 Compute Engine에서 표준 이미지를 생략합니다.
  • (선택사항) 지원 중단된 Batch 이미지를 확인해야 하는 경우 --show-deprecated 플래그도 포함하세요.

각 VM OS 이미지의 출력은 다음과 비슷합니다.

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

이 출력에는 다음 값이 포함됩니다.

  • IMAGE_NAME: 이미지의 이름입니다. 이미지 이름은 VM OS 이미지의 특정 버전을 나타냅니다. 예를 들어 이미지 이름 batch-debian-11-official-20230802-00-p00은 이미지 계열 batch-debian-11-official의 이미지 버전 -20230802-00-p00(2023년 8월 2일 버전)을 나타냅니다.
  • IMAGE_PROJECT_ID: 이미지가 포함된 프로젝트의 프로젝트 ID입니다. 예를 들어 Batch 이미지의 모든 이미지는 batch-custom-image 프로젝트에 있습니다.
  • IMAGE_FAMILY: 이미지의 계열. 특정 이미지가 하나 이상 포함되었으며 OS의 유형과 메이저 버전을 나타내는 이미지 계열. 예를 들어 batch-debian-11-official 이미지 계열에는 Compute Engine의 Debian OS 버전 11을 기반으로 하는 Batch 이미지가 포함되어 있습니다.

API

Batch에서 지원되는 모든 VM OS 이미지를 나열하려면 images.list 메서드에 다음을 요청하세요.

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • batch-custom-image 프로젝트는 Batch의 이미지를 나열하는 데 필요합니다.
  • ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) 쿼리 매개변수는 URL 인코딩을 사용하여 filter 필드를 (-deprecated:*) OR (deprecated.state="ACTIVE")로 설정하여 지원 중단된 이미지를 생략합니다.
    • (선택사항) 지원 중단된 Batch 이미지를 확인해야 하는 경우 ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22) 쿼리 매개변수를 삭제하세요.

각 VM OS 이미지의 출력은 다음과 비슷합니다.

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

이 출력에는 다음 값이 포함됩니다.

  • IMAGE_NAME: 이미지의 이름입니다. 이미지 이름은 VM OS 이미지의 특정 버전을 나타냅니다. 예를 들어 이미지 이름 batch-debian-11-official-20230802-00-p00은 이미지 계열 batch-debian-11-official의 이미지 버전 -20230802-00-p00(2023년 8월 2일 버전)을 나타냅니다.
  • IMAGE_PROJECT_ID: 이미지가 포함된 프로젝트의 프로젝트 ID입니다. 예를 들어 Batch 이미지의 모든 이미지는 batch-custom-image 프로젝트에 있습니다.
  • IMAGE_FAMILY: 이미지의 계열. 특정 이미지가 하나 이상 포함되었으며 OS의 유형과 메이저 버전을 나타내는 이미지 계열. 예를 들어 batch-debian-11-official 이미지 계열에는 Compute Engine의 Debian OS 버전 11을 기반으로 하는 Batch 이미지가 포함되어 있습니다.

Batch에서 VM OS 이미지 세부정보 보기

gcloud CLI 또는 Batch API를 사용하여 VM OS 이미지의 모든 세부정보를 볼 수 있습니다.

gcloud

Batch에서 VM OS 이미지의 세부정보를 보려면 gcloud compute images describe 명령어를 사용하고 batch-custom-image를 이미지 프로젝트로 지정합니다.

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

설명하려는 Batch의 VM OS 이미지 이름으로 IMAGE_NAME을 바꿉니다.

API

Batch에서 VM OS 이미지의 세부정보를 보려면 images.get 메서드에 요청을 수행하고 batch-custom-image를 이미지 프로젝트로 지정합니다.

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

설명하려는 Batch의 VM OS 이미지 이름으로 IMAGE_NAME을 바꿉니다.

다음 단계