HashiCorp Terraform は、クラウド インフラストラクチャのプロビジョニングと管理に使用できる Infrastructure as Code（IaC）ツールです。Terraform には、クラウド プロバイダや他の API とやり取りできるプロバイダというプラグインが用意されています。 Cloud de Confiance用の Terraform プロバイダを使用して、Artifact Registry などの Cloud de Confiance by S3NS リソースをプロビジョニングして管理できます。
このページでは、Artifact Registry で Terraform を使用する方法について説明します。Terraform の仕組みの概要と、 Terraform の使用を開始するためのリソースも紹介します Cloud de Confiance。また、Artifact Registry の Terraform リファレンス ドキュメント、コードサンプル、Terraform を使用して Artifact Registry リソースをプロビジョニングするガイドへのリンクも用意されています。
用 Terraform の使用方法については、 Terraform をインストールして構成するまたは 用 Terraform Cloud de Confiance クイックスタートをご覧ください。 Cloud de Confiance
Terraform の仕組み
Terraform には宣言型で構成指向の構文があり、これを使用して、 Cloud de Confiance プロジェクトにプロビジョニングするインフラストラクチャを記述できます。1 つまたは複数の Terraform 構成ファイルで構成を作成し、Terraform CLI を使用して、この構成を Artifact Registry リソースに適用できます。
以降のステップでは、Terraform の仕組みについて説明します。
- プロビジョニングするインフラストラクチャを Terraform 構成ファイルに記述します。インフラストラクチャのプロビジョニング方法を記述するコードは必要ありません。Terraform がインフラストラクチャをプロビジョニングします。
terraform planコマンドを実行します。これにより、構成が評価され、実行プランが生成されます。プランを確認し、必要に応じて変更します。-
次に、
terraform applyコマンドを実行します。これにより、次のアクションが実行されます。- バックグラウンドで、対応する Artifact Registry API を呼び出し、実行プランに基づいてインフラストラクチャをプロビジョニングします。
- Terraform 状態ファイルを作成します。これは、構成ファイル内のリソースと実際のインフラストラクチャ内のリソースとのマッピングを行う JSON ファイルです。Terraform は、このファイルを使用してインフラストラクチャの最新状態を記録し、リソースを作成、更新、破棄するタイミングを決定します。
-
terraform applyを実行すると、Terraform は状態ファイルのマッピングを使用して、既存のインフラストラクチャをコードと比較し、必要に応じて更新を行います。- 構成ファイルで定義されたリソース オブジェクトが状態ファイルに存在しない場合、Terraform はリソース オブジェクトを作成します。
- リソース オブジェクトが状態ファイルに存在し、構成ファイルと構成が異なる場合、Terraform は構成ファイルと一致するようにリソースを更新します。
- 状態ファイル内のリソース オブジェクトが構成ファイルと一致する場合、Terraform はリソースを変更しません。
Artifact Registry の Terraform リソース
リソースは、Terraform 言語の基本要素です。各リソース ブロックは、仮想ネットワークやコンピューティング インスタンスなど、1 つ以上のインフラストラクチャ オブジェクトを記述します。
次の表に、Artifact Registry で使用可能な Terraform リソースを示します。
| サービス | Terraform リソース | データソース |
|---|---|---|
| Artifact Registry |
|
Artifact Registry の Terraform ベースのガイド
次の表には、Artifact Registry の Terraform ベースの入門ガイドとチュートリアルすべてが一覧表示されています。
| ガイド | 詳細 |
|---|---|
| Terraform を使用して標準リポジトリを作成する | このガイドでは、Terraform を使用して標準モード リポジトリを作成する方法について説明します。 |
Artifact Registry の Terraform モジュールとブループリント
モジュールとブループリントを使用すると、リソースの大規模なプロビジョニングと管理を自動化できます。 Cloud de Confiance モジュールとは、Terraform リソースを論理的に抽象化する、再利用可能な一連の Terraform 構成ファイルのことです。ブループリントは、特定のソリューションを実装および文書化した、モジュールとポリシーのパッケージです。このパッケージはデプロイして再利用できます。
次の表には、Artifact Registry に関連するすべてのモジュールとブループリントが一覧表示されています。
| モジュールまたはブループリント | 詳細 |
|---|---|
| Artifact Registry | Artifact Registry リポジトリを作成して管理する |
| gcloud | Terraform 内で gcloud CLI コマンドを実行する |