開始

このウォークスルーでは、コンピュート・インスタンスを作成するための事前構築済のTerraform構成を提供するだけでなく、Terraform構成の記述方法を示すサンプルも提供します。使用する構成(事前作成済または独自の構成)にかかわらず、Resource ManagerはTerraformを使用して、定義されたリソースをプロビジョニングします。リソースは、ジョブを使用して作成およびプロビジョニングされるスタックに編成されます。

この手順では、次のタスクについて説明します:

• Terraform構成を選択または作成します。
• インフラストラクチャをプロビジョニングします:
  • インフラストラクチャをプロビジョニングするスタックを作成します。
  • スタックに対する計画ジョブを実行して、構成を解析し、実行計画を作成します。
  • 生成された実行計画を確認します。
  • スタックに対する適用ジョブを実行して、リソースをプロビジョニングします。適用ジョブは、Terraformの構成に基づく実行計画に従います。
  • 結果のインフラストラクチャを確認します。
• オプションで、同じTerraform構成を使用して、より多くの環境でインフラストラクチャをプロビジョニングします。

前提条件をインストール、取得または作成したことを確認してください:

• リソースをプロビジョニングする環境ごとに、Oracle Cloud Infrastructureテナンシ。たとえば、Terraform構成に定義されているリソースを開発、ステージングおよび本番環境にプロビジョニングできます。
  ノート
  
  各環境を独自のテナンシに配置することをお薦めします。
• スタックを作成するコンパートメントのOCID 。
• 次を含むユーザー・アカウント:
  • API署名キー。ガイダンスは、必要なキーとOCIDを参照してください。
  • 必要なIAM権限詳細は、IAMポリシーの概要およびリソース・マネージャの詳細を参照してください。
• Oracle Cloud Infrastructure CLIを使用する場合は、最初にCLIをインストールして構成します。クイックスタートおよびCLIの構成を参照してください

独自の構成を記述するかわりに、事前構築されたTerraform構成でコンピュート・インスタンステンプレートを選択できます。これらのステップでは、スタック作成プロセスを順を追って説明します。

1. 次のリンクを選択して、コンピュート・インスタンス・テンプレートがすでに選択されている状態でスタックの作成ページを起動します。

   コンピュート・インスタンス・テンプレートを使用したスタックの起動

2. 「スタックの作成」ページで、新しいスタックの名前を入力します(または、表示されたデフォルトの名前を受け入れます)。機密情報を入力しないでください。

3. 「コンパートメントに作成」ドロップダウンから、スタックを作成するコンパートメントを選択します。

   リスト範囲のコンパートメントはデフォルトで設定されています。

4. 「次」を選択します。

   「変数の構成」パネルに、Terraform構成の変数が表示されます。

5. 変数を確認し、必要に応じて変更します。

   重要
   
   秘密キーやその他の機密情報は、構成変数に追加しないでください。
6. 「次」を選択します。
7. 「確認」パネルで、スタック構成を確認します。

   このウォークスルーでは、「適用の実行」を空白のままにします。(スタックの作成時にインフラストラクチャを自動的にプロビジョニングするには、このオプションを使用します。)

8. 「作成」を選択してスタックを作成します。

   新しいスタックの詳細ページが表示されます。

   完了しました。コンピュート・インスタンス・テンプレートから事前構築されたTerraform構成のスタックが作成されました。次のステップは、インフラストラクチャのプロビジョニングです。

事前構築済のTerraform構成を選択しなかった場合は、次のステップに従って独自の構成を記述します。

Terraform構成は、インフラストラクチャを調整するファイルです。この構成により、Terraformプロバイダ、プロビジョニングしようとしているリソース、変数、およびリソースのプロビジョニングに関する特定の指示が定義されます。

このページでは、事前作成されたTerraform構成でコンピュート・インスタンス・テンプレートを選択するか、.zipファイル内の複数の.tfファイルを使用して独自の構成を記述します。

リソース・マネージャで使用する構成の作成の詳細は、リソース・マネージャのTerraform構成およびTerraform言語ドキュメンテーションを参照してください。

Terraform構成を使用して、次のアクションを実行してインフラストラクチャを構築およびデプロイします:

1. 独自のTerraform構成を作成した場合は、次のステップに従って、選択したテナンシ・コンパートメントにスタックを作成します。(事前作成構成を選択した場合は、このステップをスキップします。)

   Resource ManagerでサポートされているTerraform構成ソースについては、Terraform構成の格納場所を参照してください。

   スタックとは、グループとして操作できるリソースの集合です。構成内に指定したすべてのリソースは、作成したスタック内にプロビジョニングされます。

   スタックは、ソース・コード制御システム(Gitなど)、オブジェクト・ストレージ・バケット、またはアップロードしたローカルでアクセスできる.zipファイルから作成できます。ローカルファイルの手順は次のとおりです。

   .zipファイル(コンソール)からスタックを作成するには
   .zipファイル(CLI)からスタックを作成するには

2. 実行計画を生成します。

   計画ジョブは、構成を解析して「実行計画」を作成します。これは、ジョブのログ・エントリにおける計画済のデプロイメントを段階的に表したものです。計画ジョブが完了したら、ジョブのログ・エントリを表示して、想定された操作を実行していることを確認し、目的の順序で実行計画を評価できます。

   ノート
   
   スタックを作成したときに「適用の実行」を選択した場合は、このステップをスキップできます。この場合、リソースはすでにプロビジョニングされています。
   計画ジョブを実行するには(コンソール)
   計画ジョブを実行するには(CLI)

