Gerenciar infraestrutura de nuvem manualmente por meio de painéis web é lento, sujeito a erros e impossível de escalar. Enquanto ferramentas tradicionais de Infrastructure as Code (IaC), como o Terraform, dependem de linguagens de configuração específicas do domínio (HCL), o Pulumi permite definir, implantar e gerenciar infraestrutura de nuvem usando linguagens de programação reais, incluindo TypeScript/JavaScript, Python, Go, Java e C#.
Neste guia, você aprenderá a instalar o Pulumi em um VPS Ubuntu ou Debian, configurar suas dependências e implantar seus primeiros recursos de nuvem passo a passo.
Prepare sua instância VPSie
- Crie uma Conta: Registre-se no Portal do Cliente VPSie.
- Adicione Fundos à Sua Conta: Acesse a seção de Faturamento no portal para adicionar fundos ou configurar métodos de pagamento.
- Implante um Servidor: Crie uma VM Linux com Ubuntu 24.04 / 26.04 LTS ou Debian 12 / 13, com pelo menos 2 vCPUs e 2 GB de RAM.
Atualize o Sistema e Instale as Dependências
Garante que seu gerenciador de pacotes e as atualizações de segurança estejam atualizados. Entre no seu servidor via SSH e atualize o banco de dados de pacotes do sistema:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential
Instalar runtimes de linguagem (Node.js e npm)
O Pulumi requer o runtime da linguagem que você escolher para seu código IaC. Vamos instalar o Node.js (v20 LTS):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
Verifique a instalação:
node -v
npm -v
Instalar o Pulumi CLI via script oficial
Execute o script de instalação automatizado do Pulumi:
curl -fsSL https://get.pulumi.com | sh
Ao terminar, atualize o ambiente do shell atual para que o terminal do sistema encontre o comando pulumi:
export PATH=$PATH:$HOME/.pulumi/bin
echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.bashrc
Verifique a instalação:
pulumi version
Inicializar o estado do backend do Pulumi
O Pulumi precisa rastrear o estado da sua infraestrutura. Você pode fazer login no serviço gerenciado gratuito (Pulumi Cloud) ou armazenar o estado localmente no disco do seu servidor:
Backend local (autogerenciado no seu servidor):
pulumi login --local
Ao entrar em um backend local sem um stack ativo, o Pulumi perguntará se você deseja criar um projeto. Aplique e insira suas seleções necessárias quando solicitado:
- O que você gostaria de fazer? Selecione Criar um novo projeto Pulumi.
- Insira ou crie um diretório vazio: Insira um nome de diretório (ex.: my-pulumi-app).
- Qual provedor você gostaria de usar? Selecione Basic Pulumi Program (ou escolha um provedor de nuvem específico, como AWS/DigitalOcean).
- Qual linguagem você gostaria de usar? Selecione sua linguagem preferida (ex.: Python ou TypeScript).
- Detalhes do projeto (Nome, Descrição, Nome do stack): Pressione Enter para aceitar os padrões (ex.: nome do stack dev).
- Tudo parece correto? Selecione Sim, criar o projeto.
- Frase-senha: Insira uma senha forte para criptografar segredos locais e insira-a novamente para confirmar.
Crie seu primeiro projeto Pulumi
Crie um novo diretório para seu código de infraestrutura e inicialize um projeto:
mkdir my-first-pulumi && cd my-first-pulumi
pulumi new aws-typescript
Siga os prompts interativos do terminal:
- Nome do projeto: Aceite o padrão (my-first-pulumi).
- Descrição do projeto: Aceite o padrão ou escreva um breve resumo.
- Nome do stack: Aceite o padrão (dev).
- Região AWS: Escolha a região mais próxima (ex.: us-east-1 ou eu-central-1).
Configurar credenciais do provedor de nuvem
Antes de implantar, forneça suas chaves de acesso do provedor de nuvem. Por exemplo, para configurar a AWS:
export AWS_ACCESS_KEY_ID="your-access-key-here"
export AWS_SECRET_ACCESS_KEY="your-secret-key-here"
Implantar sua infraestrutura
Execute o comando de implantação dentro do diretório do seu projeto:
pulumi up
O que acontece durante esta etapa:
- O Pulumi compila seu código TypeScript em planos de execução.
- Ele compara seu código com seu arquivo de estado atual e exibe um Diff Preview detalhado dos recursos a serem criados, modificados ou destruídos.
- Você é perguntado: Deseja executar esta atualização?
- Pressione Enter em yes para aplicar as alterações ao seu provedor de nuvem.