Introdução
Terraform é uma ferramenta de Infraestrutura como Código (IaC - Infrastructure as Code) de código aberto criada pela HashiCorp. Ela permite definir e provisionar infraestrutura de data center usando uma linguagem de configuração de alto nível.
Neste laboratório, você aprenderá a instalar o Terraform em um sistema Ubuntu 22.04. Seguiremos o guia oficial da HashiCorp, que envolve adicionar a chave GPG da HashiCorp e o repositório de pacotes oficial. Este método garante que você possa instalar e atualizar facilmente o Terraform usando o gerenciador de pacotes padrão apt.
Atualizar o sistema e instalar os pacotes gnupg e software-properties-common
Nesta etapa, você atualizará a lista de pacotes do seu sistema e instalará os pacotes pré-requisitos necessários. Este é um primeiro passo crucial para garantir que seu sistema esteja atualizado e possua as ferramentas necessárias para adicionar e gerenciar novos repositórios de software.
Primeiro, atualize o índice de pacotes do apt. Este comando baixa as informações dos pacotes de todas as fontes configuradas.
sudo apt-get update
Em seguida, instale gnupg, software-properties-common e wget.
gnupgé necessário para verificar a assinatura GPG do repositório HashiCorp.software-properties-commonfornece scripts úteis para gerenciar fontes de software.wgeté uma utilidade para baixar arquivos da internet, que usaremos para obter a chave GPG.
Execute o seguinte comando para instalar esses pacotes:
sudo apt-get install -y gnupg software-properties-common wget
Você verá uma saída enquanto o apt baixa e instala os pacotes e suas dependências. Uma instalação bem-sucedida terminará sem quaisquer mensagens de erro.
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
...
Setting up gnupg ([version]) ...
Setting up software-properties-common ([version]) ...
...
Agora que os pré-requisitos estão instalados, você está pronto para adicionar a chave GPG da HashiCorp.
Baixar e instalar a chave GPG da HashiCorp usando wget e gpg --dearmor
Nesta etapa, você baixará a chave GPG da HashiCorp e a adicionará ao keyring (cadeia de chaves) do seu sistema. Esta chave é usada pelo apt para verificar se os pacotes que você baixa do repositório HashiCorp são autênticos e não foram adulterados.
Usaremos um único comando que encadeia wget, gpg e tee para realizar isso.
wget -O- ...baixa a chave do URL e a envia para a saída padrão (standard output).gpg --dearmorprocessa a chave da entrada padrão (standard input) e a converte para o formato binário que oaptespera.sudo tee ...pega a chave binária da entrada padrão e a grava no arquivo/usr/share/keyrings/hashicorp-archive-keyring.gpg. Usamosteecomsudoporque este diretório requer permissões de root para escrita.
Instale a chave GPG da HashiCorp.
wget -O- https://apt.releases.hashicorp.com/gpg \
| gpg --dearmor \
| sudo tee /usr/share/keyrings/hashicorp-archive-keyring.gpg > /dev/null
Se o comando for bem-sucedido, ele exibirá o conteúdo binário da chave GPG no seu terminal enquanto também o grava no arquivo especificado. Você pode ver um fluxo de caracteres que não são legíveis por humanos; isso é esperado.
--[timestamp]-- https://apt.releases.hashicorp.com/gpg
Resolving apt.releases.hashicorp.com (apt.releases.hashicorp.com)... [server IPs]
Connecting to apt.releases.hashicorp.com (apt.releases.hashicorp.com)|[IP]|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: [size] ([size_human]) [binary/octet-stream]
Saving to: 'STDOUT'
- 100%[===================>] [size] --.-KB/s in 0s
[timestamp] ([speed]) - written to stdout [[size]/[size]]
... (binary output from gpg) ...
A chave agora está armazenada no seu sistema, pronta para ser usada pelo apt.
Verificar a impressão digital da chave GPG da HashiCorp com gpg --fingerprint
Nesta etapa, você verificará a impressão digital da chave GPG que acabou de baixar. Esta é uma prática de segurança importante para confirmar que você possui a chave oficial correta da HashiCorp e não uma maliciosa.
Você pode exibir a impressão digital da chave usando o comando gpg, apontando-o para o arquivo de keyring que criamos na etapa anterior.
Execute o seguinte comando:
gpg --no-default-keyring --keyring /usr/share/keyrings/hashicorp-archive-keyring.gpg --fingerprint
O comando exibirá os detalhes da chave, incluindo sua impressão digital.
/usr/share/keyrings/hashicorp-archive-keyring.gpg
-------------------------------------------------
pub rsa4096 [creation_date] [SC] [expires: [expiry_date]]
[FINGERPRINT]
uid [ unknown] HashiCorp Security (HashiCorp Package Signing) <security+packaging@hashicorp.com>
sub rsa4096 [creation_date] [S] [expires: [expiry_date]]
Você deve verificar se a impressão digital da chave pub corresponde àquela publicada pela HashiCorp. A impressão digital deve ser uma string hexadecimal de 40 caracteres. Como a saída corresponde à impressão digital esperada, você pode ter certeza de que possui a chave correta.
Adicionar o repositório HashiCorp às fontes do apt e atualizar o apt
Nesta etapa, você adicionará o repositório oficial da HashiCorp à lista de fontes do apt do seu sistema. Isso informa ao gerenciador de pacotes onde procurar os pacotes do Terraform.
Adicione o repositório oficial da HashiCorp ao seu sistema.
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(grep -oP '(?<=UBUNTU_CODENAME=).*' /etc/os-release || lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
Este comando não deve produzir nenhuma saída. Agora que o novo repositório foi adicionado, você deve atualizar a lista de pacotes do apt novamente para que ele reconheça os pacotes disponíveis da fonte HashiCorp.
sudo apt update
Na saída, você deverá ver uma linha indicando que o apt está obtendo pacotes de https://apt.releases.hashicorp.com.
Hit:1 http://[mirror]/ubuntu jammy InRelease
Hit:2 http://[mirror]/ubuntu jammy-updates InRelease
Hit:3 http://[mirror]/ubuntu jammy-backports InRelease
Hit:4 http://[mirror]/ubuntu jammy-security InRelease
Get:5 https://apt.releases.hashicorp.com jammy InRelease [[size] kB]
Get:6 https://apt.releases.hashicorp.com jammy/main amd64 Packages [[size] kB]
Fetched [total] kB in [time] ([speed] kB/s)
Reading package lists... Done
Seu sistema agora está configurado para instalar software do repositório oficial da HashiCorp.
Instalar o pacote Terraform usando apt-get install terraform
Nesta etapa final, você instalará o Terraform. Com a chave GPG e o repositório configurados, você pode agora usar o comando padrão apt-get install. O apt encontrará automaticamente o pacote Terraform no repositório da HashiCorp, verificará sua assinatura e o instalará.
Execute o seguinte comando para instalar o Terraform:
sudo apt-get install terraform
O apt mostrará os pacotes que serão instalados e solicitará confirmação. Como estamos em um ambiente não interativo, a instalação prosseguirá automaticamente.
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following NEW packages will be installed:
terraform
[upgrade_info]
Need to get [size] MB of archives.
After this operation, [disk_space] MB of additional disk space will be used.
Get:1 https://apt.releases.hashicorp.com jammy/main amd64 terraform amd64 [version]-1 [[size] MB]
...
Setting up terraform ([version]-1) ...
Assim que a instalação for concluída, você pode verificar se o Terraform foi instalado corretamente checando sua versão.
terraform -v
Este comando deve exibir a versão do Terraform instalada.
Terraform v[version]
on linux_amd64
Parabéns! Você instalou o Terraform com sucesso no seu sistema.
Resumo
Neste laboratório, você instalou com sucesso o Terraform em um sistema Ubuntu usando o repositório de pacotes oficial da HashiCorp.
Você aprendeu como:
- Atualizar seu sistema e instalar pacotes pré-requisitos como
gnupgewget. - Baixar e adicionar a chave GPG oficial da HashiCorp para garantir a autenticidade do pacote.
- Verificar a impressão digital (fingerprint) da chave GPG como uma medida de segurança.
- Adicionar o repositório
aptda HashiCorp às fontes de software do seu sistema. - Instalar o pacote Terraform usando o comando
apt-get. - Verificar a instalação checando a versão do Terraform.
Ao seguir estas etapas, você configurou uma instalação do Terraform limpa e gerenciável que pode ser facilmente atualizada no futuro usando comandos padrão do sistema.
