Schematics-Agenten zur Verwendung einer privaten Registry konfigurieren

Agenten unterstützen die Verwendung angepasster Terraform-Provider, die aus einer privaten Terraform-Registry mit Schematics-Terraform-Jobs stammen. Die Unterstützung für die Verwendung angepasster Provider ist im gemeinsam genutzten Multi-Tenant-Service Schematics nicht verfügbar. Sie ist nur mit Agenten verfügbar. Agenten enthalten keine lokale oder private Provider-Registry. Darüber hinaus können Benutzer die Registry im privaten Netz des Benutzers konfigurieren, auf das die Agenten zugreifen können.

Wenn Schematics-Jobs ausgeführt werden, lädt die Terraform-CLI standardmäßig die erforderlichen Terraform-Provider-Plug-ins oder Terraform-Module aus der öffentlichen Terraform-Registry über das Internet oder das öffentliche Netz herunter. Wenn ein Agent in einem privaten Netz implementiert wird, legen Sicherheitsrichtlinien fest, dass ein Proxy oder eine Spiegelsite zum Herunterladen und Caching von Provider-Plug-ins verwendet werden muss. Außerdem kann es wünschenswert sein, angepasste Terraform-Provider in einer privaten Registry zu hosten, um umgebungsspezifische Ressourcen zu konfigurieren.

Für diese Anwendungsfälle ermöglicht Terraform die Konfiguration des Provider-Downloads aus alternativen Provider-Registrys mithilfe eines provider_installation-Blocks in der Terraform-CLI-Konfiguration. Dies ermöglicht die Anpassung des Standardinstallationsverhaltens von Terraform. Weitere Details zum Konfigurieren des Provider-Downloads finden Sie in der Terraform-Dokumentation für die Providerinstallation.

Bei Agenten können die folgenden beiden Umgebungsvariablen für den Arbeitsbereich verwendet werden, um die Terraform-CLI so zu konfigurieren, dass sie auf ein alternatives Repository verweist, und Provider nach Name und Namensbereich aus dieser Registry auszuwählen.

• Das private TF_NETWORK_MIRROR_URL Terraform-Repository, die Website oder die Artifactory-Instanz, in der angepasste Terraform-Provider gehostet werden.
• Der TF_NETWORK_MIRROR_PROVIDER_NAME-Name und -Namespace des Providers, der von der angepassten Position heruntergeladen wird Informationen zur Providerbenennung und zu Namensbereichenfinden Sie in der Terraform-Dokumentation. Wenn nicht angegeben, werden standardmäßig alle Provider in allen Namensbereichen "*/*" aus der privaten Registry heruntergeladen.

Schematics generiert automatisch die folgenden Parameter der Terraform-CLI-Konfigurationsdatei. Während der Jobausführung kann Terraform die private Registry für einige angepasste Provider, die Sie verwenden möchten, oder für alle Provider verwenden.

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 = ["*/*"]
                }
        }