IBM Cloud Docs
Terraform テンプレートのオンボード

Terraform テンプレートのオンボード

このチュートリアルでは、Terraform テンプレートをアカウントにオンボードする方法について説明します。 このチュートリアルを完了すると、プライベート・カタログを作成してテンプレートをインポートする方法を学習できます。 その後、テンプレートがリソースを作成できること、またはスクリプトを実行できることを確認し、アカウントへのアクセス権限を持つユーザーがそのテンプレートを使用できるようにすることができます。

開始前に

  1. 従量課金 (PAYG) またはサブスクリプションのアカウントを使用していることを確認してください。 詳しくは、アカウント・タイプの表示を参照してください。

  2. 以下の役割が割り当てられていることを確認します。 詳しくは、アカウント管理サービスへのアクセス権限の割り当ておよびリソースに対するアクセス権限の管理を参照してください。

    • すべてのアカウント管理サービスおよびすべての IAM 対応サービスに対する管理者
    • カタログ管理サービスに対するエディター
    • IBM Cloud Schematics の管理者サービス・アクセス役割
    • VPC インフラストラクチャーに対するオペレーターのプラットフォーム役割
    • ソフトウェア・インスタンス・サービスに対するエディター
    • 特定のタスクを完了するために必要な権限
  3. Terraform テンプレートを作成します。

  4. Terraform テンプレートをテストするには、Terraform CLI から以下のコマンドを実行します。

    • terraform init
    • terraform validate
  5. Terraform テンプレートを GitHub リリースにアップロードし、.tgzファイルを作成します。 詳しくは、 Terraform テンプレートと README ファイルを GitHub リポジトリーにアップロードするを参照してください。

    この Terraform サンプルコードのリリースを、リポジトリの設定方法の例としてご利用ください。

プライベート・カタログの作成

プライベート・カタログを使用すると、独自の製品をアカウント内のユーザーに公開できます。

  1. IBM Cloud コンソールで 管理 > カタログ と移動し、 カタログの作成 をクリックします。
  2. カタログ・タイプとして**製品のデフォルト (Product default)**を選択します。
  3. カタログの名前を入力します (例: Sample Terraform)。
  4. 製品なしを選択し、IBM Cloud® カタログ内のすべての製品を、使用しているカタログから除外します。
  5. 「作成」 をクリックします。

Terraform テンプレートのインポート

  1. 「プライベート製品」ページで 追加 をクリックします。
  2. デプロイメント方式として Terraform を選択します。
  3. リポジトリーのタイプを選択します。
  4. ソース URL として Terraform URL の例を入力します。
  5. メジャー・バージョン、マイナー・バージョン、およびリビジョンの形式でソフトウェアのバージョンを入力します (例えば、1.0.0)。
  6. 製品の追加をクリックします。

バージョンの詳細の確認

「バージョンの構成」タブから、バージョンの詳細を確認できます。 バージョンの詳細を確認したら、次へをクリックします。

デプロイメント値を構成します。

バージョンの詳細を確認したら、デプロイメント値を構成することができます。

  1. Schematics で使用する Terraform ランタイムのバージョンを指定する必要がある場合は、デフォルトの Terraform ランタイム・バージョンのオーバーライド のチェック・ボックスをクリックし、バージョンを入力します。
  2. 「デプロイメントの詳細の構成」セクションで、デプロイメント値を追加 をクリックします。
  3. パラメーター チェック・ボックスを選択してすべてのオプションを選択し、 追加 をクリックします。
  4. ユーザーがインストール時に指定する必要があるパラメーターと、ユーザーに対して非表示にするパラメーターをカスタマイズするには、パラメーターを選択して編集をクリックします。 チェック・ボックスをクリックして値を構成し、保存をクリックします。

出力値の編集の説明

Terraform テンプレートの出力値の説明を改善して、ユーザーがパラメーターの目的を理解しやすくすることができます。 テンプレートに含める出力値の説明を更新することができます。

出力値を追加するには、それらを Terraform テンプレートの新しいインポート・バージョンに含める必要があります。

商品の出力値の説明を編集するには、以下のステップを実行します。

  1. バージョンの構成 > 次へ をクリックします。
  2. 「出力値の説明」セクションで、更新するパラメーターの新しい説明を指定します。
  3. 次へ をクリックします。

IAM アクセスの定義

デプロイメント値を構成した後、製品のインストールに必要なサービス・アクセス役割とプラットフォーム・アクセス役割を追加できます。

