Direct Link 用の Terraform のセットアップ

Terraform on IBM Cloud® は、予測可能で一貫性のある IBM Cloud サービスの作成を可能にし、Infrastructure as Code ( IaC ) の原則に従った複雑な多階層のクラウド環境を迅速に構築することができる。 IBM Cloud CLI や API、SDK を使用するのと同様に、 HashiCorp Configuration Language (HCL) を使用して、 Direct Link インスタンスの作成、更新、削除を自動化できます。

管理対象の Terraform on IBM Cloud® ソリューションをお探しですか? IBM Cloud® Schematics をお試しください。 Schematics を使用すれば、慣れ親しんだ Terraform スクリプト言語を利用できます。 Terraformコマンドラインや IBM Cloud® プロバイダープラグインの設定・保守について心配する必要はありません。 Schematics では、 IBM Cloud® カタログから簡単にインストールできる事前定義済みのTerraformテンプレートも提供しています。

Terraformのインストールと Direct Link

Terraformを使用して承認を作成する前に、以下の項目を完了していることを確認してください：

  • Direct Link リソースの作成および 操作に必要なアクセス 権限があることを確認してください。
  • Terraform CLI をインストールし、Terraform 用の IBM Cloud プロバイダー プラグインを設定します。 詳細については、 IBM Cloud® の 「Terraform 入門」チュートリアルを参照してください。 このプラグインは、以下のタスクを実行するために使用される IBM Cloud API を抽象化します。
  • main.tfという名前の Terraform 構成ファイルを作成します。 このファイルで、HashiCorp 構成言語を使用して、サービス間の許可を作成するための構成を追加します。 詳しくは Terraformのドキュメントを参照。

  1. Terraformの設定ファイルで、 Direct Link インスタンスを作成するために使用した Terraform コードを探します。

  2. ファイル main.tf 内のリソース ibm_resource_instance 引数を使用して、 Direct Link インスタンスを作成します。 次の例における Direct Link ゾーンは、. Gateway1 という名前が付けられています。 以下の例の Direct Link リソースは、test_dl_routers という名前で、dal10 ロケーションで Dedicated ゲートウェイとして作成されます。

    引数と属性の詳細については ibm_dl_gateway 使用例を参照のこと。

    data "ibm_dl_routers" "test_dl_routers" {
        offering_type = "dedicated"
        location_name = "dal10"
    }

resource "ibm_dl_gateway" "test_dl_gateway" {
  bgp_asn =  64999
  global = true
  metered = false
  name = "Gateway1"
  resource_group = "bf823d4f45b64ceaa4671bee0479346e"
  speed_mbps = 1000
  type =  "dedicated"
  cross_connect_router = data.ibm_dl_routers.test_dl_routers.cross_connect_routers[0].router_name
  location_name = data.ibm_dl_routers.test_dl_routers.location_name
  customer_name = "Customer1"
  carrier_name = "Carrier1"

}

  3. 設定ファイルの作成が完了したら、Terraform CLIを初期化してください。 詳細については、 「作業ディレクトリの初期化」 を参照してください。

    terraform init

  4. ファイル main.tf からリソースを提供します。 詳細については、 「Terraform によるインフラストラクチャのプロビジョニング」 を参照してください。

    1. 実行 terraform plan して、提案されたアクションをプレビューするためのTerraform実行プランを生成します。

      terraform plan

    2. プランで定義されたリソースを作成するために terraform apply 実行します。

      terraform apply

  5. IBM Cloud リソース・ リストから、作成した Direct Link インスタンスを選択し、インスタンス ID をメモする。

  6. アクセス・ポリシーが正常に割り当てられていることを確認します。 詳細については、割り当てられたアクセス権限をコンソールで確認を参照してください。

次のステップ

IBM Cloud で Terraform を使用して最初の Direct Link サービスインスタンスの作成に成功した今、 Direct Link Direct Link の Terraform レジストリにアクセスし、Terraform を使用した追加タスクを実行できます。