AWS VM プロビジョニングのチュートリアル

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：15分

    • この例では、AWS データセンターで仮想マシンをプロビジョニングする際に機能する クラウドプロビジョニングとガバナンス のコンポーネントについて説明します。対象となるトピックには、詳細計画、リソースブロック、クラウド API (CAPI)、および MID サーバー スクリプトインクルードが含まれます。

    始める前に

    必要なロール：admin

    このタスクについて

    このチュートリアルは、ユーザーが既に AWS でプロビジョニングしている Windows VM から始まります。次に、VM、リソースブロック、およびリソースブロックから指定された CAPI 呼び出しを使用して、詳細計画について説明します。最後に、このチュートリアルでは、基本の MID サーバー スクリプトインクルードが AWS API に対して実際の呼び出しを行う方法を示します。

    この例では、インスタンスで利用可能なデフォルトのリソースブロックおよびスクリプトインクルードを使用します。そのため、インスタンスにプロビジョニングされた VM がない場合でも、以下の手順に従い、この例で使用されるコンポーネントを表示することで、コンポーネントの動作を理解できます。

    Azure での VM の例については、「Azure VM プロビジョニングのチュートリアル」を参照してください。

    注:
    この例では、仮想マシン、VM、および仮想サーバーという用語を同じ意味で使用します。

    手順

    1. クラウドユーザーポータルでプロビジョニングされた VM を参照し、VM に関する詳細情報の一部に注目します。
      1. インスタンスで、 クラウドユーザーポータル (クラウドプロビジョニングとガバナンス クラウドユーザーポータル) を開きます。
      2. [スタック] をクリックし、スタックの名前をクリックして、この Windows VM など、スタック内のプロビジョニングされた VM を表示します。

        この例では、スタックの名前は MyStack です。

        MyStack の例

      3. [リソース] で、スタック内の VM をクリックします。

        仮想サーバーの例

      4. VM のプロパティを表示し、それが AWS データセンターのリージョン us-east-1 にあることに注目してください。

        VM の詳細

    2. VM の基となる詳細計画を参照します。
      1. 移動先 デザイン > 詳細計画をクリックし、Azure データセンターの仮想サーバーを使用して詳細計画を開きます。デフォルトで [ 展開モデル ] タブが表示され、詳細計画のさまざまなコンポーネントが表示されます。

        この詳細計画の例には、コンテナー、仮想サーバー (プロビジョニングされている実際の VM)、および AWS データセンターという 3 つのコンポーネントがあります。

        Windows サーバーを使用した詳細設計の例

      2. 下部の [操作] タブをクリックし、[プロビジョニング] をクリックします。

        プロビジョニング操作

        プロビジョニング操作は、システムが VM を作成したときにトリガーした操作です。その他のデフォルト操作を利用できますが、この例ではプロビジョニング操作に焦点を当てています。

      3. 詳細計画コンテナーリソースの [プロビジョン] ブロックをクリックします。

        自分の Azure VM 詳細計画コンテナー

      4. 右側にある [入力] リスト内のパラメータの 1 つが [場所] です。
        このパラメーターは値 eastus を保持しています。これは、データセンター内で VM の存在している場所です。

        [場所] パラメーター

        [入力] は、この例に示すようにコンテナー上で指定することも、その他の任意のリソースブロック上で指定することもできます。デフォルトでは、[Location] パラメーターは詳細計画コンテナリソースブロックで既に指定されているため、このような詳細計画のそれぞれで使用できます。詳細計画を [ドラフト] に切り替えた場合、詳細計画コンテナーリソースブロックにパラメーターを追加できます。仮想サーバーリソースブロックにパラメーターを追加することはできません。このウォークスルーでは、追加パラメーターは必要ありません。

    3. この詳細計画で使用する仮想サーバーおよび AWS データセンターリソースブロックを確認します。
      1. クラウドアドミンポータルで、 デザイン > リソースブロック.
      2. デフォルトで クラウドプロビジョニングとガバナンス に提供されている [仮想サーバー] リソースブロックを検索して開きます。

        デフォルトの仮想サーバーリソースブロック

      3. [リソースブロック] フォームで、[ホストリソース] 関連リストをクリックし、サポートされているホストリソースブロックのリストを表示します。
      4. 既に指定されているホストインターフェイスおよびホストリソースに注意してください。

        仮想サーバー上のホストインターフェイス

        • [ホストインターフェイス] フィールドでは、この仮想マシンをホストするリソースブロックのゲストインターフェイスと一致する必要があるインターフェイスを指定します。この場合、ホストインターフェイスは [Compute Interface] です。これは、AWS データセンターリソースブロックのゲストインターフェイスでもあります。デフォルトでは、仮想ストレージなどの他のリソースブロックがデータセンターへの接続に使用できるように、データセンターリソースブロックは複数のゲストインターフェイスを提供します。
        • [ホストリソース] 関連リストの [hostresource] 列には既に [AWS データセンター] が指定されています。これは、AWS データセンターのリソースブロックがこの VM の有効なホストであることを意味します。
      5. [操作] タブをクリックし、[ステップ] サブタブをクリックします。

        [ステップ] サブタブの選択

      6. [操作] リストから [プロビジョン] を選択します。

        プロビジョニング操作

        プロビジョニング操作は、システムが VM を作成するために使用した操作です。その他のデフォルト操作を利用できますが、この例ではプロビジョニング操作に焦点を当てています。

      7. リストに表示されるステップと、入力パラメーターの上に表示されるステップの説明全体に注目してください。

        プロビジョニングのステップ

        • [ホストリソース操作: (Host Resource Operation:)] は、このステップがホストリソース (この例では AWS データセンター) に操作を呼び出すことを示します。
        • [Compute Interface] は、このステップで使用している AWS データセンターのゲストインターフェイスです。
        • [ConnectAndCreateVirtualMachine] は、このステップで呼び出す AWS データセンター内の操作です。
        注:
        この場合、このステップは別のリソースブロック (AWS データセンター) から操作を呼び出します。また、ステップは CAPI を直接呼び出し、その後 CAPI がクラウドプロバイダー API に対する REST 呼び出しを実行できます。AWS データセンターのリソースブロックを見ると、そのことがわかります。
      8. に戻る デザイン > リソースブロック.
      9. 仮想サーバーが接続しているホストリソースブロックである AWS データセンターのリソースブロックを開きます。
      10. [ゲストインターフェイス] 関連リストで、サポートされているゲストインターフェイスに注目してください。

        AWS データセンターのゲストインターフェイス

        これらのゲストインターフェイスは、AWS データセンターが他のリソースブロックで使用できるようにするインターフェイスです。[Compute Interface] は、ホストインターフェイスとして Compute Interface を指定する仮想サーバーリソースブロックがデータセンターに接続できるように提供されています。

      11. [操作] タブをクリックし、[ステップ] サブタブをクリックします。

        [ステップ] サブタブの選択

      12. [インターフェイス] リストで、[Compute Interface] が選択されていない場合は選択します。

        Compute Interface

        このインターフェイスは、仮想サーバーリソースブロックで指定されていることを忘れないでください。

      13. [操作] リストで、ConnectAndCreateVirtualMachine を検索して選択します。

        ConnectAndCreateVM 操作

        この操作は、仮想サーバーリソースブロックで指定されていることを忘れないでください。

      14. ConnectAndCreateVirtualMachine 操作の唯一のステップで使用される CAPI 呼び出しに注意してください。

        CreateNode API 呼び出し

        • [クラウド API:] は、このステップが CAPI を呼び出し、その結果、CAPI がクラウドプロバイダー (この場合は AWS) に対する REST 呼び出しを実行できることを示します。
        • [Compute Interface] は、このステップが呼び出す CAPI インターフェイスを指定します。
        • [CreateNode] は実行されるメソッドを示します。名前が示すように、このメソッドは、仮想マシンを作成するように AWS に指示します。
      15. ドラフト状況のリソースブロックで、ハイライト表示された (青い) ステップをポイントし、[ステップの編集] アイコンをクリックしてステップ設定を開きます。
        ステップの編集
      16. ステップ設定を確認し、CAPI と統合する設定を確認します。

        ステップ設定\

        フィールド 説明
        操作タイプ [クラウド API の呼び出し (Invoke Cloud API)] は、このステップが、所定のプロバイダー、インターフェイス、およびメソッドを介して CAPI を呼び出す必要があることを指定します。
        API プロバイダー [AWS Elastic Compute Cloud] は、CAPI で定義されている AWS プロバイダーに属する (実際のプロバイダーではない) 製品です。
        API インターフェイス [Compute Interface] は、CAPI に定義されている AWS プロバイダーに属する製品です。
        API メソッド [CreateNode] は、AWS を呼び出して VM を作成するメソッドです。
        注:
        CAPI API 定義は、プロバイダー (AWS)、製品 (AWS Elastic Compute Cloud)、インターフェイス (Compute Interface)、およびメソッド (CreateNode) を結び付けます。
      17. ウィンドウを閉じます。
      18. [Compute Interface.CreateNode] ステップが選択されている状態で [応答プロセッサー] タブをクリックし、[Create_Virtual_Server_Response_Processor] スクリプトを確認します。

        [応答プロセッサー] タブ

        このスクリプトは、AWS に仮想マシンが作成された後に、インスタンスで CMDB を更新する応答プロセッサーです。

      19. 「応答プロセッサーの作成」のトピックに含まれている、このスクリプトの説明と例を参照してください。
        そのトピックの確認が完了したら、このトピックに戻ります。
    4. VM をプロビジョニングするために連携して動作する CAPI コンポーネントを確認します。
      1. クラウドアドミンポータル で デザイン > クラウド API.
      2. [API] タブをクリックします。
      3. 開いている AWS Compute API を検索します。

        2 つの AWS Compute API レコードがあります。次の手順で、画像と一致するリストで最初のレコードを開きます。

      4. この CAPI API がインターフェイスと製品をどのように結び付けているかを確認します。

        AWS Compute API

        フィールド 説明
        クラウド API インターフェイス [Compute Interface] は、リソースブロックで指定されているインターフェイスと同じです。このインターフェイスには、CreateNode メソッドを含むメソッドの定義が含まれています。
        コネクター [クラウドコンピューティングコネクター (Cloud Compute Connector)] は、この CAPI がシステムに対して Java 呼び出しを行い、この Java が続いて AWS API を呼び出すことを示します。このコネクターはスクリプト化されていません。仮にこれがスクリプト化されたコネクターであれば、AWS API を呼び出す MID サーバー スクリプトインクルードが含まれています。
        注:
        デフォルトで クラウドプロビジョニングとガバナンス アプリケーションで提供されている AWS 関連の API のほとんどは、これと同様にスクリプト化されておらず、変更できません。ただし、独自のスクリプト API を作成できます。
        バージョン [1.0] は API のバージョンを示します。この API の複数のバージョンを異なるバージョン番号で使用できます。VM を作成する AWS データセンターリソースブロックのステップでは、[バージョン] フィールドが表示されることに留意してください。この例では、この API のバージョンが 1 つしかないため空白でしたが、別のバージョン番号を指定できます。
        製品 [AWS Elastic Compute Cloud] は、CAPI の AWS プロバイダーに属する製品です。この製品は、デフォルトで クラウドプロビジョニングとガバナンス が備えられており、AWS で VM を作成するために最も一般的に使用される製品の 1 つです。
      5. [CAPI メソッドマッパー] 関連リストで、CreateNode レコードのレコードプレビューアイコンをクリックし、[レコードを開く] をクリックします。

        Open CreateNode メソッドマッパー

      6. CreateNode メソッドマッパーを確認します。

        CreateNode のメソッドマッパーフォーム

        エンドポイント操作が [スクリプトを実行] ではないことに注意してください。この値は、CreateNode メソッドがインスタンス上の クラウドプロビジョニングとガバナンス アプリケーション内で Java 呼び出しを使用して AWS API に REST 呼び出しを行っていることを示します。したがって、CreateNode メソッドの動作を変更することはできません。値が [スクリプトを実行] の場合、[要求] スクリプトフィールドで指定された MID サーバー スクリプトインクルードが表示されます。このスクリプトインクルードを変更するか新しいものを指定して、AWS プロバイダーに対する REST 呼び出しをカスタマイズすることができます。

      7. 下にスクロールして、[CAPI パラメーターマッパー] 関連リストのパラメーターを確認します。
        [場所] などの重要なパラメーターが表示されていることに注意してください。
      8. AWS Compute API フォームに戻ります。
      9. [API 設定の上書き] 関連リストをクリックし、認証に必要な項目を確認します。
        設定パラメーターと上書き値 説明

        AccountAliasName

        $(CloudCredential.Alias)

        		 アカウントエイリアスは、AWS アカウントで作成できるオプションの値です。これは、アカウント ID のセカンダリ名です。詳細については、「AWS のドキュメント」を参照してください。

        認証情報

        $(CloudCredential.secret_key)

        		 秘密キーは、アクセスキーとともに認証用に使用されます。この値は、セットアップ中に AWS 認証情報レコードで設定しました。この手順を参照するには、「永続的な AWS 認証情報を使用した AWS アカウントへのアクセス構成」を参照してください。

        エンドポイント

        $(CloudCredential.URL)

        		 エンドポイントは、ユーザーがログインして認証する必要がある URL です。アカウント ID またはアカウントエイリアスが使用されます。詳細については、「AWS のドキュメント」を参照してください。

        ID

        $(CloudCredential.access_key)

        		 識別レコードには、AWS が認証に必要とする AWS アクセスキーが保持されます。
      10. に戻る デザイン > クラウド APIをクリックし、[ インターフェイス ] タブをクリックします。
      11. Compute Interface を Search して開きます。
        このインターフェイスは、リソース ブロックと AWS Compute API CAPI API で指定されたインターフェイスです。
      12. インターフェイスの内容を確認します。

        このインターフェイスでは、CreateNode などのメソッドに対して REST 応答構造を使用していることに注意してください。通常、既存のインターフェイスを変更する必要はありません。CreateNode 応答構造のハイライト表示

        サービスカテゴリと操作に注意してください。
        フィールドまたは関連リスト 説明
        サービスカテゴリ サービスカテゴリは、インターフェイスを分類します。Compute Interface のカテゴリーも Compute です。
        CAPI インターフェイス操作 インターフェイス操作は、REST 呼び出しの JSON 構造と、インターフェイスに必要なパラメーターを定義します。
      13. CreateNode CAPI インターフェイス操作をクリックします。
        この操作は、AWS で EC2 仮想サーバーを作成するためのフレームワークを提供する操作です。
      14. 操作のコンポーネントを確認します。
        フィールドまたは関連リスト 説明
        応答構造

        この応答構造は、REST API 呼び出しの JSON フレームワークになります。このフィールドには、AWS が空の値を持つ仮想リソースを作成するために使用できる属性のリストが用意されています。
        インターフェイス操作パラメーター

        これらのパラメーターは、REST 呼び出しでクラウドプロバイダーに渡すことができるように、CAPI インターフェイスがシステムから必要とするパラメーターでもあります。

        CreateNode 操作

      15. に戻る デザイン > クラウド APIをクリックし、[ プロバイダー ] タブをクリックします。
      16. AWS プロバイダーを開きます。

        AWS クラウドプロバイダーフォームが開き、このプロバイダーが既存の CMDB クラス (AWS データセンター [cmdb_ci_aws_datacenter]) に基づいていることを示します。

        AWS プロバイダー

      17. 未選択の場合は [クラウド製品] 関連リストをクリックし、[名前] 列でリストを並べ替えます。

        いくつかの AWS 製品がデフォルトで利用できることに注意してください。最も一般的に使用される AWS 製品の 1 つが Elastic Compute Cloud (EC2) です。

        Amazon EC2

      18. [名前] 列で [AWS Elastic Compute Cloud] をクリックします。
        製品は多くのリソースタイプを指定しており、それぞれが CI クラスにマップされていることに注意してください。

        AWS 製品

        これらのリソースタイプは、仮想マシンに関連する一部の CI を示し、すべてではありません。AWS が VM をプロビジョニングするときに、リソースブロック内の応答プロセッサーによって CI にデータが入力されます。

    5. VM に関連する重要な CI を確認するには、次の手順を実行します。
      1. クラウドユーザーポータル で、[スタック] をクリックし、VM を含むスタックを開きます。
      2. [依存関係の表示 (View Dependency)] アイコンをクリックします。

        依存関係の表示

        依存関係マップでは、スタック CI が上部に、VM が中央に、関連するさまざまな CI (イメージなど) が下部に表示されます。

        スタック内の VM の依存関係マップ

      3. CMDB で VM のフォームを表示するには、VM など、任意の CI の横にある矢印を右クリックします。

        VM CI の表示

      4. メニューの [フォームを表示] をクリックします。

        CI フォームの表示

        CI フォームが開き、VM のプロパティを表示するときに クラウドユーザーポータル でどれだけの情報が既に利用可能かが示されます

        クラウドユーザーポータル の VM プロパティ

        VM フォーム

        VM の詳細