Configuración de agentes de Schematics para utilizar un registro privado

Los agentes dan soporte al uso de proveedores de Terraform personalizados que proceden de un registro de Terraform privado con trabajos de Terraform Schematics. El soporte para utilizar proveedores personalizados no está disponible en el servicio Schematics de multiarrendatario compartido. Solo está disponible con agentes. los agentes no incluyen un registro de proveedor local o privado. Además, los usuarios pueden configurar el registro en la red privada de usuarios a la que pueden acceder los agentes.

De forma predeterminada, cuando se ejecutan trabajos Schematics, la CLI de Terraform descarga los plug-ins de proveedor de Terraform necesarios o los módulos de Terraform del registro de Terraform público a través de Internet o de la red pública. Cuando se despliega un agente en una red privada, las políticas de seguridad dictan que se debe utilizar un proxy o sitio de duplicación para descargar y almacenar en memoria caché los plug-ins de proveedor. Además, es posible que desee alojar proveedores de Terraform desarrollados de forma personalizada en un registro privado para configurar recursos específicos del entorno.

Para estos casos de uso, Terraform permite la configuración de la descarga de proveedor desde registros de proveedor alternativos utilizando un bloque provider_installation en la configuración de CLI de Terraform. Esto permite la personalización del comportamiento de instalación predeterminado de Terraform. Revise la documentación de Terraform para la instalación del proveedor para obtener más detalles sobre la configuración de la descarga del proveedor.

En los agentes, se pueden utilizar las dos variables de entorno de espacio de trabajo siguientes para configurar la CLI de Terraform para hacer referencia a un repositorio alternativo y seleccionar proveedores por nombre y espacio de nombres de este registro.

• La instancia de TF_NETWORK_MIRROR_URL repositorio privado de Terraform, sitio web o Artifactory donde se alojan los proveedores de Terraform personalizados.
• El nombre de TF_NETWORK_MIRROR_PROVIDER_NAME y el espacio de nombres del proveedor que se va a descargar de la ubicación personalizada. Consulte la documentación de Terraform para nombres de proveedores y espacios de nombres. Si no se especifica, el valor predeterminado es que todos los proveedores de todos los espacios de nombres "*/*" se descarguen del registro privado.

Schematics genera automáticamente los siguientes parámetros de archivo de configuración de CLI de Terraform. Durante la ejecución del trabajo, Terraform puede utilizar el registro privado para unos pocos proveedores personalizados que tiene previsto utilizar o, de forma alternativa, para todos los proveedores.

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