Terraform を使用

Google Distributed Cloud（GDC）エアギャップ環境で Terraform を構成するには、ダウンロードして、Kubernetes リソースを処理するように構成する必要があります。

このドキュメントは、エアギャップ ハードウェアとソフトウェアのワークフローを管理するために Terraform を設定する必要があるすべてのユーザー グループを対象としています。詳細については、GDC エアギャップの対象ユーザーに関するドキュメントをご覧ください。

始める前に

Terraform の設定

GDC 環境で Terraform を設定するには、次の操作を行います。

  1. Terraform モジュール内、またはワークステーション上の Terraform ファイルのコレクション内に main.tf ファイルを作成し、次の構成を追加します。

    terraform {
  backend "s3" {
    bucket = "BUCKET_FQN"
    key = "TF_STATE_PATH"
    endpoint = "BUCKET_ENDPOINT"
    skip_credentials_validation = true
    force_path_style = true
    access_key = "ACCESS_KEY"
    secret_key = "SECRET_KEY"
  }
}

    次のように置き換えます。

    • BUCKET_FQN: Bucket カスタム リソースの完全修飾名。

    • TF_STATE_PATH: ストレージ バケットに保存する Terraform 状態ファイルのパス。

    • BUCKET_ENDPOINT: Bucket カスタム リソースのエンドポイント。

    • ACCESS_KEY: アクセス認証情報を含むシークレットから取得したアクセスキー。アクセスキーの取得の詳細については、バケット アクセス認証情報を取得するをご覧ください。

    • SECRET_KEY: アクセス認証情報を含むシークレットから取得した秘密鍵。シークレット キーの取得方法については、バケット アクセス認証情報を取得するをご覧ください。

  2. 前の手順で指定したストレージ バケットで Terraform 状態ファイルを初期化します。

    terraform init

    Terraform は必須入力として AWS リージョンを要求する場合がありますが、GDC オブジェクト ストレージを使用しているため、この値は使用されません。要件を満たすために、任意の AWS リージョンを入力します。

  3. crd-viewer クラスタロール リソースをデプロイし、ユーザー アカウントにバインドします。

    kubectl apply --kubeconfig KUBECONFIG -f - <<EOF
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: crd-viewer
rules:
- apiGroups: ["apiextensions.k8s.io"]
  resources: ["customresourcedefinitions"]
  verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: crd-viewer-binding
subjects:
- kind: User
  name: USER_EMAIL
roleRef:
  kind: ClusterRole
  name: crd-viewer
  apiGroup: rbac.authorization.k8s.io
EOF

    次のように置き換えます。

    • KUBECONFIG: Terraform で管理するリソースをホストする API サーバーまたはクラスタの kubeconfig ファイル。

    • USER_EMAIL: ロールをバインドするユーザーのメールアドレス。

    Terraform で使用する各 API サーバーまたはクラスタに crd-viewer ロールをデプロイします。

  4. main.tf ファイルに次の required_providers ブロックを挿入します。

    terraform {
  required_providers {
    kubernetes = {
      source = "hashicorp/kubernetes"
      version = ">=2.24.0"
    }
  }
}

    この構成では、GDC 環境で Kubernetes リソースをプロビジョニングして管理するために、Kubernetes プロバイダがインストールされます。

  5. Terraform の作業ディレクトリを初期化して、プロバイダをインストールします。

    terraform init

次のステップ