Todos los productos
Search
Centro de documentos

Terraform:Configurar una solución de aceleración para la inicialización de Terraform

Última actualización: Sep 05, 2026

Si el comando terraform init supera el tiempo de espera debido a latencia de red u otros factores, pueden presentarse problemas como la imposibilidad de descargar providers. Para resolver estos inconvenientes, especifique el sitio de imágenes de código abierto de Alibaba Cloud.

Problema

El provider de Alibaba Cloud se descarga desde los siguientes orígenes: source = hashicorp/alicloud y source = aliyun/alicloud. Es posible que experimente velocidades lentas o errores de descarga al obtener el provider en China:

- Finding aliyun/alicloud versions matching "1.191.0"...
╷
│ Error: Failed to query available provider packages
│
│ Could not retrieve the list of available versions for provider aliyun/alicloud: could not query provider registry for registry.terraform.io/aliyun/alicloud: the request
│ failed after 2 attempts, please try again later: Get "https://registry.terraform.io/v1/providers/aliyun/alicloud/versions": net/http: request canceled (Client.Timeout
│ exceeded while awaiting headers)
╵

- Finding hashicorp/alicloud versions matching "1.191.0"...
╷
│ Error: Failed to query available provider packages
│
│ Could not retrieve the list of available versions for provider hashicorp/alicloud: could not query provider registry for registry.terraform.io/hashicorp/alicloud: the
│ request failed after 2 attempts, please try again later: Get "https://registry.terraform.io/v1/providers/hashicorp/alicloud/versions": context deadline exceeded
│ (Client.Timeout exceeded while awaiting headers)
╵

Solución

Terraform CLI V0.13.2 y versiones posteriores permiten configurar imágenes de red. Para solucionar los problemas anteriores, el provider de Alibaba Cloud ofrece un servicio de imágenes que ayuda a los usuarios en China a descargarlas con mayor rapidez.

Método de configuración

Cree un archivo de configuración llamado .terraformrc o terraform.rc. La ubicación del archivo varía según el sistema operativo de su host.

  • En un sistema operativo Windows, el archivo debe llamarse terraform.rc y almacenarse en el directorio %APPDATA% del usuario. El directorio específico varía según la versión de Windows y las configuraciones del sistema. Ejecute el comando $env:APPDATA en PowerShell para localizar el directorio correspondiente en su sistema operativo.

  • En todos los demás sistemas operativos, el archivo debe llamarse .terraformrc y almacenarse en el directorio principal del usuario correspondiente.

También puede usar la variable de entorno TF_CLI_CONFIG_FILE para especificar el directorio del archivo de configuración de Terraform CLI. El archivo de configuración debe seguir el formato de nomenclatura *.tfrc.

Si utiliza macOS, cree un archivo llamado .terraformrc en el directorio principal. El archivo debe contener lo siguiente:

provider_installation {
  network_mirror {
    url = "https://mirrors.aliyun.com/terraform/"
    // Only Alibaba Cloud-related providers can be downloaded from image sources in the Chinese mainland.
    include = ["registry.terraform.io/aliyun/alicloud", 
               "registry.terraform.io/hashicorp/alicloud",
              ]   
  }
  direct {
    // All providers except Alibaba Cloud-related providers maintain the original download links.
    exclude = ["registry.terraform.io/aliyun/alicloud", 
               "registry.terraform.io/hashicorp/alicloud",
              ]  
  }
}