ブート・イメージのインポート


IBM Power Virtual Server で IBM データセンター

IBM Power Virtual Server プライベートクラウド で クライアント・ロケーション


IBM が提供する標準イメージの代わりに、 IBM® Power® Virtual Server のユーザーインターフェース、CLI、またはAPIを使用して、 IBM Cloud Object Storage (COS)バケットからカスタムOSイメージをインポートすることができます。 ブートイメージをインポートした後、そのイメージを使用して Power Virtual Server の仮想サーバーインスタンス(VSI)を作成できます。

ブートイメージをインポートする際は、そのイメージのストレージ階層とストレージプールを選択します。 Power Virtual Server は、インポート時に指定したストレージプール内に、インポートされたブートイメージからブートボリュームを作成します。 イメージをインポートした後は、ストレージ階層やストレージプールを変更することはできません。 VSIには、複数のストレージタイプに属するディスクを含めることができます。 Power Virtual Server のすべてのデータセンターは、Tier 0、Tier 1、Tier 3、および固定IOPsのストレージタイプに対応しています。

ブートイメージのインポートおよびエクスポートは、長時間かかる非同期操作です。 Power Virtual Server は、 アカウント内のすべてのワークスペースにわたってこれらの操作を監視します。 ワークスペースでは、一度に実行できるインポートまたはエクスポート操作は1つだけです。 現在の操作が完了するまでは、そのワークスペースで別の操作を開始することはできません。

開始前に

ブートイメージをインポートする前に、以下の前提条件を満たしていることを確認してください:

  • ブートイメージファイルを IBM Cloud Object Storage のバケットにアップロードしてください。 対応しているファイル形式は、 .ova、 .ova.gz、 .tar、 .tar.gz、および .tgz です。 詳細については、「 データを保存するためのバケットを作成する 」を参照してください。

  • COSインスタンス用のハッシュベースメッセージ認証コード(HMAC)認証情報を生成します。 詳しくは、HMAC 資格情報の使用を参照してください。

  • Power Virtual Server のワークスペースを作成するか、既存のワークスペースを使用します。

Power Virtual Server のユーザーインターフェースを使用してブートイメージをインポートする

