UI를 사용하여 사용자 정의 이미지 가져오기

IBM Cloud Object Storage에서 사용할 수 있는 이미지가 있는 경우 IBM Cloud VPC 콘솔을 사용하여 이를 IBM Cloud 인프라로 가져올 수 있습니다.

1. 호환 가능한 사용자 정의 이미지가 IBM Cloud Object Storage에서 사용 가능한지 확인하십시오. 이미지를 IBM Cloud Object Storage에 업로드하려면 버킷의 오브젝트 페이지에서 업로드를 클릭하십시오. 200MB가 넘는 이미지를 업로드하려면 Aspera 고속 전송 플러그인을 사용할 수 있습니다. 자세한 정보는 Linux 사용자 정의 이미지 작성, Windows 사용자 정의 이미지 작성, BYOL(Bring Your Own License) 및 IBM Cloud Object Storage에 데이터 업로드를 참조하십시오.
2. IBM Cloud 콘솔에서 메뉴 아이콘 > VPC 인프라 > 계산 > 이미지로 이동하십시오.
3. 사용자 정의 이미지 탭에서 작성을 클릭하십시오.
4. 표 1에 설명된 입력란을 모두 작성한 후 ‘사용자 지정 이미지 만들기’를 클릭하십시오.

CLI를 사용하여 사용자 정의 이미지 가져오기

호환 가능한 사용자 정의 이미지가 IBM Cloud Object Storage에서 사용 가능한지 확인하십시오. 자세한 내용은 Linux 사용자 지정 이미지 만들기, Windows 사용자 지정 이미지 만들기, 일반 운영 체제 사용자 지정 이미지 만들기, 자체 라이선스 가져오기 및 IBM Cloud Object Storage 에 데이터 업로드하기를 참조하세요. 허용된 사용 표현식을 포함하려면 사용자 지정 이미지에 허용된 사용 표현식 추가하기를 참조하세요.

IBM Cloud Object Storage 에서 이미지를 사용할 수 있는 경우 명령줄 인터페이스(CLI)를 사용하여 IBM Cloud VPC 인프라로 이미지를 가져올 수 있습니다.

CLI를 사용하여 사용자 정의 이미지를 가져오려면 ibmcloud is image-create 명령을 사용하십시오. IMAGE_NAME 변수를 사용하여 사용자 지정 이미지의 이름을 지정합니다. 리젼의 다른 이미지에서 이름을 사용할 수 없으며 ibm- 로 시작하는 이름은 시스템 제공 이미지용으로 예약되어 있습니다. 소스를 지정해야 합니다(예: 이미지 파일 위치와 함께 --file 옵션을 지정). 이미지의 운영 체제 이름과 함께 --os-name 옵션을 지정하십시오.

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME]

다음 예제에서는 이름이 my-ubuntu-16-amd64 인 사용자 정의 이미지를 작성합니다. 이미지 소스 위치는 cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 입니다. 운영 체제는 ubuntu-16-amd64 입니다.

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64

자세한 내용은 VPC CLI 참조 페이지의 [ibmcloud is image-create](/docs/vpc?topic=vpc-vpc-reference#image-create) 항목을 참조하십시오.

ibmcloud is image-create IMAGE_NAME [--file IMAGE_FILE_LOCATION] [--os-name OPERATING_SYSTEM_NAME] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --deprecate-at 2023-03-01T06:11:28+05:30 --obsolete-at 2023-12-31T06:11:28+05:30

API를 사용하여 사용자 정의 이미지 가져오기

호환 가능한 사용자 정의 이미지가 IBM Cloud Object Storage에서 사용 가능한지 확인하십시오. 자세한 내용은 Linux 사용자 지정 이미지 만들기, Windows 사용자 지정 이미지 만들기, 일반 운영 체제 사용자 지정 이미지 만들기, 자체 라이선스 가져오기 및 IBM Cloud Object Storage 에 데이터 업로드하기를 참조하세요. 허용된 사용 표현식을 포함하려면 사용자 지정 이미지에 허용된 사용 표현식 추가하기를 참조하세요.

IBM Cloud Object Storage에서 사용 가능한 이미지가 있는 경우 API (Application Programming Interface) 를 사용하여 IBM Cloud VPC 인프라로 가져올 수 있습니다.

API를 사용하여 사용자 정의 이미지를 가져오려면 이미지 작성 을 사용하십시오.

name 은 리젼의 다른 이미지에서 사용할 수 없으며 ibm- 로 시작하는 이름은 시스템 제공 이미지용으로 예약되어 있습니다. 이미지의 위치와 함께 file.href 하위 특성을 지정하십시오. 이미지 운영 체제의 이름으로 operating_system.name 하위 특성을 지정하십시오.

일반 운영 체제 사용자 지정 이미지는 베타 기능이며 평가 및 테스트 목적으로 사용할 수 있습니다. 일반 운영 체제에는 Generic 의 family 가 있습니다. 운영 체제를 올바르게 부팅하고 초기화하는 데 필요한 allow_user_image_creation 값이 true 이고 user_data_format 인 항목을 선택해야 합니다. 자세한 정보는 사용자 데이터 형식 고려사항 을 참조하십시오.

다음 예제는 이름이 my-image 이고 소스 위치가 cos://us-south/my-bucket/my-image.qcow2 이며 이미지의 운영 체제가 debian-9-amd64 인 사용자 정의 이미지를 가져옵니다.

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      }
    }'

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      },
      "deprecation_at": "2023-03-01T06:11:28+05:30",
      "obsolescence_at": "2023-12-31T06:11:28+05:30"
    }'

