Cloud Server
Como criar imagens de Cloud Server com Packer
Aprenda a criar imagens de Cloud Server com Packer, validar builds, proteger segredos e integrar templates reproduzíveis ao Terraform e ao CI/CD confiável.
Resposta direta
O HashiCorp Packer cria imagens de Cloud Server a partir de templates declarativos e reproduzíveis. Em vez de instalar pacotes manualmente depois que cada servidor nasce, você define a imagem base, os provisioners, as variáveis e o artefato esperado em arquivos HCL versionados no Git. O Packer inicia uma instância temporária, executa a configuração, remove dados transitórios e solicita ao provedor a criação de uma imagem ou snapshot. Essa imagem pode ser consumida depois pelo Terraform, por grupos de auto scaling ou por pipelines de implantação. O resultado é um provisionamento mais rápido e consistente, desde que versões de pacotes, plugins e imagens de origem sejam controladas. Packer não produz uma imagem universal para todas as clouds: cada builder gera um artefato compatível com o provedor escolhido.
Resumo rápido
- Packer automatiza a criação de imagens de servidor usando templates HCL versionáveis.
- Cada builder produz um artefato específico, como AMI, Azure Managed Image, imagem do Google Compute Engine ou snapshot.
- Shell, Ansible e ferramentas de configuração podem preparar o sistema durante o build.
- Segredos devem entrar por variáveis protegidas do CI, nunca pelo repositório.
packer init,packer fmtepacker validatedevem executar antes de qualquer build.- cloud-init continua útil para configurações específicas de cada instância no primeiro boot.
- Terraform pode localizar e implantar somente imagens já aprovadas pelo pipeline.
O que o Packer resolve na criação de imagens
Criar um Cloud Server manualmente parece simples até o ambiente precisar ser repetido vinte ou duzentas vezes. Um administrador instala Nginx, ajusta o SSH, adiciona um agente de métricas e registra os comandos em um documento. Outro profissional executa etapas parecidas, mas escolhe versões diferentes ou esquece uma configuração. O servidor funciona, porém a equipe não consegue provar que duas instâncias nasceram com o mesmo conteúdo. Esse desvio de configuração costuma aparecer durante uma atualização, uma recuperação de desastre ou a expansão automática da aplicação.
O Packer transforma esse processo em código. Um template pode declarar Ubuntu 24.04 como origem, uma máquina temporária com 2 vCPUs, scripts de instalação e o nome final da imagem. Durante o build, o Packer solicita uma instância ao provedor, aguarda o SSH, executa os provisioners e cria o artefato. A instância temporária é descartada ao final. O produto não é um servidor em execução, mas uma base pronta para lançar outros servidores.
Imagem imutável não significa servidor imutável
A imagem reduz mudanças feitas depois do boot, mas não impede alterações no sistema operacional. Se um operador acessar a instância e editar /etc/nginx/nginx.conf, haverá desvio da mesma forma. O modelo imutável funciona melhor quando correções são incorporadas em uma nova versão da imagem e as instâncias antigas são substituídas gradualmente. Para uma API com quatro réplicas, por exemplo, a equipe pode gerar api-2026.11.08-01, atualizar o launch template e trocar uma réplica por vez.
Ainda existe espaço para configuração dinâmica. Endereço do banco, identificador do ambiente e tokens de curta duração não deveriam ser gravados na imagem. Esses dados podem chegar no primeiro boot por metadata, secret manager ou cloud-init. O artigo sobre como configurar cloud-init em VPS mostra como separar a preparação da base das informações específicas de cada instância.
Uma definição, vários artefatos
O mesmo repositório pode conter sources para AWS, Azure, Google Cloud ou DigitalOcean, mas cada execução gera um formato próprio. Uma AMI não pode ser usada diretamente para iniciar uma VM no Azure. A portabilidade está na lógica compartilhada, como scripts, políticas e versões, não no arquivo final. Tratar essa diferença desde o início evita templates cheios de condicionais e facilita testar cada destino separadamente.
Como estruturar um template Packer em HCL
Um projeto pequeno pode começar com image.pkr.hcl, variables.pkr.hcl e uma pasta scripts/. Projetos maiores costumam separar componentes por função, como base-linux, web, worker e database-client. O formato HCL permite declarar plugins exigidos, variáveis tipadas, sources e blocos de build. Também facilita revisão de código, porque uma alteração de região, versão ou provisioner aparece claramente no diff.
Plugins, variáveis e source
O exemplo abaixo cria uma AMI baseada em uma imagem oficial do Ubuntu. A conta usada pelo pipeline precisa ter permissões para iniciar e encerrar instâncias, criar imagens, manipular snapshots associados e consultar recursos. As credenciais não aparecem no arquivo, pois o plugin utiliza a cadeia de autenticação configurada no ambiente de execução.
packer {
required_plugins {
amazon = {
source = "github.com/hashicorp/amazon"
version = "~> 1.3"
}
}
}
variable "region" {
type = string
default = "us-east-1"
}
source "amazon-ebs" "ubuntu" {
region = var.region
instance_type = "t3.small"
ssh_username = "ubuntu"
ami_name = "web-${formatdate("YYYYMMDD-hhmm", timestamp())}"
source_ami_filter {
filters = {
name = "ubuntu/images/hvm-ssd-gp3/ubuntu-noble-24.04-amd64-server-*"
root-device-type = "ebs"
virtualization-type = "hvm"
}
most_recent = true
owners = ["099720109477"]
}
}
O filtro restringe proprietário, nome e tipo de virtualização. Sem o campo owners, uma imagem de terceiros com nome parecido poderia ser selecionada. Em ambientes mais controlados, a equipe pode receber o identificador exato da imagem base por variável, eliminando a mudança silenciosa causada por most_recent = true.
Build e comandos de validação
O bloco de build conecta o source aos provisioners. Um primeiro teste pode instalar Nginx, gravar a identificação da versão e verificar se o serviço foi habilitado.
build {
name = "web-base"
sources = ["source.amazon-ebs.ubuntu"]
provisioner "shell" {
script = "scripts/install-web.sh"
}
}
Antes da execução, rode packer init . para baixar plugins, packer fmt -check . para conferir formatação e packer validate . para validar o template. O build pode ser iniciado com packer build -var 'region=us-east-1' .. Para depuração, PACKER_LOG=1 packer build . produz logs detalhados, mas o arquivo gerado deve ser protegido porque pode conter metadados sensíveis. Um runner remoto com 2 vCPUs e 2 GB de RAM geralmente basta para builders de cloud, pois o trabalho pesado ocorre na instância temporária. Builds locais com QEMU pedem mais recursos, normalmente 4 vCPUs e 8 GB de RAM ou mais.
Provisionamento com shell, cloud-init e Ansible
Provisioners executam a preparação do sistema entre a criação da instância temporária e a captura da imagem. O shell atende tarefas diretas, como instalar cinco pacotes, copiar uma unidade systemd ou limpar caches. Ansible se encaixa melhor quando a organização já mantém roles testadas para usuários, hardening, observabilidade e aplicações. O cloud-init, por sua vez, costuma permanecer na imagem para cuidar do primeiro boot de cada instância.
Escolhendo o provisioner
Um script de instalação precisa falhar assim que um comando retornar erro. Também deve evitar entradas interativas e controlar versões quando a estabilidade exigir isso.
#!/usr/bin/env bash
set -euo pipefail
export DEBIAN_FRONTEND=noninteractive
sudo apt-get update
sudo apt-get install -y nginx=1.24.0-2ubuntu7.3 jq ca-certificates
sudo systemctl enable nginx
nginx -v
sudo rm -rf /var/lib/apt/lists/*
A versão acima é apenas um exemplo e precisa existir no repositório configurado no momento do build. Fixar uma versão inexistente quebra cedo, o que é preferível a publicar uma imagem diferente sem perceber. Para aplicações internas, outro padrão é copiar um artefato já testado, como app-3.8.2.tar.gz, validar seu SHA-256 e criar uma unidade systemd. O Packer também pode executar Ansible com provisioner "ansible", reutilizando roles. Quem já automatiza servidores pode combinar essa abordagem com as práticas do guia de VPS para Ansible e automação de servidores.
Não use provisioners para gravar senhas, chaves privadas ou tokens permanentes. Caso o build precise baixar um pacote privado, prefira uma credencial temporária injetada pelo cofre do CI. Marque variáveis como sensitive = true, limite a duração do token e remova arquivos temporários antes da captura. O fato de um valor não aparecer no console não garante que ele esteja ausente do disco da imagem.
Preparando a imagem para o primeiro boot
Antes da captura, limpe identidade e estado transitório. Em uma distribuição compatível, um script final pode executar sudo cloud-init clean --logs --machine-id, remover históricos de shell e apagar arquivos temporários do processo de build. Não desative o cloud-init se ele será usado para criar usuários, instalar chaves públicas ou configurar a rede ao iniciar novas instâncias.
A divisão prática fica assim: Packer instala Nginx, agentes e bibliotecas comuns; cloud-init define hostname, ambiente e endpoint de configuração; o secret manager entrega credenciais em tempo de execução. Em um cluster com 30 workers, essa separação reduz o tempo de inicialização e evita manter 30 scripts extensos de bootstrap executando a cada escala.
Builders e artefatos em diferentes provedores
Builder é o componente responsável por conversar com a API da plataforma, criar a máquina temporária e capturar o resultado. O fluxo conceitual é semelhante entre provedores, mas permissões, nomes de recursos, rede e formato do artefato mudam. Por isso, a melhor estratégia não é buscar um template supostamente universal. É manter uma camada comum de scripts e pequenos arquivos HCL específicos para cada destino.
Comparação prática entre builders
| Destino | Builder comum | Artefato gerado | Instância temporária de exemplo | Cuidados principais |
|---|---|---|---|---|
| Amazon EC2 | amazon-ebs | AMI e snapshots EBS associados | t3.small, 2 vCPUs e 2 GiB | Proprietário da imagem base, KMS, compartilhamento entre contas e regiões |
| Microsoft Azure | azure-arm | Managed Image ou recurso compatível definido no fluxo | VM com 2 vCPUs e 4 GiB | Service principal, resource group, galeria e replicação regional |
| Google Compute Engine | googlecompute | Imagem do Compute Engine | Série E2 com 2 vCPUs | Service account, projeto, família da imagem e permissões IAM |
| DigitalOcean | digitalocean | Snapshot de Droplet | Droplet básico compatível com o sistema | Região, tamanho temporário, token e disponibilidade do snapshot |
Os tamanhos da tabela são exemplos operacionais, não requisitos fixos. Compilar módulos do kernel, extensões PHP ou aplicações em Rust pode exigir 4 vCPUs e 8 GB de RAM para reduzir o tempo do build. Uma imagem que apenas instala pacotes binários geralmente usa uma máquina menor. Regiões, tipos de instância e recursos disponíveis devem ser confirmados na documentação oficial do provedor antes da publicação ou alteração do pipeline.
Portabilidade sem falsa equivalência
Uma prática eficiente é manter scripts/base.sh, scripts/hardening.sh e scripts/cleanup.sh compartilhados, enquanto os sources ficam em arquivos como aws.pkr.hcl e gcp.pkr.hcl. O script comum pode instalar Chrony, configurar journald e adicionar um agente OpenTelemetry. Já a integração com identidade, metadata e monitoramento nativo permanece específica.
Também é possível executar múltiplos sources no mesmo build, mas isso aumenta custo, duração e superfície de falha. Em um pipeline com quatro clouds, prefira jobs paralelos e independentes. Se o build da Azure falhar, a criação da AMI não precisa ser descartada, desde que cada artefato passe pelos próprios testes. Para provedores de Cloud Server que não possuem builder oficial, verifique se existe plugin mantido e auditável. Como alternativa, um builder QEMU pode gerar uma imagem de disco, porém a importação, os drivers e a compatibilidade do formato precisam ser testados no destino.
Validação, segurança e troubleshooting do build
Uma imagem criada sem erro não está necessariamente pronta para produção. O Packer confirma que o fluxo terminou, mas não sabe se a aplicação responde, se a política de SSH foi aplicada ou se um segredo ficou salvo em /tmp. A validação precisa combinar análise estática, testes durante o build e uma inicialização posterior do artefato em ambiente isolado.
Testes antes de publicar
O primeiro nível executa packer fmt -check, packer validate e scanners sobre os arquivos HCL e scripts. O segundo nível adiciona verificações ao template, como systemctl is-enabled nginx, sshd -t, nginx -t e a confirmação de espaço livre. Em uma imagem com disco raiz de 20 GB, por exemplo, o pipeline pode falhar se restarem menos de 8 GB após a instalação. Outro teste procura arquivos sensíveis com padrões conhecidos, permissões excessivas e chaves SSH privadas.
O terceiro nível inicia uma instância usando a imagem recém-criada. Um teste pode aguardar a porta 22, consultar http://IP/health, confirmar o código 200 e verificar a versão do agente de métricas. Para imagens de workers sem endpoint HTTP, execute um comando remoto ou valide o registro no sistema de filas. Só depois disso o identificador deve receber um status de aprovado.
Na segurança, use uma identidade de CI dedicada e com menor privilégio. Ela não precisa administrar toda a conta. Restrinja redes, regiões, tipos de instância e ações de imagem. A máquina temporária deve aceitar SSH apenas do runner ou usar um mecanismo privado de conexão. Logs, manifestos e arquivos de cache precisam ter retenção definida, pois podem revelar IDs de conta, endereços e nomes internos.
Falhas comuns e diagnóstico
Se o build parar em Waiting for SSH, confira security group, rota, usuário da imagem e presença de endereço acessível. Um timeout após a instalação pode indicar reinicialização automática causada por atualização do kernel. Nesse caso, use o provisioner de pausa ou trate o reboot de forma explícita. Erros intermitentes no apt-get podem vir de locks do cloud-init; aguarde a conclusão de cloud-init status --wait antes de instalar pacotes.
Quando a captura falha no fim, verifique permissões para criar snapshots, limites da conta e políticas de criptografia. Ative PACKER_LOG=1 apenas durante o diagnóstico e revise o log antes de compartilhá-lo. O parâmetro -on-error=ask ajuda em uma sessão manual, enquanto pipelines devem encerrar e limpar recursos automaticamente para não deixar instâncias temporárias cobrando por horas.
Como integrar Packer, Terraform e CI/CD
Packer e Terraform atuam em etapas diferentes. Packer fabrica o artefato; Terraform cria redes, instâncias, grupos de escala e balanceadores que consomem esse artefato. Misturar as duas responsabilidades em um único apply dificulta aprovação e rollback. Uma imagem pode levar 15 minutos para ser criada, enquanto uma alteração de regra de firewall deveria levar segundos e não depender de um novo build.
Pipeline recomendado
Um fluxo consistente começa com uma alteração no template ou nos scripts. O CI executa formatação, validação e análise de segurança. Em seguida, cria a imagem em uma conta ou projeto de build, inicia uma instância de teste e executa verificações funcionais. Se tudo passar, o pipeline publica um manifesto com identificador, região, commit Git, checksum dos scripts, imagem base e horário da criação.
O Terraform recebe apenas uma versão aprovada. Isso pode ocorrer por variável, catálogo interno ou busca por tags exatas. Usar um filtro genérico como most_recent = true em produção facilita o consumo acidental de uma imagem ainda não homologada. Um exemplo mais previsível grava image_version = "2026.11.08-01" no repositório de infraestrutura e resolve esse valor para o ID correspondente. O guia sobre Cloud Server para Terraform e infraestrutura como código aprofunda a separação entre estado, módulos e provisionamento.
Três ambientes ajudam a reduzir risco. O build gera uma imagem candidata, staging executa testes por 30 a 60 minutos e produção recebe a promoção após aprovação. Em grupos com seis instâncias, a implantação pode substituir uma máquina, observar erros e latência durante dez minutos e continuar em lotes de duas. O rollback aponta novamente para a versão anterior, sem reinstalar pacotes em servidores ativos.
Versionamento, promoção e descarte
Nomeie imagens com aplicação, sistema, data e número incremental, como payments-ubuntu2404-20261108-02. Adicione tags para commit, pipeline, proprietário e validade. Não use apenas latest, pois esse nome não explica o conteúdo implantado. Mantenha as últimas três ou cinco versões aprovadas, além das imagens exigidas por auditoria ou rollback.
O descarte também precisa remover snapshots associados. Uma rotina semanal pode identificar artefatos sem uso há 30 dias, gerar um relatório e solicitar aprovação antes da exclusão. Nunca apague uma imagem apenas pela idade. Primeiro consulte launch templates, grupos de escala e ambientes de recuperação. Essa disciplina fecha o ciclo: build, teste, promoção, implantação, observação e retirada controlada.
Recomendações por perfil
Desenvolvedor solo
Para um projeto individual, comece com um único template HCL, um builder e dois scripts: instalação e limpeza. Execute packer init, packer fmt -check e packer validate no CI. Uma máquina temporária com 2 vCPUs e 2 a 4 GB de RAM atende instalações binárias comuns. Use variáveis de ambiente do provedor para autenticação e nunca grave tokens em *.pkrvars.hcl versionados. O primeiro caso de uso pode ser uma imagem com Docker, agente de monitoramento e usuário de deploy. Mantenha duas versões aprovadas para rollback. Evite criar abstrações para múltiplas clouds antes que exista uma necessidade concreta, pois isso adiciona manutenção sem melhorar a entrega inicial.
Equipe de engenharia
Uma equipe com vários serviços ganha mais ao criar imagens em camadas lógicas. A base corporativa pode conter hardening, certificados, sincronização de horário e observabilidade. Imagens específicas adicionam runtime Java, Node.js ou Nginx. Cada componente deve ter proprietário, testes e calendário de atualização. Separe a conta de build da produção e promova artefatos por compartilhamento controlado ou replicação. O manifesto precisa relacionar ID da imagem, commit, imagem base e resultado dos testes. Para dez ou mais serviços, adote uma convenção como servico-sistema-data-revisao e limite o acesso de publicação a pipelines protegidos. Mudanças no hardening merecem revisão de segurança antes de gerar novas bases.
Produção crítica
Em produção crítica, trate a imagem como um artefato de software assinado e rastreável. Fixe versões de plugins, valide o proprietário da imagem de origem, gere inventário dos pacotes e execute scanner de vulnerabilidades. O pipeline deve iniciar uma instância real, testar rede, SSH, aplicação, métricas e integração com o secret manager. Promova a mesma imagem testada, sem reconstruí-la entre staging e produção. Use implantação gradual, com uma instância canário e critérios mensuráveis, como taxa de erro abaixo de 1% e ausência de regressão relevante na latência. Mantenha uma versão anterior disponível e teste o rollback regularmente. Preços, limites, regiões e formatos de imagem variam entre provedores, então mudanças nesses dados exigem consulta às fontes oficiais e revisão humana.
Continue lendo
Perguntas frequentes
O Packer cria a mesma imagem para qualquer provedor cloud?
Não. O Packer permite reutilizar a lógica de construção, mas cada builder gera um artefato compatível com o provedor escolhido. Na AWS, o resultado costuma ser uma AMI com snapshots EBS. No Azure, pode ser uma Managed Image ou um recurso ligado à Compute Gallery. No Google Cloud, o resultado é uma imagem do Compute Engine. Scripts de instalação e políticas podem ser compartilhados, enquanto source, autenticação, rede e captura permanecem específicos. Essa separação oferece portabilidade operacional sem fingir que os formatos de imagem são intercambiáveis.
Qual é a diferença entre Packer, Terraform e cloud-init?
Packer cria a imagem base antes do servidor existir. Terraform provisiona recursos, como rede, instância, disco, firewall e balanceador, consumindo o ID dessa imagem. cloud-init executa no primeiro boot e aplica dados específicos da instância, como hostname, chaves públicas ou parâmetros de ambiente. Um desenho comum usa Packer para instalar Nginx e agentes, Terraform para criar o Cloud Server e cloud-init para registrar o servidor no ambiente correto. Separar essas funções reduz scripts extensos de inicialização e torna o rollback mais previsível.
É seguro passar segredos para provisioners do Packer?
Segredos podem ser usados durante o build, mas exigem controles rigorosos. Injete credenciais temporárias por um cofre ou pelas variáveis protegidas do CI, marque variáveis HCL como sensíveis e limite permissões e duração. Não armazene tokens em arquivos versionados nem use comandos que imprimam valores no log. Antes da captura, remova arquivos temporários, caches, históricos e configurações de autenticação. Depois, examine a imagem iniciando uma instância isolada. Sempre que possível, deixe credenciais permanentes fora da imagem e recupere-as de um secret manager em tempo de execução.
Como testar uma imagem criada pelo Packer antes da produção?
Comece com `packer fmt -check` e `packer validate`, depois execute testes dentro do build, como `nginx -t`, `sshd -t` e `systemctl is-enabled`. Quando a imagem for criada, inicie uma nova instância em rede isolada e valide SSH, endpoint de saúde, agentes de métricas, espaço em disco e integração com serviços externos. Um teste de produção pode exigir código HTTP 200, serviço ativo e ausência de arquivos sensíveis. Somente o identificador aprovado deve ser disponibilizado ao Terraform ou ao grupo de auto scaling.
Quanto recurso o runner de Packer precisa?
Builders de cloud executam a maior parte do trabalho em uma instância temporária no provedor. Por isso, um runner com 2 vCPUs, 2 GB de RAM e alguns gigabytes livres costuma bastar para templates HCL, plugins e scripts. A instância temporária pode precisar de 2 vCPUs e 4 GB para instalar pacotes comuns, ou 4 vCPUs e 8 GB para compilar aplicações e módulos. Builds locais com QEMU consomem mais CPU, memória e disco no runner. Meça duração, uso e custo antes de aumentar recursos permanentemente.
Com que frequência uma imagem de Cloud Server deve ser recriada?
A frequência depende da exposição e do ciclo de atualização. Uma base Linux usada na internet pode ser reconstruída semanalmente ou sempre que surgir uma correção crítica. Ambientes internos podem adotar ciclos quinzenais ou mensais, desde que vulnerabilidades graves disparem builds extraordinários. A reconstrução deve usar a mesma revisão de scripts e registrar a nova imagem base, os pacotes e os testes. Não substitua produção automaticamente apenas porque uma imagem nova existe. Primeiro valide, promova e implante gradualmente, mantendo pelo menos uma versão anterior disponível para rollback.
Fontes consultadas
- HashiCorp Developer, Packer Documentation · coletado em 08/11/2026
- HashiCorp Developer, Amazon AMI Builder · coletado em 08/11/2026
- HashiCorp Developer, Ansible Provisioner · coletado em 08/11/2026
- cloud-init Documentation, CLI Commands · coletado em 08/11/2026