:Instalar e configurar o Terraform

Instalar o Terraform

Este tópico descreve como instalar o Terraform com um pacote de instalação no Linux ou Windows.

1. Baixe o pacote de instalação do Terraform adequado ao seu sistema operacional no site oficial do Terraform.

2. Configure o ambiente de execução do Terraform.

   Linux

   Execute o comando a seguir para descompactar o pacote de instalação no diretório /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. Descompacte o pacote de instalação em um diretório, como D:\tool\terraform.

   2. Na área de trabalho do Windows, clique com o botão direito em This PC e selecione Properties. Na página exibida, clique em Advanced system settings. Na caixa de diálogo System Properties, clique em Environment Variables na guia Advanced.

   3. Na caixa de diálogo Environment Variables, selecione Path na seção System variables ou User variables e clique em Edit. Na caixa de diálogo exibida, insira o diretório onde você descompactou o pacote de instalação do Terraform, como D:\tool\terraform, e clique em OK.

3. Execute o comando terraform para verificar a instalação do Terraform.

   terraform

   Se uma lista de opções disponíveis do Terraform for exibida, conforme a figura a seguir, a instalação estará concluída.

   

Configurar a autenticação do Terraform

Antes de usar o Terraform para gerenciar a infraestrutura da Alibaba Cloud, conclua a autenticação do Terraform Provider. Somente após essa autenticação o Terraform poderá chamar operações de API da Alibaba Cloud, além de criar e gerenciar sua infraestrutura e recursos. O Alibaba Cloud Terraform Provider oferece suporte a vários métodos de autenticação. Para mais informações, consulte Autenticação do Terraform.

Neste exemplo, a autenticação utiliza o par AccessKey de um usuário do Resource Access Management (RAM) obtido por variáveis de ambiente.

1. Crie um par AccessKey para um usuário RAM. Uma conta Alibaba Cloud possui todas as permissões sobre os recursos. Caso o par AccessKey da sua conta Alibaba Cloud seja comprometido, seus recursos ficarão expostos a grandes riscos. Recomendamos o uso do par AccessKey de um usuário RAM. Para mais informações, consulte Criar um AccessKey.

2. Conceda permissões ao usuário RAM com base no princípio do menor privilégio e nos requisitos do seu negócio. Para mais informações, consulte Criar uma política personalizada.

3. Crie variáveis de ambiente para armazenar as informações de identidade.

   Linux

   Importante

   As variáveis de ambiente temporárias configuradas com o comando export são válidas apenas para a sessão atual. Ao sair da sessão, essas variáveis deixam de funcionar. Para configurar variáveis de ambiente permanentes, adicione o comando export ao arquivo de configuração de inicialização do seu sistema operacional.

   # 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. Na área de trabalho do Windows, clique com o botão direito em This PC e selecione Properties. Na página exibida, clique em Advanced system settings. Na caixa de diálogo System Properties, clique em Environment Variables na guia Advanced.

   2. Na caixa de diálogo Environment Variables, clique em New na seção System variables ou User variables. Na caixa de diálogo exibida, crie as variáveis de ambiente descritas na tabela a seguir.

      Variável	Descrição	Exemplo
      ALICLOUD_ACCESS_KEY	AccessKey Id	yourAccessKeyID
      ALICLOUD_SECRET_KEY	AccessKey Secret	yourAccessKeySecret
      ALICLOUD_REGION	A região onde os recursos estão implantados.	cn-beijing

(Opcional) Configurar uma solução de aceleração para a inicialização do Terraform

Após escrever um arquivo de configuração do Terraform, execute o comando terraform init no diretório onde o arquivo está armazenado. O Terraform carrega automaticamente a versão mais recente ou especificada do Provider, com base nas informações de Provider e Provisioner definidas no arquivo de configuração ou nos recursos e fontes de dados associados à versão do Provider.

Caso a inicialização do Terraform atinja o tempo limite devido a fatores como latência de rede, o download da versão do Provider pode falhar. Para resolver esse problema, configure um site de imagem da Alibaba Cloud. É possível baixar o Terraform Provider das seguintes fontes: source = hashicorp/alicloud e source = aliyun/alicloud. O Terraform CLI V0.13.2 e versões posteriores suportam a configuração de imagens de rede. Para mais informações, consulte Configurar aceleração de inicialização do Terraform.

Referências

• Sintaxe de configuração

• Criar recursos com o Terraform