Terraform을 사용하여 사용자 지정 이미지 가져오기

Terraform을 사용하려면 Terraform CLI를 다운로드하고 IBM Cloud 제공자 플러그인을 구성하십시오. 자세한 내용은 테라폼 시작하기를 참조하세요.

호환 가능한 사용자 정의 이미지가 IBM Cloud Object Storage에서 사용 가능한지 확인하십시오. 자세한 내용은 Linux 사용자 지정 이미지 만들기, Windows 사용자 지정 이미지 만들기, 일반 운영 체제 사용자 지정 이미지 만들기, 자체 라이선스 가져오기 및 IBM Cloud Object Storage 에 데이터 업로드하기를 참조하세요. 허용된 사용 표현식을 포함하려면 사용자 지정 이미지에 허용된 사용 표현식 추가하기를 참조하세요.

IBM Cloud Object Storage 에 이미지가 준비되어 있다면, Terraform을 사용하여 해당 이미지를 IBM Cloud VPC 인프라로 가져올 수 있습니다.

테라폼을 사용하여 사용자 지정 이미지를 가져오려면 테라폼 리소스 명령 ibm_is_image를 사용하세요.

name 값을 사용하여 생성할 사용자 지정 이미지의 이름을 지정합니다. 리젼의 다른 이미지에서 이름을 사용할 수 없으며 ibm- 로 시작하는 이름은 시스템 제공 이미지용으로 예약되어 있습니다. 또한 소스를 지정해야 합니다(예: 이미지 파일 위치와 함께 href 값을 지정). 이미지의 운영 체제 이름과 함께 operating_system 값을 지정합니다.

resource "ibm_is_image" "example" {
  name               = "my-image"
  href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
  operating_system   = "ubuntu-16-04-amd64"
}

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

Terraform을 사용하여 사용자 정의 이미지를 가져올 때 Terraform 리소스 명령 ibm_is_image를 사용하여 IBM Cloud VPC 사용자 정의 이미지의 라이프사이클 상태 변경을 동시에 스케줄링할 수도 있습니다.

name 속성은 리젼의 다른 이미지에서 사용할 수 없으며 ibm- 로 시작하는 이름은 시스템 제공 이미지용으로 예약되어 있습니다.

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) 시간대입니다.

따라서 북미 중부 표준 시간대 (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 날짜 및 시간 이후여야 합니다.

다음 예제는 이름이 example-image 이고 소스 위치가 cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd 이며 이미지의 운영 체제가 ubuntu-16-04-amd64 인 사용자 정의 이미지를 가져옵니다. 이미지는 2023-11-28T15:10:00.000Z 에서 더 이상 사용되지 않도록 스케줄되어 있습니다. 이미지는 2023-11-28T15:10:00.000Z 에서 더 이상 사용되지 않도록 스케줄되어 있습니다.

• 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"
    deprecated_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"
  }
  

UI를 사용하여 가져온 사용자 정의 이미지 유효성 검증

사용자 정의 이미지를 가져온 후에는, 해당 이미지가 IBM Cloud VPC 로 가져올 때 생성된 체크섬을 확인할 수 있습니다.

이미지를 가져오기 전에 로컬에서 해당 이미지의 체크섬을 생성해 두면, 두 체크섬을 비교하여 둘이 동일한지 확인할 수 있습니다. 일치하는 체크섬은 이미지가 변경되지 않았음을 나타냅니다.

1. IBM Cloud 콘솔에서 메뉴 아이콘 > VPC 인프라 > 계산 > 이미지로 이동하십시오.
2. '사용자 지정 이미지' 탭에서 사용자 지정 이미지 목록 중 유효성을 확인하려는 사용자 지정 이미지의 이름을 클릭합니다.
3. 이미지 세부 정보 사이드 패널에서 ‘체크섬( SHA256 ) ’ 필드를 찾으세요. 다음과 비슷한 콘텐츠가 표시됩니다. 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7.

z/OS ( Wazi aaS ) 전용 커스텀 이미지의 경우: Wazi Image Builder 에서 배포된 커스텀 이미지의 체크섬을 검증할 수 없습니다.

4. 체크섬(SHA256) 값을 로컬로 이미지에 대한 체크섬을 계산할 때 생성되는 출력과 비교하십시오.

   • Linux 명령 예: sha256sum ubuntu_image.qcow2
   • Mac 명령 예: shasum -a 256 ubuntu_image.qcow2
   • 다음과 유사한 출력이 표시됩니다: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