Power Virtual Server のユーザーインターフェースを使用してブートイメージをインポートするには、以下の手順を実行してください:

  1. IBM の認証情報を使用して、 IBM Cloud カタログにログインしてください。

  2. 検索ボックスに Power Virtual Server と入力し、 Power Virtual Server タイルをクリックします。

  3. ナビゲーションパネルの「 ワークスペース 」をクリックします。 既存のワークスペースの一覧が表示された「ワークスペース」ページが表示されます。

  4. ブートイメージをインポートするワークスペースを選択してください。 選択したワークスペースの「仮想サーバーインスタンス」ページが表示されます。

  5. ナビゲーションパネルの「 ブートイメージ 」をクリックし、「 イメージのインポート 」をクリックします。 「ブートイメージのインポート」パネルが表示されます。

  6. 「ブートイメージのインポート」パネルで、「 ソース 」セクションにおいて、以下の手順を実行してください

    1. [イメージ OS] ドロップダウンリストからイメージ OS を選択してください。

      SAP HANA または SAP NetWeaver のイメージ OS を選択する場合は、自己認証のチェックボックスにチェックを入れる必要があります。

    2. [ リージョン ] ドロップダウンリストから、COS バケットが格納されているリージョンを選択してください。

    3. 「 画像ファイル名 」フィールドに、画像のファイル名を入力してください。 イメージ・ファイル名にスペースを含めることはできません。

      サポートされているファイル名の拡張子は、 .ova、 .ova.gz、 .tar、 .tar.gz、および .tgz です。 gzip を使用すると、画像ファイルを圧縮することができます。 例: Aix_7200-03-02-1846_cldrdy_112018.ova.gz。

    4. 「バケット名」フィールドにバケットの名前を入力してください。 画像ファイルがバケット内のサブフォルダに保存されている場合は、 bucketName/optional/folders という形式で完全なパスを指定してください。

      バケット名を特定するには、[ ナビゲーションメニュー ] > [リソース一覧 ] > [ストレージ] の順に選択し、 Cloud Object Storage のインスタンス名をクリックしてください。 バケットは「 バケット 」タブに一覧表示されています。

    5. COSサービスの認証情報から「 access_key_id 」の値をコピーし、 HMACアクセスキーのフィールドに貼り付けてください。

      サービスの認証情報を確認するには、 [ナビゲーションメニュー] > [リソース一覧] > [ストレージ ] の順に選択し、 Cloud Object Storage のインスタンス名をクリックしてから、 [サービスの認証情報 ] > [認証情報を表示] の順に選択します。

    6. COSサービスの認証情報から「 secret_access_key 」の値をコピーし、 HMACシークレットアクセスキーのフィールドに貼り付けてください。

    7. 「 チェックサムファイルによるインポートの検証」を 「 オン 」に設定し、インポートされたファイルをチェックサムファイルと照合して検証します。 チェックサムファイルとブートイメージファイルは、同じCOSバケットに保存する必要があります。

      ブートイメージファイルを IBM Cloud Object Storage バケットにエクスポートする際に、チェックサムファイルを生成できます。 チェックサムファイルの名前は、ブートイメージファイルの名前に基づいており、ファイル拡張子として「 .sha256 」が使用されます。

      独自のブートイメージを作成する場合は、チェックサムファイルを作成し、それをブートイメージと同じバケットに保存することができます。 shasum -a 256 <filename> または sha256sum <filename> コマンドを実行することで、チェックサムファイルを生成できます。

      チェックサムファイルの作成に関する詳細については、 「 Power Virtual Server 」のユーザーインターフェースを使用した VM の取得およびエクスポートを 参照してください。

      インポートファイルとチェックサムファイルとの照合を行うと、インポートにかかる時間が長くなる可能性があります。

  7. 次へ をクリックします。

  8. 「 宛先 」セクションに以下の情報を入力してください:

    1. [ カスタムイメージ名] フィールドに、インポートするブートイメージの名前を入力してください。

    2. オプション:「 ユーザータグ」 フィールドに、このブートイメージを整理または分類するためのタグを入力します。

      ユーザータグは、そのアカウント内のすべてのユーザーに表示されます。 タグ名には機密情報を含めないでください。

    3. [ Tier ] フィールドで、以下のストレージタイプの中からいずれかを選択してください:

      • ティア 0 (25 IOPs / GiB )
      • ティア 1 (10 IOPs / GiB )
      • ティア 3 (3 IOPs / GiB )
      • 固定IOP(5000 IOP)

      VSIでは、Tier 1とTier 3のストレージタイプを同時に使用することはできません。 詳しくは、ストレージのティアを参照してください。

    4. [ ストレージプール ] フィールドで、ストレージプールのオプションを選択します。

      Power Virtual Server 「 自動選択 」、「 アフィニティ 」、「 アンチアフィニティ 」のいずれかのオプションに基づいて、1つ以上のカスタム画像ストレージボリュームをストレージプールに配置します。 このイメージを使用して展開する VSI のブートボリュームは、すべて同じストレージプール内に作成されます。 ストレージボリュームの詳細については、「 ストレージボリュームの追加と管理 」を参照してください。

      以下のストレージプールオプションが利用可能です:

      • 自動選択 :十分な容量を持つストレージプール内に、ストレージボリュームを自動的に作成します。

      • アフィニティ : アカウント既存のVSIまたはストレージボリュームに基づいて、ブートボリューム用のストレージプールを特定します。 Power Virtual Server は、カスタムイメージのストレージボリュームを、アフィニティオブジェクトが存在するストレージプール内に保存します。 アフィニティ・オブジェクトが VSI の場合、 Power Virtual Server は、その VSI のブート・ボリュームに基づいてストレージ・プールを決定します。

      • アンチアフィニティ :除外したい1つ以上のストレージプールを指定します。 Power Virtual Server は、ブートボリュームの配置を行う際、除外されたストレージプールを考慮しません。 除外するプールは、 アカウント内の既存のVSIまたはストレージボリュームに基づいて特定されます。 このオプションを選択すると、 Power Virtual Server は、カスタムイメージストレージボリュームを作成する際、アンチアフィニティオブジェクトが存在するストレージプールを除外します。 VSIをアンチアフィニティ・オブジェクトとして使用する場合、 Power Virtual Server は各VSIのブートボリュームに基づいてストレージプールを除外します。

  9. 「 画像をインポート 」をクリックします。

    ブートイメージのサイズが大きい場合、インポートに時間がかかることがあります。 確認メッセージを受け取るまでに待ち時間が発生することがあります。

