:Instalación y configuración de Terraform

Instalación de Terraform

Este tema describe cómo instalar Terraform mediante un paquete de instalación en Linux o Windows.

1. Descargue el paquete de instalación de Terraform adecuado para su sistema operativo desde el sitio web oficial de Terraform.

2. Configure el entorno de ejecución de Terraform.

   Linux

   Ejecute el siguiente comando para descomprimir el paquete de instalación en el directorio /usr/local/bin:

   # Replace /terraform_1.9.5_linux_amd64.zip in the following command with the directory in which the installation package is stored.
   sudo unzip /terraform_1.9.5_linux_amd64.zip -d /usr/local/bin
   

   Windows

   1. Descomprima el paquete de instalación en un directorio, por ejemplo, D:\tool\terraform.

   2. En el escritorio de Windows, haga clic con el botón derecho en This PC y seleccione Properties. En la página que aparece, haga clic en Advanced system settings. En el cuadro de diálogo System Properties, haga clic en Environment Variables en la pestaña Advanced.

   3. En el cuadro de diálogo Environment Variables, seleccione Path en la sección System variables o User variables y haga clic en Edit. En el cuadro de diálogo que aparece, introduzca el directorio donde se descomprimió el paquete de instalación de Terraform, como D:\tool\terraform, y haga clic en OK.

3. Ejecute el comando terraform para comprobar si Terraform está instalado.

   terraform

   Si se muestra una lista de opciones disponibles de Terraform, como se ilustra en la siguiente figura, la instalación se completó correctamente.

   

Configuración de la autenticación de identidad de Terraform

Antes de usar Terraform para gestionar la infraestructura de Alibaba Cloud, debe completar la autenticación de identidad de Terraform Provider. Solo después de autenticarse podrá usar Terraform para invocar operaciones de la API de Alibaba Cloud, así como crear y gestionar la infraestructura y los recursos de Alibaba Cloud. Terraform Provider para Alibaba Cloud admite varios métodos de autenticación. Para obtener más información, consulte Terraform authentication.

En este ejemplo, se usa el par de AccessKey de un usuario de Resource Access Management (RAM) obtenido mediante variables de entorno para la autenticación de identidad.

1. Cree un par de AccessKey para un usuario de RAM. Una cuenta de Alibaba Cloud tiene todos los permisos sobre los recursos. Si el par de AccessKey de su cuenta de Alibaba Cloud se ve comprometido, sus recursos quedarán expuestos a grandes riesgos. Se recomienda usar el par de AccessKey de un usuario de RAM. Para obtener más información, consulte Create an AccessKey.

2. Otorgue permisos al usuario de RAM según el principio de menor privilegio y sus requisitos empresariales. Para obtener más información, consulte Create a custom policy.

3. Cree variables de entorno para almacenar la información de identidad.

   Linux

   Importante

   Las variables de entorno temporales configuradas mediante el comando export solo son válidas para la sesión actual. Al salir de la sesión, las variables de entorno configuradas dejan de ser válidas. Para configurar variables de entorno permanentes, agregue el comando export al archivo de configuración de inicio de su sistema operativo.

   # AccessKey Id
   export ALICLOUD_ACCESS_KEY="<yourAccessKeyID>"
   # AccessKey Secret
   export ALICLOUD_SECRET_KEY="<yourAccessKeySecret>"
   # The region in which resources are deployed.
   export ALICLOUD_REGION="cn-beijing"

   Windows

   1. En el escritorio de Windows, haga clic con el botón derecho en This PC y seleccione Properties. En la página que aparece, haga clic en Advanced system settings. En el cuadro de diálogo System Properties, haga clic en Environment Variables en la pestaña Advanced.

   2. En el cuadro de diálogo Environment Variables, haga clic en New en la sección System variables o User variables. En el cuadro de diálogo que aparece, cree las variables de entorno descritas en la siguiente tabla.

      Variable	Descripción	Ejemplo
      ALICLOUD_ACCESS_KEY	AccessKey Id	yourAccessKeyID
      ALICLOUD_SECRET_KEY	AccessKey Secret	yourAccessKeySecret
      ALICLOUD_REGION	La región donde se despliegan los recursos.	cn-beijing

(Opcional) Configuración de una solución de aceleración para la inicialización de Terraform

Después de escribir un archivo de configuración de Terraform, ejecute el comando terraform init en el directorio donde se encuentra dicho archivo. Terraform carga automáticamente la versión más reciente o la especificada del Provider, según la información de Provider y Provisioner definida en el archivo de configuración, o los recursos y orígenes de datos asociados a dicha versión del Provider.

Si la inicialización de Terraform supera el tiempo de espera debido a factores como la latencia de red, es posible que no se pueda descargar la versión del Provider. Para resolver este problema, configure un sitio de imágenes de Alibaba Cloud. Puede descargar Terraform Provider desde los siguientes orígenes: source = hashicorp/alicloud y source = aliyun/alicloud. Terraform CLI V0.13.2 y versiones posteriores admiten la configuración de imágenes de red. Para obtener más información, consulte Configure Terraform init acceleration.