5. 이 이미지를 사용하여 가상 서버 인스턴스 또는 베어메탈 서버를 작성하십시오. 자세한 정보는 가상 서버 인스턴스 작성 또는 VPC에서 Bare Metal Servers 을 참조하십시오.

CLI를 사용하여 가져온 사용자 정의 이미지 유효성 검증

사용자 정의 이미지를 가져온 후에는, 해당 이미지가 IBM Cloud VPC 로 가져올 때 생성된 체크섬을 확인할 수 있습니다.

이미지를 가져오기 전에 로컬에서 해당 이미지의 체크섬을 생성해 두면, 두 체크섬을 비교하여 둘이 동일한지 확인할 수 있습니다. 일치하는 체크섬은 이미지가 변경되지 않았음을 나타냅니다.

CLI를 사용하여 가져온 사용자 정의 이미지의 유효성을 검증하려면 ibmcloud is image 명령을 사용하십시오.

먼저, 유효성 검증하려는 가져온 사용자 정의 이미지의 세부사항을 보십시오. IMAGE 변수를 사용하여 작성할 사용자 정의 이미지의 이름 또는 ID를 지정하십시오.

ibmcloud is image IMAGE

자세한 내용은 VPC CLI 참조 페이지의 ‘ibmcloud is image’ 항목을 참조하십시오.

다음 예제에서는 ID가 r006-1d1e92e9-6550-4d06-8483-d674310045fd 인 사용자 정의 이미지의 세부사항을 봅니다.

ibmcloud is image r006-1d1e92e9-6550-4d06-8483-d674310045fd

Getting image r006-1d1e92e9-6550-4d06-8483-d674310045fd under account Rios IMSLess as user gbgrout@ibm.com...
ID                             r006-589548bd-9241-4ad7-a610-1df6ba020793
Name                           my-image-from-volume-cli-1
CRN                            crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-589548bd-9241-4ad7-a610-1df6ba020793
Status                         available
Operating system               Name             Architecture   Vendor   Version                 Dedicated host only
                               centos-7-amd64   amd64          CentOS   7.x - Minimal Install   false
Source volume                  ID                                          Name
                               r006-6438d80f-4433-4445-be2f-0cca05afff3e   transpose-clubhouse-putt-repent
Created                        2023-03-16T01:11:03+05:30
Deprecation Date               2023-03-01T06:11:28+05:30
Obsolescence Date              2023-12-31T06:11:28+05:30
Visibility                     private
Minimum provisioned size(GB)   250
SHA256 Checksum                774d44ac0d55f2bfe869b995565715e5d9970ec23ce7127b2e2776b2618a9f7c
File size(GB)                  2
Encryption                     none
Resource group                 11caaa983d9c4beb82690daab08717e9
Resource type                  image
Catalog Offering Managed       false

반환된 체크섬( SHA256 ) 값을, 로컬에서 이미지의 체크섬을 계산했을 때 생성된 결과와 비교해 보십시오.

• Linux 명령 예: sha256sum ubuntu_image.qcow2
• Mac 명령 예: shasum -a 256 ubuntu_image.qcow2
• 다음과 유사한 출력이 표시됩니다: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

체크섬 (SHA256) 의 유효성을 검증한 후 이미지를 사용하여 가상 서버를 작성하십시오. CLI를 사용하여 가상 서버 인스턴스 작성 을 참조하십시오.

API를 사용하여 가져온 사용자 정의 이미지 유효성 검증

사용자 정의 이미지를 가져온 후에는, 해당 이미지가 IBM Cloud VPC 로 가져올 때 생성된 체크섬을 확인할 수 있습니다.

이미지를 가져오기 전에 로컬에서 해당 이미지의 체크섬을 생성해 두면, 두 체크섬을 비교하여 둘이 동일한지 확인할 수 있습니다. 일치하는 체크섬은 이미지가 변경되지 않았음을 나타냅니다.

API를 사용하여 사용자 정의 이미지로 유효성을 검증하려면 모든 이미지 나열 을 사용하십시오.

$image_id 에 대해 유효성 검증할 사용자 정의 이미지의 ID를 지정하십시오.

curl -X GET "$vpc_api_endpoint/v1/images/$image_id/?version=2023-02-21&generation=2" -H "Authorization: Bearer $iam_token"

반환된 체크섬( SHA256 ) 값을, 로컬에서 이미지의 체크섬을 계산했을 때 생성된 결과와 비교해 보십시오.

• Linux 명령 예: sha256sum ubuntu_image.qcow2
• Mac 명령 예: shasum -a 256 ubuntu_image.qcow2
• 다음과 유사한 출력이 표시됩니다: 6809606da67eb83670e6249e54e94043eb43c0471669fb96ea4050c4c07e2df7

체크섬 (SHA256) 의 유효성을 검증한 후 이미지를 사용하여 가상 서버를 작성하십시오. API를 사용하여 가상 서버 인스턴스 작성 을 참조하십시오.