볼륨의 이미지 관리
볼륨에서 작성되는 사용자 정의 이미지는 원래 볼륨과 독립적입니다. 이미지를 업데이트하고 필요에 따라 삭제할 수 있습니다. 원래 볼륨을 삭제할 수 있으며 사용자 정의 이미지가 지속됩니다. 더 이상 사용되지 않도록 스케줄하고 콘솔, CLI 또는 API에서 이미지를 더 이상 사용하지 않도록 설정할 수 있습니다.
허용된 사용 표현식: 사용자 지정 이미지에 허용된 사용 표현식을 사용하여 이미지의 기능과 제한을 정의하고 서버를 만드는 동안 호환되는 이미지 및 프로필 조합을 찾을 수 있습니다. 볼륨에서 생성된 모든 사용자 지정 이미지의 허용된 사용 표현식 기본값은 원본 소스 볼륨의 허용된 사용 표현식입니다. 그러나 사용자 지정 이미지에서 이러한 허용된 사용 표현식을 편집할 수 있습니다. 자세한 내용은 사용자 지정 이미지에 허용된 사용 표현식 추가하기를 참조하세요.
사용자 정의 이미지의 라이프사이클 상태 변경을 UI를 사용하여 예약하기
단일 이미지 라이프사이클 상태 변경을 스케줄하거나 이미지의 전체 라이프사이클에 대한 상태 변경을 스케줄할 수 있습니다.
다음 단계를 사용하여 단일 상태 변경을 스케줄하십시오.
이미지에 대한 단일 상태 변경을 스케줄할 수 있습니다.
- 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 }'
성능 고려사항
볼륨의 이미지가 대기열에 등록되고 생성되는 속도는 이미지 크기나 대기열에 있는 작업 수 등 여러 요인의 영향을 받을 수 있습니다. 이미지가 예상 대기 시간보다 오래 걸리는 경우 작업을 취소할 수 있습니다.
이미지 작성 중의 성능
이미지를 생성할 때, API의 status_reasons 매개변수가 image_request_queued 를 가리키며, “이미지 요청이 수락되었으며 시스템 리소스가 사용 가능해질 때까지 대기 중”이라는 메시지가 표시됩니다. 이 메시지가 표시되면 작업을 시작하는 데 시간이 걸릴 수 있습니다. 다음 표에서는 이미지 크기를 기반으로 하는 몇 가지 가이드라인을 제공합니다.
in_progress 상태를 확인하여 이미지가 생성 중인지 확인하십시오. 이미지의 크기에 따라 이미지가 사용 가능하게 되는 데 시간이 걸릴 수 있습니다.
| 이미지 크기 | 이미지가 표시되기까지 예상 소요 시간 |
|---|---|
| 5GB | 5분 |
| 10GB | 10분 |
| 25GB | 25분 |
| 50GB | 50분 |
| 75GB | 1시간 15분 |
| 100GB | 1시간 40분 |
작업 시작 시간은 약 30초입니다. 이 시간은 큐의 트래픽을 반영하지 않으므로 예상 시간이 늘어날 수 있습니다. 대부분의 작업은 5 - 10분 내에 시작됩니다. 시간이 더 오래 걸리면 이미지 작성을 취소 하십시오.
작성을 위해 큐에 있는 이미지 취소
기본 작업이 아직 시작되지 않은 경우 이미지를 삭제하여 이미지 작성을 취소할 수 있습니다. 보류 중 상태인 이미지의 경우 GET /images API 호출 시 image_request_queued 이유 코드가 리턴됩니다. DELETE /image{image_id} 요청으로 보류 중인 이미지를 삭제할 수 있습니다. 또는 UI 또는 CLI 를 사용하여 보류 상태인 이미지를 삭제할 수 있습니다.
UI를 사용하여 사용자 정의 이미지 삭제하기
볼륨에서 생성된 이미지를 사용자 정의 이미지 목록에서 삭제할 수 있습니다. 보류 상태 (작성되는 동안) 및 사용 가능 상태에 있는 이미지를 삭제할 수 있습니다.
- 사용자 정의 이미지 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색
> VPC 인프라
> 컴퓨트 > 이미지를 차례로 선택합니다.
- 사용자 정의 이미지 탭에서 삭제할 이미지를 찾으십시오. 조치 메뉴
에서 삭제를 선택하십시오.
CLI를 사용하여 볼륨에서 이미지 삭제
-
이미지 목록에서 볼륨의 이미지 찾기
ibmcloud is images -
ID별로 이미지를 삭제하십시오.
ibmcloud is image-delete IMAGE_ID
API를 사용하여 볼륨에서 이미지 삭제
DELETE /images 요청을 작성하고 부트 볼륨에서 작성된 이미지의 ID를 지정하십시오.
-
볼륨에서 이미지의 ID를 찾으십시오.
curl -X GET "$vpc_api_endpoint/v1/images?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token" -
다음과 같이 ID별로 이미지를 삭제하십시오.
curl -X DELETE "$vpc_api_endpoint/v1/images/$image_id?version=2024-06-12&generation=2" -H "Authorization: Bearer $iam_token"
다음 단계
볼륨에서 이미지를 생성하는 전체 과정을 미리 살펴본 다음, 새 가상 서버 인스턴스를 생성할 때 해당 이미지를 사용할 수 있습니다. 자세한 정보는 볼륨 튜토리얼의 이미지 를 참조하십시오.