Gestionar la infraestructura de la nube manualmente mediante paneles web es lento, propenso a errores y no escalable. Mientras que las herramientas tradicionales de Infraestructura como Código (IaC), como Terraform, dependen de lenguajes de configuración específicos del dominio (HCL), Pulumi le permite definir, desplegar y gestionar la infraestructura de la nube usando lenguajes de programación reales, como TypeScript/JavaScript, Python, Go, Java y C#.
En esta guía, aprenderá a instalar Pulumi en un VPS de Ubuntu o Debian, configurar sus dependencias y desplegar sus primeros recursos de la nube paso a paso.
Prepare su instancia de VPSie
- Cree una cuenta: Regístrese en el Portal de clientes de VPSie.
- Recargue su cuenta: Vaya a Facturación en el portal para añadir fondos o configurar métodos de pago.
- Despliegue un servidor: Cree una VM de Linux con Ubuntu 24.04 / 26.04 LTS o Debian 12 / 13, con al menos 2 vCPUs y 2 GB de RAM.
Actualice el sistema e instale dependencias
Garantiza que su gestor de paquetes y las actualizaciones de seguridad estén al día. Inicie sesión en su servidor mediante SSH y actualice la base de datos de paquetes del sistema:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential
Instalar los entornos de ejecución de lenguajes (Node.js y npm)
Pulumi requiere el entorno de ejecución del lenguaje que elija para su código de IaC. Instalaremos Node.js (v20 LTS):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
Verifique la instalación:
node -v
npm -v
Instalar la CLI de Pulumi mediante el script oficial
Ejecute el script de instalación automatizado de Pulumi:
curl -fsSL https://get.pulumi.com | sh
Al finalizar, actualice el entorno de su shell actual para que el terminal del sistema pueda encontrar el comando pulumi:
export PATH=$PATH:$HOME/.pulumi/bin
echo 'export PATH=$PATH:$HOME/.pulumi/bin' >> ~/.bashrc
Verifique la instalación:
pulumi version
Inicializar el estado del backend de Pulumi
Pulumi necesita rastrear el estado de su infraestructura. Puede iniciar sesión en el servicio gestionado gratuito (Pulumi Cloud) o almacenar el estado localmente en el disco de su servidor:
Backend local (autogestionado en su servidor):
pulumi login --local
Cuando inicia sesión en un backend local sin una pila activa, Pulumi le preguntará si desea crear un proyecto. Aplique e introduzca las selecciones necesarias cuando se le solicite:
- ¿Qué le gustaría hacer? Seleccione Crear un nuevo proyecto de Pulumi.
- Introduzca o cree un directorio vacío: Introduzca un nombre de directorio (p. ej., my-pulumi-app).
- ¿Qué proveedor le gustaría utilizar? Seleccione Basic Pulumi Program (o elija un proveedor de nube específico como AWS/DigitalOcean).
- ¿Qué lenguaje le gustaría utilizar? Seleccione su lenguaje preferido (p. ej., Python o TypeScript).
- Detalles del proyecto (Nombre, Descripción, Nombre de la pila): Presione Enter para aceptar los valores predeterminados (p. ej., nombre de la pila dev).
- ¿Está todo correcto? Seleccione Sí, crear el proyecto.
- Frase de contraseña: Introduzca una contraseña fuerte para cifrar los secretos locales y vuelva a introducirla para confirmar.
Cree su primer proyecto de Pulumi
Cree un nuevo directorio para su código de infraestructura e inicie un proyecto:
mkdir my-first-pulumi && cd my-first-pulumi
pulumi new aws-typescript
Siga las indicaciones interactivas de la terminal:
- Nombre del proyecto: Acepte el valor predeterminado (my-first-pulumi).
- Descripción del proyecto: Acepte el valor predeterminado o escriba un resumen breve.
- Nombre de la pila: Acepte el valor predeterminado (dev).
- Región de AWS: Elija su región más cercana (p. ej., us-east-1 o eu-central-1).
Configurar credenciales del proveedor de nube
Antes de implementar, proporcione sus claves de acceso del proveedor de nube. Por ejemplo, para configurar AWS:
export AWS_ACCESS_KEY_ID="your-access-key-here"
export AWS_SECRET_ACCESS_KEY="your-secret-key-here"
Implementar su infraestructura
Ejecute el comando de implementación dentro de su directorio de proyecto:
pulumi up
Lo que ocurre durante esta etapa:
- Pulumi compila su código TypeScript en planes de ejecución.
- Compara su código con su archivo de estado actual y muestra una Vista previa de diferencias detallada de los recursos que se crearán, modificarán o destruirán.
- Se le pregunta: ¿Desea realizar esta actualización?
- Presione Enter en yes para aplicar los cambios a su proveedor de nube.