Página inicial da VPSie

Voltar para a base de conhecimento

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:

  1. O que você gostaria de fazer? Selecione Criar um novo projeto Pulumi.
  2. Insira ou crie um diretório vazio: Insira um nome de diretório (ex.: my-pulumi-app).
  3. Qual provedor você gostaria de usar? Selecione Basic Pulumi Program (ou escolha um provedor de nuvem específico, como AWS/DigitalOcean).
  4. Qual linguagem você gostaria de usar? Selecione sua linguagem preferida (ex.: Python ou TypeScript).
  5. Detalhes do projeto (Nome, Descrição, Nome do stack): Pressione Enter para aceitar os padrões (ex.: nome do stack dev).
  6. Tudo parece correto? Selecione Sim, criar o projeto.
  7. 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:

  1. Nome do projeto: Aceite o padrão (my-first-pulumi).
  2. Descrição do projeto: Aceite o padrão ou escreva um breve resumo.
  3. Nome do stack: Aceite o padrão (dev).
  4. 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:

  1. O Pulumi compila seu código TypeScript em planos de execução.
  2. 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.
  3. Você é perguntado: Deseja executar esta atualização?
  4. Pressione Enter em yes para aplicar as alterações ao seu provedor de nuvem.

Voltar para a base de conhecimento