Terraformモジュールの構成

このソリューションに必要なすべてのコンピュート、ネットワークおよびストレージ・インフラストラクチャのリソースは、Terraformモジュール内に定義されています。

始める前に

Terraformモジュールの構成を開始する前に、次の手順を完了します。

  1. Terraformの基本を説明します。

    少なくとも、Terrraformのドキュメントの概要を参照してください

  2. 次の情報を準備しておきます。
    • テナンシのOCID。

      テナンシのOCIDは、Oracle Cloud Infrastructure Webコンソールにあります。「サービス」メニューから「管理」を選択し、テナント詳細をクリックします。

    • TerraformでOracle Cloud Infrastructureによる認証に使用するユーザーのOCID。

      ユーザーのOCIDを検索するには、サービス・メニューから「アイデンティティ」を選択し、「ユーザー」を選択します。リストでユーザー名を特定し、そのOCIDをコピーします。

    • リソースを作成するコンパートメントのOCID。

      区分のOCIDを検索するには、「サービス」メニューから「アイデンティティ」を選択し、「区分」を選択します。リストで必要なコンパートメントを探し、そのOCIDをコピーします。

    • リソースを作成するリージョンのID。

      たとえば、米国東部(Ashburn)地域のIDはus-ashburn-1です。

      リージョンおよび可用性ドメイン」を参照してください。

  3. 次を決定します。
  4. テナンシのサービス制限が、作成するすべてのリソースに対応できることを確認します。

Terraformコードのダウンロード

このソリューションのTerraformコードは、GitHubで入手できます。

  1. 左側にあるナビゲーション・ペインで、「コードのダウンロード」をクリックします。
  2. Gitリポジトリ」をクリックします。
  3. リポジトリをローカル・コンピュータにクローンまたはダウンロードします。

Terraformコードについて

ダウンロードしたTerraformコードの構造は次のとおりです。

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • _docsディレクトリ:アーキテクチャ図が含まれています。
  • *.tf:ソリューションで使用されるTerraform構成ファイル。これらのファイルは編集しないでください。
  • env-vars: Terraformの環境変数を設定するスクリプト。
  • LICENSE.md:コードのライセンス条件。
  • modules:このソリューションを使用して作成するリソースのコアTerraform構成が含まれるディレクトリ。編集しないでください。
  • orm: Terraformを使用してソリューションをデプロイするのではなく、Oracle Cloud Infrastructure Resource Managerでスタックを作成するために使用できるzipファイルを含みます。
  • README.md:コードのクイック・スタート・ドキュメント。
  • schema.yaml: Terraformコードで使用される変数に対する制約と検証。このファイルは、Oracle Resource Managerを使用してリソースをデプロイするときに使用されます。このファイルは編集しないでください。
  • terraform.tfvars: Terraform変数。このファイルの変数には、後で値を設定します。
  • userdata:作成後にコンピュート・インスタンスで実行されるスクリプトが含まれます。このディレクトリ内のファイルは編集しないでください。

Terraform環境変数の設定

Terraformコードには、特定のTerraformパラメータの値を環境変数として格納するために使用できるスクリプト・ファイルが含まれています。

  1. 前述の前提条件が完了していることを確認してください。
    始める前に」を参照してください。
  2. ローカル・コンピュータで、Terraformコードをダウンロードしたディレクトリに移動します。
  3. コードの最上位ディレクトリで、プレーンテキスト・エディタでenv-varsファイルを見つけて開きます。
  4. ファイル内の変数に適切な値を入力します。

    ノート:

    各変数で値を指定するときは、行をコメント解除する必要があります。つまり、行の先頭にある# (ハッシュ)文字を削除します。
  5. 指定した値を確認します。
    値を省略した場合は、Terraformの実行時に入力を求めるプロンプトが表示されます。誤った値を指定すると、Terraformでエラーが発生します。
  6. すべての値が正しいことを確認したら、ファイルを保存して閉じます。
  7. 次のコマンドを実行して、環境変数ファイルが格納されているディレクトリから次のコマンドを実行して、環境変数を設定します。
    source ./env-vars
  8. 次のコマンドを実行して、すべての環境変数の設定が完了していることを確認します。
    env | grep TF
    設定した環境変数が表示されます。

デプロイメント・パラメータの設定

作成するコンピュート、ネットワーク、データベース、およびストレージ・リソースと、それらのプロパティを指定します。

  1. 前述の前提条件が完了していることを確認してください。
    始める前に」を参照してください。
  2. ダウンロードまたはクローニングしたコードの最上位ディレクトリで、terraform.tfvarsファイルを探し、プレーン・テキスト・エディタで開きます。
  3. terraform.tfvarsにリストされた変数の値を設定します。
    ダウンロードしたコードのREADMEファイルには変数の説明が含まれ、完成したterraform.tfvarsファイルのサンプルが含まれています。
  4. terraform.tfvarsを保存して閉じます。