Oracle Cloud Infrastructureドキュメント

サンプル: リソース・マネージャを使用したコンピュート・インスタンスの作成

このサンプルでは、Oracle リソース・マネージャを使用したOracle Cloud Infrastructure Computeインスタンスの作成およびデプロイに必要なタスクのエンド・ツー・エンドのウォークスルーを示します。 リソース・マネージャの概要は、「リソース・マネージャの概要」を参照してください。

警告

Oracle Cloud Infrastructureコンソール、APIまたはCLIを使用してクラウド・リソースに説明、タグまたはわかりやすい名前を割り当てるときは、機密情報を入力しないでください。

ハイライト

このウォークスルーでは、Oracle Cloud Infrastructure リソース・マネージャを使用してコンピュート・インスタンスを作成する方法を示すサンプルを提供します。 リソース・マネージャは、Terraformを使用して、Terraform構成で定義したリソースをプロビジョニングします。 リソースはスタックに編成され、スタックはジョブを使用して作成およびプロビジョニングします。

ウォークスルーには、次の4つの一般的なタスクが含まれます:

  • HashiCorpの構成言語(HCL)を使用して、Terraform構成を作成します。 詳細は、「構成構文」を参照してください。
  • インフラストラクチャをプロビジョニングするスタックを作成します。
  • 構成を解析し、Terraform実行計画を作成するスタックに対して計画ジョブを実行します。
  • 実行計画を使用してスタックをTerraform構成で定義したリソースにプロビジョニングする、適用ジョブを実行します。

始める前に

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

  • Oracle Cloud Infrastructureテナンシ
  • スタックを作成するコンパートメントのOracle Cloud ID (OCID)。
  • 次のものを含むユーザー・アカウント:
  • コンソールではなくOracle Cloud Infrastructure CLIを使用する場合は、インストールして構成する必要があります。 CLIの設定の詳細については、「クイックスタート」および「構成」を参照してください。

Terraform構成を作成

重要

このセクションは、コンソールまたはコマンド・ライン・インタフェース(CLI)のどちらを使用している場合でも適用されます。

Terraform構成は、Terraformプロバイダを定義する一連のファイルで、プロビジョニング、変数の宣言、およびリソースのプロビジョニングに関する特定の指示を指定します。 構成ファイルは.zipファイルにバンドルされ、リソース・マネージャにアップロードされます。 詳細は、「Terraform構成」を参照してください。

この例では、構成で複数の構成(.tf)ファイルを使用して、リソース・マネージャに転送し、次の一連の操作を実行します:

Oracle Cloud Infrastructure Providerの作成
変数の定義
仮想クラウド・ネットワーク(VCN)の作成
VCNでのサブネットの作成
インターネット・ゲートウェイを作成
コア・ルート表の作成
コンピュート・インスタンスを作成
構成の確定

インフラストラクチャの構築、デプロイおよびプロビジョニング

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

  1. 選択したコンパートメントにスタックを作成します。
  2. 構成に対して計画ジョブを実行します。 これによって「実行計画」が作成され、ジョブ・ログ・エントリのデプロイメントが段階的に表されます。
  3. 実行計画を確認して、意図的な内容が含まれていることを確認します。 変更が必要な場合、構成を修正してから、計画ジョブを再実行し、更新済の実行計画を取得します。
  4. 実行計画に対して適用ジョブを実行します。 これにより、作成したスタックが、構成で指定したリソースを使用してプロビジョニングされます。
  5. ジョブ・ログ・エントリは確認できます。 また、現在のデプロイメント状態を表すTerraform状態にもアクセスできます。

スタックの作成

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

コンソールを使用したスタックの作成
CLIを使用したスタックの作成
コンソールを使用した変数の作成、編集または削除

計画ジョブの実行

計画ジョブは構成を解析し、実行計画を作成しますが、スタックには影響しません。 計画ジョブが完了したら、ジョブ・ログ・エントリを表示して、予想される操作が実行されていることを確認し、意図された順序で実行計画を評価できます。

重要

プラン・ジョブの実行後に実行計画を更新するには、最初に構成を更新し、構成.zipファイルを再作成する必要があります。
その後、新規.zipファイルをアップロードし、計画ジョブを再実行します。

コンソールを使用した計画ジョブの実行
CLIを使用した計画ジョブの実行

適用ジョブの実行

実行計画に問題がなければ、定義済のリソースを使用してスタックをプロビジョニングする作業を実行できます。 適用ジョブは、実行計画を取得し、スタックに適用します。 結果は、完全にプロビジョニングされたスタックになります。

コンソールを使用した適用ジョブの実行
CLIを使用した適用ジョブの実行

レビュー状態

リソース構成の状態に関する基本情報は、JSONファイルである状態ファイルに保持されます。 状態ファイルはスタック・リソースを構成にマップし、リソース依存関係などの基本的な構成メタデータも維持します。 リソース・マネージャは、状態ファイルを自動的に生成および更新します。

リソース・マネージャは、特定のスタックで一度に1つのジョブのみを実行できるため、状態ロックをサポートしています。 状態ファイルの詳細は、「ハッシュ・アイコン: 州」を参照してください。

コンソールを使用した状態の確認
CLIを使用した状態の確認

ジョブの破棄について

必要に応じて、作成したスタックを分解し、破棄ジョブを実行して、そこに含まれるリソースをクリーン・アップできます。

コンソールを使用した破棄ジョブの実行
CLIを使用した破棄ジョブの実行