이 페이지에서는 Batch 작업을 실행하는 가상 머신(VM) 인스턴스에 사용할 수 있는 운영체제(OS) 이미지를 열람하는 방법을 설명합니다.
특히 이 페이지에서는 Batch에서 VM OS 이미지의 목록과 세부정보를 보는 방법을 설명합니다. VM OS 이미지와 Batch에서 사용할 수 있는 VM OS 이미지에 대한 자세한 내용은 VM OS 환경 개요를 참조하세요. Compute Engine의 공개 이미지 또는 커스텀 이미지와 같은 다른 VM OS 이미지를 보려면 Compute Engine 이미지 문서를 참조하세요.
시작하기 전에
- Batch를 사용한 적이 없으면 Batch 시작하기를 검토하고 프로젝트 및 사용자 기본 요건을 완료하여 Batch를 사용 설정하세요.
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
이미지 계열에는 Debian 버전 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에서 이미지를 나열하려면
batch-custom-image
프로젝트가 필요합니다. ?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)
쿼리 매개변수를 삭제하세요.
- (선택사항) 지원 중단된 Batch 이미지를 확인해야 하는 경우
각 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
이미지 계열에는 Debian 버전 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
을 바꿉니다.
다음 단계
- Batch의 VM OS 이미지 자세히 알아보기: