시작하기 전에

1. 다음 CLI 플러그인을 다운로드, 설치 및 초기화했는지 확인하십시오.

   • IBM Cloud CLI
   • 인프라 서비스 플러그인

   자세한 정보는 CLI 참조를 참조하십시오.

2. IBM Cloud VPC를 작성했는지 확인하십시오.

인스턴스에 연결된 부팅 볼륨에서 이미지를 생성합니다

1. 이미지를 작성할 인스턴스를 찾으려면 지역에서 인스턴스를 나열 하십시오. 명령 출력의 인스턴스 ID를 기록해 두십시오.

   ibmcloud is instances
   

2. 볼륨에서 이미지를 작성하기 전에 실행 중인 인스턴스를 중지 하십시오.

   ibmcloud is instance-stop INSTANCE_ID
   

3. image-create 명령 을 실행하여 부트 볼륨의 이미지를 작성하십시오. 소스 볼륨의 ID를 지정하십시오.

   ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID]
   

   다음 예를 참조하십시오.

   $ ibmcloud is image-create test-ifv-vol1 --source-volume ecc68c2f-96a1-4862-bc86-14f47e5d9ed8
   Creating image test-ifv-vol1 in resource group  under account Test Account as user test.user@ibm.com...
   ID                 5b2fd4ee-c636-44c4-9673-453fca36832e
   Name               test-ifv-vol1
   CRN                crn:v1:bluemix:public:is:us-south:a/a123456::image:5b2fd4ee-c636-44c4-9673-453fca36832e
   Status             pending
   Status reason      Code                   Message                                                More info
                      image_request_queued   The image request is accepted and waiting for system   -
                                             resources to become available.
   Operating system   Name             Architecture   Vendor   Version                 Dedicated host only
                      centos-8-amd64   amd64          CentOS   8.x - Minimal Install   false
   Source volume      ID                                     Name
                      ecc68c2f-96a1-4862-bc86-14f47e5d9ed8   aa-1-bx-boot-1617035447000
   Created            2021-05-20T09:43:16+08:00
   Visibility         private
   File size(GB)      -
   Encryption         none
   Resource group     f22cf48f-8836-4527-9131-1d7c73ba85e9
   

CLI를 사용하여 사용자 정의 이미지 라이프사이클 상태 변경 스케줄

사용자 지정 이미지를 만들 때 ibmcloud is image-create 명령의 --deprecate-at 또는 --obsolete-at 옵션을 사용하여 IBM Cloud VPC 사용자 지정 이미지의 수명 주기 상태 변경을 동시에 예약할 수도 있습니다.

deprecate-at 또는 obsolete-at 특성을 스케줄하려면 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 날짜 및 시간 형식으로 날짜를 지정하십시오.

• YYYY 는 4자리 연도입니다.
• MM 두 자리 숫자로 된 월입니다.
• DD 는 두 자리 수의 날짜입니다.
• T 는 날짜 및 시간 정보를 구분합니다.
• hh 는 두 자리 시간입니다.
• mm 두 자리 숫자로 표시된 분입니다.
• +hh:mm 또는 -hh:mm 는 협정 세계시 (UTC) 시간대입니다.

예를 들어 북미 중부 표준시(CST) 기준 2025년 9월 30일 오후 8:00의 날짜는 다음과 같습니다 2025-09-30T20:00:00-06:00

날짜와 시간을 예약할 때는 현재 날짜와 시간을 사용할 수 없습니다. 예정된 날짜와 시간은 미래의 날짜와 시간이어야 합니다. deprecate-at 및 obsolete-at 날짜 및 시간을 모두 정의하는 경우 deprecate-at 날짜는 obsolete-at 날짜 및 시간 이후여야 합니다.

ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

시작하기 전에

시작하기 전에 API 환경을 설정하십시오.

API를 사용하여 인스턴스의 부트에서 이미지 작성

1. 이미지를 작성할 인스턴스 및 부트 볼륨을 찾으십시오. list instance 메소드를 사용하여 사용 가능한 인스턴스 목록을 가져오십시오.

   curl -X GET "$vpc_api_endpoint/v1/instances?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

2. 인스턴스 ID를 기록하고 이를 사용하여 인스턴스 세부사항을 검색 하십시오.

   curl -X GET "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

   응답에는 volume_attachments 섹션에 있는 부트 볼륨의 이름, ID및 기타 세부사항이 포함되어 있습니다.

   "volume_attachments": [
    {
     "device": {
       "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
       },
     "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
     "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
     "name": "my-boot-volume-attachment",
     "volume": {
       "crn": "crn:[...]",
       "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "name": "my-boot-volume"
       }
     }
   ]
   

3. 인스턴스가 실행 중인 경우 POST /instances 호출에서 stop 조치를 지정하여 인스턴스를 중지하십시오.

   curl -X POST \
   "$vpc_api_endpoint/v1/instances/{instance-id}/gen/actions?ersion=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"\
   -d '{"type":"stop"}'
   

4. 부트 볼륨 ID를 사용하여 이미지를 작성 하십시오. 다음 예를 참조하십시오.

    curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
    -H "Authorization: Bearer $iam_token"
    -d '{
         "name": "my-image",
         "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
         }`
   

   예시 응답에서 source_volume 는 이미지 생성에 사용되는 부팅 볼륨을 나타냅니다. 또한, 사용된 소스 볼륨이 기본값인 ‘ IBM ’ 관리형 암호화를 사용했기 때문에 이미지 암호화 상태가 ‘ none ’로 표시된다는 점에 유의하십시오. 자신의 루트 키를 사용하는 경우 응답에 user-managed 대신 이 표시됩니다.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "my-boot-volume"
      }
    }
   

볼륨에서 이미지 생성 및 사용자 지정 암호화 키 지정

1. 이전 절에서 설명한 대로 인스턴스 및 부트 볼륨 정보를 찾으십시오. 인스턴스를 중지하십시오.

2. 키 관리 서비스 인스턴스 ID및 루트 키 CRN을 가져오십시오.

   • Key Protect-인스턴스 ID및 클라우드 리소스 이름(CRN)검색.

3. 이미지 작성 에 대한 API 요청을 작성하십시오. 다음 예와 같이 볼륨 ID와 루트 키의 CRN을 지정합니다.

   curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"
       -d '{
            "name": "my-encrypted-image",
            "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
            "encryption_key":{"crn":"crn:[...key:...]"
           },
   

   이 응답에는 루트 키에 대한 정보가 포함되어 있습니다.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption_key": {
      "crn": "crn:[...key:...]"
      },
    "encryption": "user_managed",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "ifv-boot-vol"
      }
    }
   

API를 사용하여 사용자 정의 이미지 라이프사이클 상태 변경 스케줄링

볼륨에서 이미지를 만들 때 사용자 지정 이미지의 수명 주기 상태 변경을 동시에 예약할 수 있습니다.

deprecation_at 또는 obsolescence_at 특성을 스케줄하려면 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 날짜 및 시간 형식으로 날짜를 지정하십시오.

• YYYY 4자리 연도입니다
• MM 두 자리 숫자로 된 월인가요?
• DD 두 자리 숫자로 된 날짜는
• T 는 날짜 및 시간 정보를 구분합니다.
• hh 는 두 자리 시간입니다.
• mm 두 자리 숫자로 표시된 분을 말합니다
• +hh:mm 또는 -hh:mm 는 협정 세계시 (UTC) 시간대입니다.

예를 들어, 2023년 9월 30일 오후 8:00(북미 중부 표준시(CST) 기준)의 날짜는 다음과 같습니다 2023-09-30T20:00:00-06:00

날짜와 시간을 예약할 때는 현재 날짜와 시간을 사용할 수 없습니다. 예정된 날짜와 시간은 미래의 날짜와 시간이어야 합니다. deprecation_at 및 obsolescence_at 날짜 및 시간을 모두 정의하는 경우 obsolescence_at 날짜는 deprecation_at 날짜 및 시간 이후여야 합니다.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
      "name": "test-ifv-boot-volume",
      "source_volume": {
    	  "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"
      },
      "deprecation_at": "2025-11-28T06:11:28+05:30",
      "obsolescence_at": "2025-12-28T06:11:28+05:30"
    }'