製品のアクセス権限を定義するには、以下の手順を使用します。

  1. バージョンの構成 > 次へ > 次へ をクリックします。
  2. 追加 をクリックします。
  3. サービスと、必要なサービスおよびプラットフォームのアクセス権限を選択します。
    • サービスアクセスロールは、サービスの使用とサービスAPIコールの実行のためのアクセスを許可します。
    • プラットフォーム・アクセス・ロールは、インスタンスの作成、インスタンスとアプリの接続、ユーザー・アクセスの割り当てなど、プラットフォーム・リソースに対して実行されるアクションを可能にします。
  4. 保存 をクリックします。

ライセンス要件の設定

ユーザーが IBM Cloud サービス契約以外の使用許諾契約書に同意する必要がある場合は、契約ごとに URL を指定します。 あるいは、ユーザーが独自のライセンスを持ち込める場合は、その URL を指定することもできます。

  1. 使用条件の追加>追加をクリックします。
  2. 名前と URL を入力して、 更新 をクリックします。
  3. 追加のご使用条件を入力したら、次へをクリックします。

Terraform テンプレートの検証

  1. 「製品の検証」タブで、ワークスペースの名前を入力し、リソース・グループを選択し、Schematics 領域を選択して、次へ をクリックします。

    タグ フィールドに、テンプレートに付加する特定のタグの名前を入力できます。 このタグは IBM Cloud Schematics ワークスペースに配置されます。 タグを使用すると、アカウントのリソースを編成したり、使用料金を追跡したり、リソースへのアクセスを管理したりできます。

  2. 「デプロイメント値」セクションで、パラメーター値を確認して、次へ をクリックします。

  3. 「製品の検証」セクションで、以下のご使用条件を読み、同意します を選択します。

  4. 検証 をクリックします。

    検証プロセスの進行状況をモニターするには、 ログを表示 をクリックします。

コンプライアンスの管理

プロファイルとコントロールをソフトウェアに追加して、セキュリティーとコンプライアンスの要件を満たしていることを証明することができます。 検証中に作成されたリソースをスキャンするには、 Security and Compliance Center を使用する必要があります。

Security and Compliance Center スキャンでサポートされ、 Security and Compliance Center スキャンで検証されたプロファイルとコントロールのみがカタログに表示されます。

Security and Compliance Center スキャンの実行

プロファイルとコントロールを要求する場合は、検証中に作成されたリソースを評価して、コンプライアンスを確認する必要があります。 スキャンを実行するには、以下の手順を完了する:

  1. IBM Cloud コンソールで、 Menu アイコン Menu アイコン > Security and Compliance をクリックし、 Security and Compliance Center にアクセスする。
  2. ナビゲーションで「 プロフィール 」をクリックします。
  3. 評価するプロファイルの行にある 「オーバーフロー」 メニューをクリックし、 「スキャンの実行」 を選択します。
  4. スキャンの実行をクリックします。

スキャンが完了したら、プライベート・カタログに戻ってオンボーディング・プロセスを続行できます。

コンプライアンス制御の追加

要求するプロファイルとコントロールを追加します。

  1. 製品の「コンプライアンスの管理」セクションで、 「クレームの追加」 を選択します。
  2. 追加したいプロファイルを選択します。
  3. プロファイル全体を追加するか、コントロールのサブセットを追加するかを選択します。
  4. プロファイル全体を選択する場合は、次のステップに進みます。 コントロールのサブセットを追加することを選択した場合は、追加するコントロールを選択します。
  5. 追加 をクリックします。

Security and Compliance Center スキャンの適用

以前に Security and Compliance Center. Security and Compliance Center スキャンで実行したスキャンを追加して、規制管理への準拠性を判別します。 詳しくは、 リソースのスキャン を参照してください。

  1. スキャンの追加 をクリックします。
  2. 評価に使用したプロファイルを選択します。
  3. Security and Compliance Center スキャンを選択します。
  4. 「スキャンの適用」 をクリックします。
  5. 次へ をクリックします。

要件の確認

アカウントに公開するには、検証およびその他の要件を完了する必要があります。

次のステップ

Terraform テンプレートをオンボードして検証すると、アカウントに公開する準備が整います。 アクション メニューから アカウントに公開 を選択します。 結果として、Terraform テンプレートは、アカウント内のSample Terraformプライベート・カタログにアクセスできるユーザーのみが使用できます。