新しいブートイメージは、「 ブートイメージ 」ページに掲載されています。

Power Virtual Server CLI を使用したブートイメージのインポート

ブートイメージをインポートするには、 ibmcloud pi image import コマンドを実行します。 インポートが完了したことを確認するには、 ibmcloud pi image list コマンドを実行してください。

--import-details 「BYOL(Bring-Your-Own-License)」の SAP HANA または SAP NetWeaver イメージを使用している場合は、 ibmcloud pi image import コマンドに オプションを追加し、そのイメージを SAP 認定として識別してください。

Power Virtual Server API を使用したブートイメージのインポート

API を使用して IBM Cloud Object Storage からブートイメージをインポートするには、「 cos-image インポートジョブの作成 」メソッドを使用し、リクエスト本文に必須のプロパティ( imageName、 imageFilename、 bucketName )を指定します。 プライベートバケットの場合は、 accessKey および secretKey を指定する必要があります。これらは、お使いの COS インスタンスの HMAC アクセスキーおよびシークレットキーです。 詳しくは、HMAC 資格情報の使用を参照してください。

curl -X POST \
  https://us-east.power-iaas.cloud.ibm.com/pcloud/v1/cloud-instances/$CLOUD_INSTANCE_ID/cos-images \
  -H "Authorization: Bearer $TOKEN" \
  -H "CRN: $CRN" \
  -H "Content-Type: application/json" \
  -d '{
    "imageName": "my-image-name",
    "imageFilename": "my-os-image-file.ova.gz",
    "bucketName": "my-cos-bucket-name",
    "region": "us-east",
    "accessKey": "my-cos-access-key",
    "secretKey": "my-cos-secret-key",
    "storageType": "tier3"
  }'

「BYOL(Bring-Your-Own-License)」方式の SAP HANA または SAP NetWeaver イメージを使用している場合は、そのイメージが SAP 認定済みであることを識別するために、リクエスト本文に importDetails オブジェクトを含めてください:

"importDetails": {
   "licenseType": "byol",
   "product": "Hana",
   "vendor": "SAP"
}

ブートイメージのインポート結果の表示

ブートイメージのインポートを開始すると、「 ブートイメージ 」ページの「 ステータス 」列にインポートの進行状況が表示されます。 詳細を確認するには、「 詳細を表示 」をクリックして「実行中のジョブのステータス」ダイアログを開いてください。 ダイアログには、以下の情報が表示されます:

  • ジョブ ID
  • 操作タイプ
  • 入力リソース
  • 作成時刻
  • 完了した手順

CLI を使用してブートイメージのインポートジョブの詳細を表示するには、 ibmcloud pi image import-show コマンドを使用します。

API を使用してブートイメージのインポートジョブの詳細を表示するには、「 最後の cos-image インポートジョブの詳細を取得 」メソッドを使用してください。

ブートイメージを Cloud Object Storage

インポートしたブートイメージをダウンロードするには、以下の手順に従ってください:

  1. IBM Cloud のダッシュボードで、「 リソース一覧 」に移動し、該当する Cloud Object Storage インスタンスをクリックします。

  2. ブートイメージを保存したフォルダ内で、ブートイメージファイルをクリックします。

  3. [ オブジェクトのダウンロード ] をクリックします。

Cloud Object Storage のCLIコマンドに関する詳細については、「 オブジェクトのダウンロード 」を参照してください。