プライベート・レジストリーを使用するための Schematics エージェントの構成

エージェントは、 Schematics Terraform ジョブで、プライベート Terraform レジストリーをソースとするカスタム Terraform プロバイダーの使用をサポートします。 カスタム・プロバイダーを使用するためのサポートは、共有マルチテナント Schematics サービスでは使用できません。 これはエージェントでのみ使用可能です。 エージェントには、ローカルまたはプライベートのプロバイダー・レジストリーは含まれません。 さらに、ユーザーは、エージェントからアクセス可能なプライベート・ネットワーク上でレジストリーを構成できます。

デフォルトでは、 Schematics ジョブが実行されると、Terraform CLI は、必要な Terraform プロバイダー・プラグインまたは Terraform モジュールをパブリック Terraform レジストリーからインターネットまたはパブリック・ネットワークを介してダウンロードします。 エージェントがプライベート・ネットワークにデプロイされている場合、セキュリティー・ポリシーは、プロキシーまたはミラー・サイトを使用してプロバイダー・プラグインをダウンロードおよびキャッシングする必要があることを指示します。 さらに、カスタム開発された Terraform プロバイダーをプライベート・レジストリーでホストして、環境固有のリソースを構成することが必要になる場合もあります。

これらのユース・ケースでは、Terraform CLI 構成の provider_installation ブロックを使用して、代替プロバイダー・レジストリーからのプロバイダーのダウンロードを構成できます。 これにより、Terraform のデフォルトのインストール動作をカスタマイズできます。 プロバイダーのダウンロードの構成について詳しくは、 プロバイダーのインストール に関する Terraform 資料を参照してください。

エージェントでは、以下の 2 つのワークスペース環境変数を使用して、代替リポジトリーを参照し、このレジストリーから名前と名前空間でプロバイダーを選択するように Terraform CLI を構成できます。

• カスタム Terraform プロバイダーがホストされている TF_NETWORK_MIRROR_URL Terraform プライベート・リポジトリー、Web サイト、または Artifactory インスタンス。
• カスタム・ロケーションからダウンロードされるプロバイダーの TF_NETWORK_MIRROR_PROVIDER_NAME の名前と名前空間。 プロバイダーの命名と名前空間については、Terraform の資料を参照してください。 指定しない場合、デフォルトで、プライベート・レジストリーからダウンロードされるすべての名前空間 "*/*" 内のすべてのプロバイダーになります。

Schematics は、以下の Terraform CLI 構成ファイル・パラメーターを自動生成します。 ジョブの実行中に、Terraform は、使用するいくつかのカスタム・プロバイダーにプライベート・レジストリーを使用することも、すべてのプロバイダーにプライベート・レジストリーを使用することもできます。

provider_installation {
network_mirror {
url = "${TF_NETWORK_MIRROR_URL}"
include = ["${TF_NETWORK_MIRROR_PROVIDER_NAME}"]
}
direct {
exclude = ["TF_NETWORK_MIRROR_PROVIDER_NAME"]
}
}

provider_installation {
                network_mirror {
                        url = "https://name.artifactory.user.com/artifactory/api/terraform/user-terraform-local/providers/"
                        include = ["user_namespace/provider_name"]
                }
                direct {
                        exclude = ["user_namespace/provider_name"]
                }
}  

provider_installation {
                network_mirror {
                        url = "https://name.artifactory.user.com/artifactory/api/terraform/user-terraform-remote/providers/"
                        include = ["*/*"]
                }
                direct {
                        exclude = ["*/*"]
                }
        }

provider_installation {
                network_mirror {
                        url = "https://name.artifactory.user.com/artifactory/api/terraform/user-terraform-virtual/providers/"
                        include = ["*/*"]
                }
                direct {
                        exclude = ["*/*"]
                }
        }