사용자 정의 이미지 관리
사용자 지정 이미지를 IBM Cloud VPC 으로 가져온 후에는 이미지에 대한 세부 정보를 보고, 이미지의 수명 주기를 관리하고, 이미지를 사용하여 가상 서버 인스턴스를 만들고, 이미지를 내보내고, 비공개 카탈로그와 공유할 수도 있습니다.
- 볼륨에서 이미지를 관리하려면 볼륨에서 이미지 관리 를 참조하십시오.
- 개인 카탈로그에서 사용자 정의 이미지를 사용하려면 VPC용 가상 서버 이미지 온보딩을 참조하십시오.
- 사용자 지정 이미지에 허용된 사용 표현식을 사용하여 이미지의 기능과 제한 사항을 정의하고 서버를 만드는 동안 호환되는 이미지 및 프로필 조합을 찾으려면 사용자 지정 이미지에 허용된 사용 표현식 추가하기를 참조하세요.
IBM Cloud® Identity and Access Management (IAM)을 사용하면 플랫폼 서비스에 대한 사용자 인증을 안전하게 수행하고, 전반에 걸쳐 리소스에 대한 액세스를 일관되게 제어할 수 있습니다. IBM Cloud 사용자 정의 이미지의 액세스 요구사항에 대한 자세한 정보는 Image Service for VPC 의 IAM 역할 및 조치 정보를 참조하십시오.
다음 예제에 등장하는 $vpc_api_endpoint 및 $iam_token 변수에 대한 자세한 내용은 ‘가상 사설 클라우드(VPC) API 개요’의 ‘인증’ 및 ‘엔드포인트 URL’ 섹션을 참조하십시오.
UI를 사용하여 사용자 정의 이미지 관리
IBM Cloud 콘솔을 사용하여 이미지를 관리할 수 있습니다.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘
> 인프라
> 컴퓨팅 > 이미지 으로 이동합니다.
- 사용자 정의 이미지 탭에서 특정 이미지에 대한 조치 아이콘
을 클릭하고 사용 가능한 옵션에서 선택하십시오. 암호화된 사용자 정의 이미지는 이미지 이름 뒤에 잠금 아이콘으로 식별됩니다. 선택할 수 있는 조치는 다음과 같습니다.
| 조치 | 설명 |
|---|---|
| 이름 바꾸기 | 사용자 정의 이미지의 이름을 바꾸십시오. |
| 가상 서버 인스턴스 작성 | 사용자 정의 이미지에서 새 가상 서버를 작성하십시오. |
| 내보내기 | 사용자 정의 이미지를 IBM Cloud Object Storage에 복사하십시오. |
| 카탈로그에 공유 | IBM Cloud VPC 사용자 정의 이미지를 기존 개인용 카탈로그에 공유하십시오. |
| 복사 | 사용자 정의 이미지의 UUID를 복사하십시오. |
| 체크섬 보기 | 사용자 정의 이미지의 체크섬을 보십시오. |
| 라이프사이클 스케줄 | 이미지 라이프사이클 스케줄 패널을 엽니다. 상태를 즉시 변경하거나 향후 날짜 및 시간에 대한 동상 변경을 스케줄할 수 있습니다. 단일 상태 변경을 스케줄하거나 이미지의 전체 라이프사이클을 스케줄할 수 있습니다. 이미지 상태는 다음과 같습니다.
이 세 가지 상태 사이를 자유롭게 오갈 수 있습니다. 변경할 수 있는 상태만 표시됩니다. 달력 날짜 및 시간 또는 일 수를 사용하여 상태 변경을 스케줄할 수 있습니다. 폐기 날짜는 항상 폐기 날짜 이후여야 합니다. |
| 삭제 | 사용자 정의 이미지를 삭제하십시오.
개인용 카탈로그에서 사용자 정의 이미지를 삭제하려면 개인용 카탈로그에서 사용자 정의 이미지 삭제 를 참조하십시오. |
CLI를 사용하여 사용자 정의 이미지 나열
명령행 인터페이스 (CLI) 를 사용하여 사용자 지역의 모든 IBM Cloud VPC 사용자 정의 이미지를 나열할 수 있습니다.
CLI를 사용하여 모든 사용자 정의 이미지를 나열하려면 ibmcloud is images 명령을 사용하십시오. 사용자 정의 이미지는 이미지가 작성되는 계정에 대해 개인용이므로 --visibility 옵션은 private 입니다.
ibmcloud is images --visibility private
자세한 내용은 VPC CLI 참조 페이지의 “ibmcloud is images” 항목을 참조하십시오.
API를 사용하여 모든 이미지 나열하기
API (Application Programming Interface) 를 사용하여 사용자 지역의 모든 IBM Cloud VPC 이미지를 나열할 수 있습니다.
API를 사용하여 모든 이미지를 나열하려면 모든 이미지 나열 을 사용하십시오. 사용자 정의 이미지는 작성된 계정에 대해 개인용이므로 visibility 특성을 private 로 설정하여 사용자 정의 이미지만 검색할 수 있습니다.
curl -X GET \
”$vpc_api_endpoint/v1/images?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Terraform을 사용하여 모든 이미지 나열
Terraform을 사용하여 사용자 지역의 모든 IBM Cloud VPC 이미지를 나열할 수 있습니다.
Terraform을 사용하여 모든 이미지를 나열하려면 Terraform 데이터 소스 명령 ibm_is_images를 사용하십시오. 사용자 정의 이미지는 작성된 계정에 대해 개인용이므로 visibility 속성을 private 로 설정하여 사용자 정의 이미지만 검색할 수 있습니다.
data "ibm_is_images" "images" {
visibility = "public"
}
UI를 사용하여 사용자 정의 이미지 세부 정보 보기
사용자 정의 이미지의 다음 세부사항을 볼 수 있습니다.
- 허용된 사용 표현식
- 지정된 자원 그룹
- 체크섬
- 작성 날짜
- CRN
- 더 이상 사용되지 않는 날짜 (설정된 경우)
- 암호화 유형
- 위치
- 이름 및 ID
- 폐기 날짜 (설정된 경우)
- 운영 체제 및 버전
- 크기
- 소스 유형
사용자 정의 이미지의 이름을 편집하고, 검색 가능성을 위해 태그를 추가하고, 고유 클라우드 자원 이름 (CRN) 을 보고 복사할 수 있습니다. 이미지의 SHA256 체크섬 값에 액세스할 수 있습니다.
사용자 정의 이미지의 세부 정보를 확인하려면 다음 단계를 완료하십시오.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘
> 인프라
> 컴퓨팅 > 이미지 으로 이동합니다.
- 사용자 지정 이미지 탭에서 사용자 지정 이미지의 이름을 클릭한 다음 다음 패널에서
View image details을 클릭합니다. - 이미지 세부정보 페이지에서 이미지의 이름을 편집하고, 체크섬을 복사하고, 태그를 추가하고, 이미지의 CRN을 복사하고, 이미지의 허용된 사용 표현을 편집할 수 있습니다.
- 이미지 세부 정보 페이지의 ‘작업’ 메뉴에서 사용자 지정 이미지를 사용하여 가상 서버 인스턴스를 생성하거나 이미지를 삭제하는 등의 작업을 수행할 수 있습니다. 가능한 조치의 전체 목록은 UI를 사용하여 사용자 정의 이미지 관리 를 참조하십시오.
CLI를 사용하여 사용자 정의 이미지 세부사항 보기
명령행 인터페이스 (CLI) 를 사용하여 사용자 정의 이미지의 세부사항 (예: 이름 및 ID, 운영 체제 및 버전, 암호화 상태, 폐기 또는 폐기 날짜, 지정된 자원 그룹) 을 볼 수 있습니다.
CLI를 사용하여 사용자 정의 이미지의 세부 정보를 확인하려면 ibmcloud is image 명령을 사용하십시오. IMAGE 변수를 사용하여 사용자 정의 이미지의 이름 또는 ID를 지정하십시오.
ibmcloud is image IMAGE
자세한 내용은 VPC CLI 참조 페이지의 ‘ibmcloud is image’ 항목을 참조하십시오.
API를 사용하여 사용자 정의 이미지 세부사항 검색
API (Application Programming Interface) 를 사용하여 사용자 정의 이미지의 세부사항 (예: 이름 및 ID, 운영 체제 및 버전, 암호화 상태, 폐기 또는 폐기 날짜, 지정된 자원 그룹) 을 볼 수 있습니다.
API를 사용하여 특정 사용자 정의 이미지의 세부사항을 검색하려면 이미지 검색 을 사용하십시오. $image_id 변수의 경우 검색할 사용자 정의 이미지의 ID를 지정하십시오.
curl -X GET \
”$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
Terraform을 사용하여 사용자 정의 이미지 세부사항 검색
Terraform을 사용하여 사용자 정의 이미지의 세부사항 (예: 이름 및 ID, 운영 체제 및 버전, 암호화 상태, 폐기 또는 폐기 날짜, 지정된 리소스 그룹) 을 볼 수 있습니다.
Terraform을 사용하여 이미지의 세부사항을 보려면 Terraform 데이터 소스 명령 ibm_is_images를 사용하십시오. name 변수의 경우 검색할 사용자
정의 이미지의 이름을 지정하십시오.
data "ibm_is_images" "image_name" {
}
IBM Cloud Object Storage 에 사용자 정의 이미지 내보내기
사용자 정의 이미지를 IBM Cloud Object Storage에 내보낼 수 있습니다. 나중에 이미지를 다시 가져와서 새로운 영역에 복사할 수 있습니다. 또는 VPC 외부에서 이미지를 추출하여 사내와 같은 다른 위치에서 사용하고자 할 수도 있습니다. IBM Cloud Object Storage에 이미지를 저장하는 경우 비용이 발생할 수 있습니다. 자세한 정보는 청구 를 참조하십시오.
전제조건
사용자 정의 이미지를 내보내려면 다음 전제조건을 충족해야 합니다.
is.image.image.export및is.image.image.operate조치를 포함하는 IAM 역할이 필요합니다. 자세한 정보는 VPC 인프라 서비스에 대한 IAM 액세스 관리 를 참조하십시오.- IBM Cloud Object Storage 서비스 인스턴스가 작성되어야 합니다. 또한 작성자 서비스 액세스 역할을 사용하여 IBM Cloud Object Storage 에 액세스하려면 VPC용 이미지 서비스에 대한 권한을 작성해야 합니다. 자세한 정보는 이미지를 가져오고 내보내기 위해 IBM Cloud Object Storage 에 대한 액세스 부여 를 참조하십시오.
- 이미지를 내보낼 버킷에 쓰려면 IAM 액세스 권한이 필요합니다. 자세한 정보는 개별 버킷에 대한 액세스 지정 을 참조하십시오.
내보내기 작업이 진행 중인 동안 내보내고 있는 이미지가 삭제되면 이미지 상태가 deleting 로 설정됩니다. 이미지 삭제가 완료되기 전에 내보내기 작업을 완료할 수 있습니다. 이미지 삭제가 완료되면 해당 내보내기 작업 히스토리를 사용할 수 없습니다. 내보내기 작업에 대한 활동 추적 이벤트를 사용하여
최종 상태를 확인할 수 있습니다.
UI를 사용하여 사용자 정의 이미지 내보내기
사용자 정의 이미지를 IBM Cloud Object Storage으로 내보내려면 다음 단계를 완료하십시오.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘
> 인프라
> 컴퓨팅 > 이미지 으로 이동합니다.
- 사용자 정의 이미지 탭에서 내보낼 사용자 정의 이미지의 이름을 클릭하십시오.
- 이미지 세부사항 페이지에서 조치 메뉴를 클릭하고 내보내기를 선택하십시오.
- 사용자 정의 이미지 내보내기 패널에서 선택적으로 내보내기 작업의 이름을 지정할 수 있습니다. 이름은 이미지 이름과 함께 IBM Cloud Object Storage에서 내보낸 오브젝트의 이름을 구성하는 데 사용됩니다. 이름을 지정하지 않으면 이름이 자동으로 생성됩니다.
- 내보낼 파일 형식을 선택하십시오. 유효한 파일 형식은 QCOW2 및 VHD 입니다. 사용자 정의 이미지가 암호화된 이미지인 경우 QCOW2 형식이 필요합니다.
- 사용자 정의 이미지를 내보낼 IBM Cloud Object Storage 서비스 인스턴스 및 버킷을 지정하십시오. 또는 이미지를 내보낼 IBM Cloud Object Storage 버킷에 대한 CRN을 지정할 수 있습니다.
- '사용자 지정 이미지 내보내기'를 클릭하세요.
CLI를 사용하여 사용자 정의 이미지 내보내기
명령행 인터페이스 (CLI) 를 사용하여 IBM Cloud VPC 사용자 정의 이미지를 IBM Cloud Object Storage 에 내보낼 수 있습니다.
CLI를 사용하여 사용자 정의 이미지를 내보내려면 ibmcloud is image-export-job-create 명령을 사용하십시오. IMAGE 변수를 사용하여 내보낼 사용자 정의 이미지의 이름 또는 ID를 지정하십시오. NEW_NAME 를 사용하여 내보내기 작업의 이름을 지정할 수 있습니다. 이미지를 내보내기 위한 파일 형식을 지정할 수도 있습니다
( qcow2 또는 vhd). qcow2 형식은 기본 파일 형식이며 사용자 정의 이미지가 암호화된 경우 필수 형식입니다. 또한 사용자 정의 이미지를 내보낼 IBM Cloud Object Storage BUCKET 을 지정하십시오.
ibmcloud is image-export-job-create IMAGE [--name NEW_NAME] [--format qcow2 | vhd] --bucket BUCKET
다음 예제는 ID가 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 인 사용자 정의 이미지를 내보냅니다. 내보내기 작업의 이름은 my-export-job 입니다. 이미지를 내보내기 위한 파일 형식은 qcow2 입니다. 내보낸 이미지의 이름이 my-bucket 인 IBM Cloud Object Storage 버킷입니다.
ibmcloud is image-export-job-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-export-job --format qcow2 --bucket my-bucket
자세한 정보는 VPC CLI 참조 페이지에서 ibmcloud is image-export-job-create 를 참조하십시오.
API를 사용하여 사용자 정의 이미지 내보내기
API (Application Programming Interface) 를 사용하여 IBM Cloud VPC 사용자 정의 이미지를 IBM Cloud Object Storage 에 내보낼 수 있습니다.
API를 사용하여 사용자 정의 이미지를 내보내려면 이미지 내보내기 작업 작성 을 사용하십시오.
$image_id 변수의 경우 내보낼 사용자 정의 이미지의 ID를 지정하십시오. 선택적으로 이미지 내보내기 작업에 대해 의미 있는 name 를 지정할 수 있습니다. 이 예제에서 내보내기 작업 이름은 my-image-export 입니다. storage_bucket name 하위 특성에 대해 사용자 정의 이미지를
내보낼 IBM Cloud Object Storage 버킷의 이름을 지정하십시오. 이 예제에서 버킷 이름은 bucket-27200-lwx4cfvcue 입니다. 또는 crn 하위 특성을 사용하여 버킷의 CRN을 지정할 수 있습니다.
curl -X POST \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-image-export",
"storage_bucket": {
"name": "bucket-27200-lwx4cfvcue"
}
}'
사용자 정의 이미지 내보내기 히스토리 보기 및 관리
사용자 정의 이미지 내보내기 히스토리를 보고 IBM Cloud Object Storage의 내보내기 작업 이름, 상태, 대상 버킷, 지정된 IBM Cloud Object Storage 오브젝트 이름, 내보내기 작업이 시작된 날짜, 내보내기 작업이 완료된 경우 완료 날짜 등의 세부사항을 볼 수 있습니다.
완료된 이미지 내보내기 작업을 삭제할 수도 있습니다. 또는 is.image.image.export 조치를 포함하는 IAM 역할이 있는 경우 진행 중인 이미지 내보내기 작업을 삭제 (및 취소) 할 수 있습니다.
이미지 내보내기 작업을 삭제하면 내보내기 히스토리에서만 제거됩니다. 내보낸 이미지 파일은 IBM Cloud Object Storage 버킷에서 제거되지 않습니다. IBM Cloud Object Storage 인터페이스를 사용하여 IBM Cloud Object Storage 에 저장된 파일을 관리해야 합니다.
마지막으로 이미지 내보내기 작업의 이름을 바꿀 수 있습니다. 이미지 내보내기 작업의 이름을 바꾸어도 IBM Cloud Object Storage에서 작성된 오브젝트의 이름은 변경되지 않습니다.
이미지 내보내기 작업의 한계
이미지 내보내기 작업에 대해 다음과 같은 한계가 있습니다.
- 이미지당 5개의 활성 내보내기 작업 요청
- 이미지당 총 10개의 내보내기 작업
- 지역별 계정당 20개의 활성 내보내기 작업
UI를 사용하여 사용자 정의 이미지 내보내기 히스토리 보기
사용자 정의 이미지의 내보내기 히스토리를 보려면 다음 단계를 완료하십시오.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘
> 인프라
> 컴퓨팅 > 이미지 으로 이동합니다.
- '사용자 지정 이미지' 탭에서 사용자 지정 이미지의 이름을 클릭하면 해당 이미지에 대한 세부 정보를 볼 수 있습니다.
- 이미지 세부사항 페이지에서 히스토리 내보내기 탭을 클릭하십시오.
UI를 사용하여 이미지 내보내기 작업 삭제 또는 취소
완료된 이미지 내보내기 작업을 삭제하거나 진행 중인 이미지 내보내기 작업을 취소 (및 삭제) 하려면 다음 단계를 완료하십시오.
- 이미지 세부사항 페이지에서 히스토리 내보내기 탭을 클릭하십시오.
- 삭제하거나 취소할 내보내기 작업의 경우 동작 아이콘
을 클릭하고 삭제를 선택하십시오.
UI를 사용하여 이미지 내보내기 작업 이름 바꾸기
이미지 내보내기 작업의 이름을 바꾸려면 다음 단계를 완료하십시오.
- 이미지 세부사항 페이지에서 히스토리 내보내기 탭을 클릭하십시오.
- 이름을 바꾸려는 내보내기 작업의 경우, 조치 아이콘
을 클릭하고 이름 바꾸기를 선택하십시오.
CLI를 사용하여 사용자 정의 이미지 내보내기 히스토리 보기
CLI를 사용하여 특정 사용자 정의 이미지의 내보내기 히스토리를 보려면 ibmcloud is image-export-jobs 명령을 사용하십시오. IMAGE 변수를 사용하여 내보낸 사용자 정의 이미지의 이름 또는 ID를 지정하십시오.
ibmcloud is image-export-jobs IMAGE
다음 예제는 ID가 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 인 사용자 정의 이미지에 대한 내보내기 작업 히스토리를 표시합니다.
ibmcloud is image-export-jobs 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
자세한 내용은 VPC CLI 참조 페이지의 [ibmcloud is image-export-jobs](/docs/vpc?topic=vpc-vpc-reference#image-export-jobs-list) 항목을 참조하십시오.
CLI를 사용하여 이미지 내보내기 작업 세부사항 보기
CLI를 사용하여 특정 이미지 내보내기 작업의 세부사항을 보려면 ibmcloud is image-export-job 명령을 사용하십시오. IMAGE 변수를 사용하여 내보낸 사용자 정의 이미지의 이름 또는 ID를 지정하십시오. JOB 변수를 사용하여 이미지 내보내기 작업의 이름 또는 ID를 지정하십시오.
ibmcloud is image-export-job IMAGE JOB
자세한 정보는 VPC CLI 참조 페이지에서 ibmcloud is image-export-job 을 참조하십시오.
CLI를 사용하여 이미지 내보내기 작업 삭제 또는 취소
완료된 이미지 내보내기 작업을 삭제하거나 진행 중인 이미지 내보내기 작업을 취소 (및 삭제) 하려면 ibmcloud is image-export-job-delete 명령을 사용하십시오. IMAGE 변수를 사용하여 내보낸 사용자 정의 이미지의 이름 또는 ID를 지정하십시오. JOB 변수를 사용하여 이미지 내보내기 작업의 이름 또는
ID를 지정하십시오.
ibmcloud is image-export-job-delete IMAGE JOB
자세한 정보는 VPC CLI 참조 페이지에서 ibmcloud is image-export-job-delete 를 참조하십시오.
CLI를 사용하여 이미지 내보내기 작업 이름 바꾸기
CLI를 사용하여 사용자 정의 이미지 내보내기 작업의 이름을 바꾸려면 ibmcloud is image-export-job-update 명령을 사용하십시오. IMAGE 변수를 사용하여 내보낸 사용자 정의 이미지의 이름 또는 ID를 지정하십시오. JOB 변수를 사용하여 이미지 내보내기 작업의 이름 또는 ID를 지정하십시오. NAME 변수를 사용하여 이미지 내보내기 작업에 지정할 새 이름을 지정하십시오.
ibmcloud is image-export-job-update IMAGE JOB --name NAME
자세한 내용은 VPC CLI 참조 페이지의 [ibmcloud is image-export-job-update](/docs/vpc?topic=vpc-vpc-reference#image-export-job-update) 항목을 참조하십시오.
API를 사용하여 사용자 정의 이미지 내보내기 히스토리 보기
API를 사용하여 특정 사용자 정의 이미지의 내보내기 히스토리를 보려면 모든 이미지 내보내기 작업 나열 을 사용하십시오.
$image_id 변수의 경우 내보내기 작업을 표시할 사용자 정의 이미지의 ID를 지정하십시오.
curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
API를 사용하여 이미지 내보내기 작업 세부사항 보기
API를 사용하여 특정 이미지 내보내기 작업의 세부사항을 보려면 이미지 내보내기 작업 검색 을 사용하십시오.
$image_id 변수의 경우 내보낸 사용자 정의 이미지의 ID를 지정하십시오. $export_job_id 변수의 경우 세부사항을 검색할 이미지 내보내기 작업의 ID를 지정하십시오.
curl -X GET \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
API를 사용하여 이미지 내보내기 작업 삭제 또는 취소
API를 사용하여 완료된 이미지 내보내기 작업을 삭제하거나 진행 중인 이미지 내보내기 작업을 취소 (및 삭제) 하려면 이미지 내보내기 작업 삭제 를 사용하십시오.
$image_id 변수의 경우 내보내기 작업을 삭제할 사용자 정의 이미지의 ID를 지정하십시오. $export_job_id 변수의 경우 삭제할 이미지 내보내기 작업의 ID를 지정하십시오.
curl -X DELETE \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H "Authorization: Bearer $iam_token"
API를 사용하여 이미지 내보내기 작업 이름 바꾸기
API를 사용하여 사용자 정의 이미지 내보내기 작업의 이름을 바꾸려면 이미지 내보내기 작업 업데이트 를 사용하십시오.
$image_id 변수의 경우 내보내기 작업의 이름을 바꿀 사용자 정의 이미지의 ID를 지정하십시오. $export_job_id 변수의 경우 이름을 바꿀 이미지 내보내기 작업의 ID를 지정하십시오. 다음 예제에서 이미지 내보내기 작업에 지정할 새 이름은 my-export-job-patched 입니다.
curl -X PATCH \
"$vpc_api_endpoint/v1/images/$image_id/export_jobs/$export_job_id?version=2022-11-21&generation=2" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $iam_token" \
-d '{
"name": "my-export-job-patched"
}'
UI를 사용하여 개인용 카탈로그에 사용자 정의 이미지 공유
기존 IBM Cloud VPC 사용자 정의 이미지를 기존 개인용 카탈로그에 공유할 수 있습니다. 개인용 카탈로그가 아직 없는 경우 VPC에 대한 가상 서버 이미지 온보딩 을 참조하십시오.
개인용 카탈로그에 이미지 공유 조치는 다음 이미지에 사용할 수 없습니다.
- 이 이미지는 이미 비공개 카탈로그에 공유되어 있습니다. 개인용 카탈로그의 이미지는 하나의 개인용 카탈로그의 한 제품 오퍼링 내에서 하나의 버전에만 존재할 수 있습니다. 이미지를 다른 버전에서 공유하려면 먼저 이미지가 있는 버전에서 이미지를 제거해야 합니다.
- 이미지가 암호화됩니다.
- 이미지가 x86 이미지가 아닙니다.
개인용 카탈로그에 사용자 정의 이미지를 공유하려면 다음 단계를 완료하십시오.
- IBM Cloud 콘솔 에서 탐색 메뉴 아이콘
> 인프라
> 컴퓨팅 > 이미지 으로 이동합니다.
- 사용자 정의 이미지 탭에서 조치 아이콘
을 클릭하고 카탈로그에 공유를 선택하십시오.
- 개인용 카탈로그에 이미지 공유 페이지의 사용 가능한 개인용 카탈로그 목록에서 개인용 카탈로그 를 선택하십시오.
- 소프트웨어 버전에 버전 번호를 입력하십시오.
- 카탈로그 오퍼링 작성 을 클릭하여 이미지를 개인용 카탈로그와 공유하십시오.
- 이미지가 작성된 후 이미지 유효성 검증을 클릭하십시오.
이 과정은 사용자 정의 이미지를 개인 카탈로그에만 공유합니다. 유효성 검증 프로세스는 개인용 카탈로그 내에서 발생합니다. 이미지 유효성 검증 을 클릭하면 새 페이지로 이동하고 이 화면에서 3단계: VPC용 가상 서버 이미지 온보딩에서 가상 서버 이미지 유효성 검증 으로 시작하여 유효성 검증 프로세스를 완료할 수 있습니다.
CLI를 사용하여 개인용 카탈로그에 사용자 정의 이미지 공유
IBM Cloud VPC 의 UI를 사용하면 개인 카탈로그에만 사용자 정의 이미지를 공유할 수 있습니다. CLI를 사용하여 개인 카탈로그에 온보딩하는 방법에 대한 자세한 내용은 계정에 소프트웨어 온보딩하기를 참조하십시오.
API를 사용하여 개인용 카탈로그에 사용자 정의 이미지 공유
IBM Cloud VPC 의 UI를 사용하면 개인 카탈로그에만 사용자 정의 이미지를 공유할 수 있습니다. API를 사용하여 개인 카탈로그에 온보딩하는 방법에 대한 자세한 내용은 계정에 소프트웨어 온보딩하기를 참조하세요.
Terraform을 사용하여 개인용 카탈로그에 사용자 정의 이미지 공유
IBM Cloud VPC 의 UI를 사용하면 개인 카탈로그에만 사용자 정의 이미지를 공유할 수 있습니다. Terraform을 사용하여 개인 카탈로그에 온보딩하는 방법에 대한 자세한 내용은 계정에 소프트웨어 온보딩하기를 참조하십시오.
콘솔에서 사용자 지정 이미지 수명 주기 상태 변경 예약하기
단일 이미지 라이프사이클 상태 변경을 스케줄하거나 이미지의 전체 라이프사이클에 대한 상태 변경을 스케줄할 수 있습니다. 향후 상태 변경을 스케줄하지 않은 경우에만 즉시 상태를 변경할 수 있습니다.
단일 상태 변경을 스케줄하려면 다음 단계를 수행하십시오.
이미지에 대한 단일 상태 변경을 스케줄할 수 있습니다.
- IBM Cloud 콘솔에서 탐색 메뉴 아이콘메뉴
> 인프라
> 컴퓨팅 > 이미지로 이동합니다.
- 사용자 정의 이미지 탭에서 특정 이미지에 대한 조치 아이콘
을 클릭하고 사용 가능한 옵션에서 선택하십시오.
- 스케줄 라이프사이클을 선택하십시오.
- 이미지 상태에서 이미지의 상태 변경을 선택하십시오.
- 더 이상 사용되지 않음 세부사항에서 즉시 상태를 변경할지 또는 향후 날짜 스케줄로 변경할지 여부를 선택하십시오.
- 향후 날짜 예약을 선택한 경우 다음 필드를 입력해야 합니다:
- 달력 날짜별 또는 일 수별을 선택하십시오.
- 달력 날짜별을 선택한 경우 날짜 및 시간 정보를 입력하십시오. 상태 변경이 발생할 날짜 및 시간입니다.
- 일 수를 선택한 경우 상태가 변경되기 전에 경과할 일 수를 입력하십시오.
- 달력 날짜별 또는 일 수별을 선택하십시오.
- 저장 을 클릭하십시오.
이미지의 전체 라이프사이클을 스케줄하려면 다음 단계를 수행하십시오.
이미지의 전체 라이프사이클을 스케줄할 수 있습니다. 이미지는 먼저 더 이상 사용되지 않으며 사용자가 정의하는 스케줄에 따라 더 이상 사용되지 않도록 변경됩니다. 라이프사이클 변경을 스케줄하려면 다음 단계를 사용하십시오.
-
IBM Cloud 콘솔에서 탐색 메뉴 아이콘메뉴
> 인프라
> 컴퓨팅 > 이미지로 이동합니다.
-
사용자 정의 이미지 탭에서 특정 이미지에 대한 조치 아이콘
을 클릭하고 사용 가능한 옵션에서 선택하십시오.
-
스케줄 라이프사이클을 선택하십시오.
-
전체 수명 주기 예약을 선택합니다.
- 달력 날짜별을 선택한 경우 상태 변경이 발생할 날짜 및 시간을 입력하십시오.
- 일 수를 선택한 경우 상태가 변경되기 전에 경과할 일 수를 입력하십시오.
폐기 날짜는 폐기 날짜 이후여야 합니다.
-
스케줄을 클릭하십시오.
CLI를 사용하여 사용자 정의 이미지 라이프사이클 상태 변경
명령행 인터페이스 (CLI) 를 사용하여 IBM Cloud VPC 사용자 정의 이미지의 라이프사이클 상태를 변경할 수 있습니다. ibmcloud is image-deprecate 또는 ibmcloud is image-obsolete 명령을 사용하여 즉시 상태를 변경할 수 있습니다. ibmcloud is image-update 명령을 사용하여
향후 날짜 및 시간에 대해 이러한 상태 변경을 스케줄할 수도 있습니다. IMAGE 변수를 사용하여 사용자 정의 이미지의 이름 또는 ID를 지정하십시오.
즉시 상태를 변경하려면 다음 예제 중 하나를 사용하십시오.
향후 상태 변경이 스케줄되지 않은 경우에만 즉시 상태 변경을 수행할 수 있습니다. 스케줄된 상태 변경을 제거하려면 CLI를 사용하여 스케줄된 사용자 정의 이미지 라이프사이클 상태 변경 제거 를 참조하십시오. 스케줄된 상태 변경을 제거한 후 즉시 상태 변경을 수행할 수 있습니다.
-
이미지 라이프사이클 상태를
deprecate으로 변경하십시오.ibmcloud is image-deprecate IMAGE -
이미지 라이프사이클 상태를
obsolete으로 변경하십시오.ibmcloud is image-obsolete IMAGE
상태 변경을 스케줄하려면 다음 예제를 사용하십시오.
deprecate-at 또는 obsolete-at 옵션의 경우 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 날짜 및 시간 형식으로 날짜를 지정하십시오.
YYYY는 네 자리 연도입니다.MM는 두 자리 숫자의 월입니다.DD는 두 자리 일입니다.T는 날짜 및 시간 정보를 구분합니다.hh는 두 자리 시간입니다.mm는 두 자리 분입니다.+hh:mm또는-hh:mm는 UTC 시간대입니다.
따라서 북미 중부 표준 시간대 (CST) 에서 2023년 9월 30일 오후 8시의 날짜는 2023-09-30T20:00:00-06:00 입니다.
날짜 및 시간을 스케줄할 때 현재 날짜 및 시간을 사용할 수 없습니다. 예를 들어, 6월 12일오전 8시인 경우 스케줄된 날짜 및 시간은 6월 12일오전 8시이후여야 합니다. deprecate-at 및 obsolete-at 날짜를 둘 다 정의하는 경우 obsolete-at 날짜는 deprecate-at 날짜 이후여야 합니다.
ibmcloud is image-update IMAGE [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]
deprecate-at 및 obsolete-at 날짜 및 시간 항목을 변경하려는 경우 이러한 명령을 다시 실행할 수 있습니다. 이전 날짜 및 시간은 새 날짜 및 시간으로 바뀝니다.
CLI를 사용하여 이전에 스케줄된 사용자 정의 이미지 라이프사이클 상태 변경 제거
--reset-deprecate-at 또는 --reset-obsolete-at 옵션을 사용하여 스케줄된 상태 변경을 제거할 수 있습니다. 이러한 옵션 중 하나를 ** 클라우드 is image-update** 명령과 함께 사용하는 경우, 날짜 및 시간이 이미지에서 제거됩니다. 해당 상태 변경에 대해 더 이상 이미지가 스케줄되지 않습니다.
ibmcloud is image-update IMAGE [--reset-deprecate-at] [--reset-obsolete-at]
--reset-deprecate-at 및 --reset-obsolete-at 옵션을 모두 사용하는 경우 이미지 상태는 available로 돌아갑니다.
API를 사용하여 사용자 정의 이미지 라이프사이클 상태 변경
API (Application Programming Interface) 를 사용하여 IBM Cloud VPC 사용자 정의 이미지의 라이프사이클 상태를 변경할 수 있습니다. 즉시 상태를 변경하거나 나중에 상태 변경이 발생하도록 스케줄할 수 있습니다.
즉시 상태를 변경하려면 다음 예제 중 하나를 사용하십시오. $image_id 변수의 경우 상태 변경을 위한 사용자 정의 이미지의 ID를 지정하십시오.
향후 상태 변경이 스케줄되지 않은 경우에만 즉시 상태 변경을 수행할 수 있습니다. 스케줄된 상태 변경을 제거하려면 API를 사용하여 스케줄된 사용자 정의 이미지 라이프사이클 상태 변경 제거 를 참조하십시오. 스케줄된 상태 변경을 제거한 후 즉시 상태 변경을 수행할 수 있습니다.
-
이미지 라이프사이클 상태를
deprecated으로 변경하십시오.curl -X POST "$vpc_api_endpoint/v1/images/$image_id/deprecate?version=2023-02-21&generation=2" -H “Authorization: Bearer $iam_token” -
이미지 라이프사이클 상태를
obsolete으로 변경하십시오.curl -X POST "$vpc_api_endpoint/v1/images/$image_id/obsolete?version=2023-12-21&generation=2" -H “Authorization: Bearer $iam_token”
상태 변경을 스케줄하려면 다음 예제 중 하나를 사용하십시오.
deprecation_at 또는 obsolescence_at 특성의 경우 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 날짜 및 시간 형식으로 날짜를 지정하십시오.
YYYY는 네 자리 연도입니다.MM는 두 자리 숫자의 월입니다.DD는 두 자리 일입니다.T는 날짜 및 시간 정보를 구분합니다.hh는 두 자리 시간입니다.mm는 두 자리 분입니다.+hh:mm또는-hh:mm는 UTC 시간대입니다.
따라서 북미 중부 표준 시간대 (CST) 에서 2023년 9월 30일 오후 8시의 날짜는 2023-09-30T20:00:00-06:00 입니다.
날짜 및 시간을 스케줄할 때 현재 날짜 및 시간을 사용할 수 없습니다. 예를 들어, 6월 12일오전 8시인 경우 스케줄된 날짜 및 시간은 6월 12일오전 8시이후여야 합니다. deprecation_at 및 obsolescence_at 날짜 및 시간을 모두 정의하는 경우 obsolescence_at 날짜는 deprecation_at 날짜
및 시간 이후여야 합니다.
-
deprecated에 대한 상태 변경을 스케줄하십시오.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": "2023-03-01T06:11:28+05:30" }' -
obsolete에 대한 상태 변경을 스케줄하십시오.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": "2023-12-31T06:11:28+05:30" }'deprecation_at및obsolescence_at날짜 및 시간 항목을 변경하려는 경우 이러한 명령을 다시 실행할 수 있습니다. 이전 날짜 및 시간이 새 날짜 및 시간으로 바뀝니다.
API를 사용하여 이전에 스케줄된 사용자 정의 이미지 라이프사이클 상태 제거
Make a PATCH /images request to remove any scheduled status change by updating deprecation_at or obsolescence_at to null. 이 특성 변경은 이미지에서 날짜 및 시간을 제거하며 해당 상태 변경에 대해 더 이상 이미지가 스케줄되지 않습니다.
-
이미지를
deprecated에서available로 변경하려면deprecation_at특성을null로 변경하십시오.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null }' -
obsolete에서 이전 상태로 이미지를 변경하려면obsolescence_at을null로 변경하십시오. 이전에deprecation_at에 대한null이외의 값이 이미지에 포함된 경우, 이 특성 변경은obsolete상태를 제거하고 이를 다시deprecated로 변경합니다. 이전 상태가available이고 이미지가available에서obsolete로 직접 이동된 경우 이 특성 변경은obsolete에서available로 이동합니다.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ “obsolescence_at": null }' -
deprecation_at또는obsolescence_at특성이 모두 다시available로 설정된 이미지를 변경하려면deprecation_at또는obsolescence_at특성을 모두 업데이트해야 합니다.curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=2022-11-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{ "deprecation_at": null, “obsolescence_at": null }'
Terraform을 사용하여 사용자 정의 이미지 수명 주기 상태 변경
Terraform을 사용하여 즉시 상태를 변경하려면, ibm_is_image_deprecate 또는 ibm_is_image_obsolete 리소스 명령. 다음 예제 중 하나를 사용하십시오. name 변수의 경우 상태 변경에 대한 사용자 정의 이미지의 이름을 지정하십시오.
향후 상태 변경이 스케줄되지 않은 경우에만 즉시 상태 변경을 수행할 수 있습니다. 스케줄된 상태 변경을 제거하려면 Terraform을 사용하여 스케줄된 사용자 정의 이미지 라이프사이클 상태 변경 제거 를 참조하십시오. 스케줄된 상태 변경을 제거한 후 즉시 상태 변경을 수행할 수 있습니다.
-
이미지 라이프사이클 상태를
deprecated으로 변경하십시오.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0=" encryption_key = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx" } resource "ibm_is_image_deprecate" "example" { image = ibm_is_image.example.id } -
이미지 라이프사이클 상태를
obsolete으로 변경하십시오.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" encrypted_data_key = "eJxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx0=" encryption_key = "crn:v1:bluemix:public:kms:us-south:a/6xxxxxxxxxxxxxxx:xxxxxxx-xxxx-xxxx-xxxxxxx:key:dxxxxxx-fxxx-4xxx-9xxx-7xxxxxxxx" } resource "ibm_is_image_obsolete" "example" { image = ibm_is_image.example.id }
상태 변경을 스케줄하려면 다음 예제 중 하나를 사용하십시오.
deprecation_at 또는 obsolescence_at 속성의 경우 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 날짜 및 시간 형식으로 날짜를 지정하십시오.
YYYY4자리 연도입니다MM두 자리 숫자로 된 월인가요?DD두 자리 숫자로 된 날짜는T는 날짜 및 시간 정보를 구분합니다.hh두 자리 시간mm두 자리 숫자로 표시된 분을 말합니다+hh:mm또는 UTC(-hh:mm)는 협정 세계시(Coordinated Universal Time) 시간대입니다
따라서 북미 중부 표준 시간대 (CST) 에서 2023년 9월 30일 오후 8시의 날짜는 2023-09-30T20:00:00-06:00 입니다.
날짜와 시간을 예약할 때는 현재 날짜와 시간을 사용할 수 없습니다. 예를 들어, 6월 12일오전 8시인 경우 스케줄된 날짜 및 시간은 6월 12일오전 8시이후여야 합니다. deprecation_at 및 obsolescence_at 날짜 및 시간을 모두 정의하는 경우 obsolescence_at 날짜는 deprecation_at 날짜 및
시간 이후여야 합니다.
-
deprecated로 상태 변경을 스케줄합,하할 수 있습니다.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" deprecation_at = "2023-11-28T15:10:00.000Z" } -
obsolete로 상태 변경을 스케줄합,하할 수 있습니다.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" obsolescence_at = "2023-11-28T15:10:00.000Z" }deprecation_at및obsolescence_at날짜 및 시간 항목을 변경하려는 경우, 이 명령을 다시 실행할 수 있습니다. 이전 날짜 및 시간이 새 날짜 및 시간으로 바뀝니다.
Terraform을 사용하여 이전에 예약된 사용자 정의 이미지 수명 주기 상태를 제거합니다
스케줄된 상태 변경을 제거하려면 deprecation_at 또는 obsolescence_at 속성을 null 로 업데이트하십시오. 이 속성 변경은 이미지에서 날짜 및 시간을 제거하며 이미지는 더 이상 해당 상태 변경에 대해 스케줄되지 않습니다.
-
이미지를
deprecated에서available로 변경하려면deprecation_at특성을null로 변경하십시오.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" deprecation_at = null } -
이미지를
obsolete에서 이전 상태로 변경하려면obsolescence_at를null로 변경하십시오. 이미지에 이전에deprecation_at에 대한null이외의 값이 포함된 경우 이 속성 변경은obsolete상태를 제거하고 다시deprecated로 변경합니다. 이전 상태가available인 경우 (이미지가available에서obsolete로 직접 이동되었음을 의미함) 이 속성 변경은obsolete에서available로 다시 이동합니다.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" obsolescence_at = null } -
deprecation_at또는obsolescence_at특성이 모두available로 다시 설정된 이미지를 변경하려면deprecation_at또는obsolescence_at속성을 모두 업데이트해야 합니다.resource "ibm_is_image" "example" { name = "example-image" href = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd" operating_system = "ubuntu-16-04-amd64" deprecation_at = null obsolescence_at = null }