3. 実行計画を確認し、意図していることを確認します。

   実行計画は、以前に実行した計画ジョブのログに示されます。

   ノート
   
   スタックを作成したときに「適用の実行」を選択した場合は、このステップをスキップできます。この場合、リソースはすでにプロビジョニングされています。
   実行計画(計画ジョブのログ)を確認するには(コンソール)
   実行計画(計画ジョブのログ)を確認するには(CLI)

4. 実行計画に対して適用ジョブを実行して、リソースをプロビジョニングします。

   実行計画が完了したら、定義したリソースをスタックにプロビジョニングする作業を実行できます。適用ジョブは実行計画を取得し、それをスタックに「適用」します。結果は、完全にプロビジョニングされたスタックです。

   ノート
   
   スタックを作成したときに「適用の実行」を選択した場合は、このステップをスキップできます。この場合、リソースはすでにプロビジョニングされています。
   適用ジョブを実行するには(コンソール)
   適用ジョブを実行するには(CLI)
5. 実行した適用ジョブのログ・エントリと状態ファイルを確認します。

   • ジョブの詳細は、ジョブ・ログのエントリを参照してください。

     ジョブ・ログを表示するには(コンソール)
     ジョブ・ログを表示するには(CLI)

   • ジョブ状態ファイルは、ジョブのJSON形式の出力を表します。

     状態ファイルは、スタックのリソースを構成にマップし、リソースの依存関係などの必須の構成メタデータも保持します。リソース・マネージャはジョブの実行時に状態ファイルを自動的に生成および更新します。

     リソース・マネージャは、特定のスタック上で一度に1つのジョブのみを実行できるようにすることで状態のロックをサポートします。状態ファイルの詳細は、「状態」を参照してください。

     ジョブの状態を表示するには(コンソール)
     ジョブの状態を表示するには(CLI)
     ノート
     
     Terraformによってすでに管理されているリソースの状態ファイルをインポートすることもできます。

6. プロビジョニングされたリソースを解放する必要があるときには、スタック上で破棄ジョブを実行します。

   破棄ジョブは、作成したスタックを分解してから、関連付けられたリソースを削除せずにクリーンアップします。たとえば、破棄ジョブはスタックに関連付けられたコンピュート・インスタンスを終了します。

   ノート
   
   

   スタックを削除して関連リソースを解放する前に、破棄ジョブを実行することをお薦めします。スタックを削除すると、関連する状態ファイルも削除されるため、関連するリソースの状態のトラッキングが失われます。削除されたスタックに関連付けられているリソースのクリーンアップは、特にそれらのリソースが複数のコンパートメントにまたがる場合、状態ファイルなしでは困難になる可能性があります。後で困難なクリーンアップを回避するために、破棄ジョブを実行して関連付けられたリソースを最初に解放することをお薦めします。

   破棄されたリソースからデータをリカバリすることはできません。

   破棄ジョブを実行するには(コンソール)
   破棄ジョブを実行するには(CLI)

この項では、複数の環境でインフラストラクチャを構築およびデプロイする方法について説明します。

このシナリオでは、同じTerraform構成.zipファイルを使用して、開発、ステージングおよび本番環境にコンピュート・インスタンスをプロビジョニングします。

1. Terraform構成に定義されているインフラストラクチャをプロビジョニングする新しい環境のテナンシにアクセスします。

   たとえば、ステージング環境または本番環境のテナンシにアクセスします。

2. 「スタックの作成」ページを開きます:
   1. ナビゲーション・メニューを開き、「開発者サービス」を選択します。「リソース・マネージャ」で、「スタック」を選択します。

   2. 「リスト範囲」で、作業する権限があるコンパートメントを選択します。ページが更新されて、そのコンパートメントのリソースのみが表示されます。使用するコンパートメントが不明な場合は、管理者に問い合せてください。

   3. 「スタックの作成」を選択します。

3. 最初の環境と同じTerraform構成を使用して、「スタック情報」タブに入力します:

   1. 「スタックの作成」ページで、「自分の構成」を選択します。

   2. 「スタック構成」で、「.Zipファイル」を選択し、Terraform構成を追加します。

      Terraform構成の.zipファイルをコントロールにドラッグ・アンド・ドロップするか、「参照」を選択して.zipファイルの場所に移動できます。

   3. 新しいスタックの名前を入力します(または、表示されたデフォルトの名前を受け入れます)。機密情報を入力しないでください。
   4. 必要に応じて、「説明」を入力します。

   5. 「コンパートメントに作成」ドロップダウンから、スタックを作成するコンパートメントを選択します。

   6. 「次」を選択します。

      「変数の構成」パネルに、選択したTerraform構成ファイルの変数が表示されます。

4. この環境の変数値を指定します。

   1. 「変数の構成」パネルで、変数を確認し、必要に応じて変更します。

      デフォルト値は、スキーマ・ドキュメントで指定された場合に指定されます。

      重要
      
      秘密キーやその他の機密情報は、構成変数に追加しないでください。
   2. 「次」を選択します。
5. 「確認」パネルで、スタック構成を確認します。
6. スタックの作成時にリソースを自動的にプロビジョニングするには、「適用の実行」を選択します。

7. 「作成」を選択してスタックを作成します。

   新しいスタックの詳細ページが表示されます。

   「適用の実行」を選択した場合、リソース・マネージャは新しいスタックで適用アクションを実行します。

Terraform構成を再利用して、新しい環境にスタックを作成しました。「適用の実行」を選択した場合は、新しい環境でリソースもプロビジョニングしました。

実行計画を生成してレビューできるようになりました(「適用の実行」が選択されていない場合は、リソースをプロビジョニングします)。これらの項目を完了するには、新しい環境でタスク2: インフラストラクチャのプロビジョニングのステップを繰り返します。