DEV Community: Cristian Paniagua

Primeros Pasos con AWS CDK en Windows: Guía Completa de Instalación

Cristian Paniagua — Sun, 30 Nov 2025 18:25:27 +0000

Primeros Pasos con AWS CDK en Windows: Guía Completa de Instalación

La Infraestructura como Código (IaC) ha revolucionado la forma en que gestionamos recursos en la nube, y AWS Cloud Development Kit (CDK) lo lleva al siguiente nivel al permitirte definir infraestructura usando lenguajes de programación familiares. En esta guía, te mostraré cómo configurar AWS CDK en Windows, desde la instalación hasta el despliegue de tu primer stack.

¿Qué es AWS CDK?

AWS CDK es un framework de desarrollo de software de código abierto que te permite definir infraestructura en la nube usando lenguajes de programación como TypeScript, Python, Java y C#. A diferencia de las plantillas tradicionales de CloudFormation escritas en JSON o YAML, CDK te permite aprovechar todo el poder de los lenguajes de programación, incluyendo bucles, condicionales y patrones de diseño orientado a objetos.

¿Por Qué Elegir CDK?

Seguridad de Tipos: Detecta errores en tiempo de compilación, no en tiempo de despliegue
Soporte de IDE: Obtén autocompletado, documentación en línea y herramientas de refactorización
Reutilización: Crea y comparte constructos como librerías
Menos Código Repetitivo: Escribe menos código comparado con CloudFormation puro
Abstracciones de Alto Nivel: Usa constructos predefinidos que siguen las mejores prácticas de AWS

Requisitos Previos

Antes de comenzar, asegúrate de tener:

Windows 10 o Windows 11
Una cuenta activa de AWS
Familiaridad básica con PowerShell o Command Prompt
Privilegios de administrador
Aproximadamente 15 minutos de tu tiempo

Paso 1: Instalar Node.js

AWS CDK requiere Node.js versión 14.15.0 o superior.

Descarga e instala Node.js desde el sitio web oficial:

Visita https://nodejs.org/
Descarga la versión LTS (Long Term Support)
Ejecuta el instalador y sigue el asistente de instalación
Asegúrate de marcar la opción "Automatically install the necessary tools"

Verifica la instalación (abre PowerShell o Command Prompt):

node --version
npm --version

Consejo Pro: Si necesitas gestionar múltiples versiones de Node.js, considera usar nvm-windows.

Paso 2: Instalar AWS CLI

La Interfaz de Línea de Comandos de AWS es esencial para gestionar tus credenciales y recursos de AWS.

Descarga e instala AWS CLI desde: https://aws.amazon.com/cli/

O usando winget:

winget install Amazon.AWSCLI

O usando Chocolatey (si lo tienes):

choco install awscli

Verifica la instalación:

aws --version

Paso 3: Configurar Credenciales de AWS

Ahora necesitamos configurar tus credenciales de AWS. Necesitarás tu AWS Access Key ID y Secret Access Key. Si aún no las tienes, créalas en la Consola de IAM de AWS.

Abre PowerShell o Command Prompt y ejecuta:

aws configure

Se te pedirá que ingreses:

AWS Access Key ID [None]: TU_ACCESS_KEY_ID
AWS Secret Access Key [None]: TU_SECRET_ACCESS_KEY
Default region name [None]: us-east-1
Default output format [None]: json

Nota de Seguridad: Nunca subas tus credenciales de AWS al control de versiones. Considera usar AWS IAM Identity Center (anteriormente AWS SSO) para mayor seguridad en entornos de producción.

Paso 4: Instalar AWS CDK

¡Ahora viene lo principal! Abre PowerShell o Command Prompt como Administrador e instala AWS CDK globalmente:

npm install -g aws-cdk

Verifica la instalación:

cdk --version

¡Felicidades! AWS CDK está ahora instalado en tu sistema Windows. 🎉

Paso 5: Preparar tu Entorno de AWS (Bootstrap)

Antes de poder desplegar aplicaciones CDK, necesitas preparar tu entorno de AWS. Esto crea los recursos necesarios (como un bucket S3) que CDK usa para almacenar artefactos de despliegue.

cdk bootstrap

Solo necesitas hacer esto una vez por combinación de cuenta/región de AWS.

Paso 6: Crear tu Primer Proyecto CDK

Vamos a crear un proyecto CDK simple para verificar que todo funciona correctamente.

Crear un Directorio de Proyecto

mkdir mi-primera-app-cdk
cd mi-primera-app-cdk

Inicializar una Aplicación CDK

Usaremos TypeScript para este ejemplo:

cdk init app --language typescript

Esto crea una estructura de proyecto completa con:

lib\ - Definiciones de tus stacks CDK
bin\ - Punto de entrada para tu aplicación CDK
test\ - Pruebas unitarias
package.json - Dependencias de Node.js
cdk.json - Configuración de CDK

Instalar Dependencias

npm install

Paso 7: Construir tu Primer Stack

Vamos a crear un bucket S3 simple para demostrar CDK en acción.

Abre lib\mi-primera-app-cdk-stack.ts y reemplaza su contenido con:

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class MiPrimeraAppCdkStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Crear un bucket S3 con versionado habilitado
    const bucket = new s3.Bucket(this, 'MiPrimerBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
      autoDeleteObjects: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });

    // Mostrar el nombre del bucket
    new cdk.CfnOutput(this, 'NombreBucket', {
      value: bucket.bucketName,
      description: 'El nombre del bucket S3',
    });
  }
}

¿Qué Está Pasando Aquí?

Estamos importando las librerías necesarias de CDK
Creando un bucket S3 con versionado habilitado
Estableciendo una política de eliminación para destruir el bucket cuando se elimine el stack
Habilitando la eliminación automática de objetos
Agregando cifrado del lado del servidor
Mostrando el nombre del bucket para fácil referencia

Paso 8: Sintetizar la Plantilla de CloudFormation

Antes de desplegar, veamos qué plantilla de CloudFormation genera CDK:

cdk synth

Este comando genera una plantilla de CloudFormation desde tu código CDK. Verás la salida en YAML en tu terminal.

Paso 9: Previsualizar Cambios

Antes de desplegar, es una buena práctica ver qué cambios se realizarán:

cdk diff

Paso 10: Desplegar tu Stack

Ahora el momento de la verdad—vamos a desplegar en AWS:

cdk deploy

CDK te mostrará los cambios y pedirá confirmación. Escribe y y presiona Enter.

Después de un minuto o dos, ¡tu stack estará desplegado! Verás el nombre del bucket en las salidas.

Verificar en la Consola de AWS

Dirígete a la Consola de S3 para ver tu bucket recién creado.

Hoja de Referencia de Comandos Esenciales de CDK

Aquí están los comandos que usarás con más frecuencia:

Comando	Descripción
`cdk init`	Inicializar un nuevo proyecto CDK
`cdk synth`	Sintetizar plantilla de CloudFormation
`cdk diff`	Comparar stack desplegado con estado actual
`cdk deploy`	Desplegar stack en AWS
`cdk destroy`	Eliminar stack de AWS
`cdk list`	Listar todos los stacks en la aplicación
`cdk doctor`	Verificar posibles problemas
`cdk watch`	Observar cambios y desplegar automáticamente

Paso 11: Limpiar

Para evitar incurrir en cargos, vamos a destruir el stack:

cdk destroy

Confirma escribiendo y cuando se te solicite.

Mejores Prácticas para el Desarrollo con CDK

Ahora que tienes CDK configurado, aquí hay algunas mejores prácticas a seguir:

1. Usa TypeScript para Seguridad de Tipos

TypeScript proporciona excelente soporte de IDE y detecta errores antes del despliegue:

// TypeScript detectará este error en tiempo de compilación
const bucket = new s3.Bucket(this, 'MiBucket', {
  versioned: 'yes', // ❌ Error: El tipo 'string' no es asignable al tipo 'boolean'
});

2. Organiza tus Stacks

Para proyectos más grandes, separa las responsabilidades en múltiples stacks:

// networking-stack.ts
export class NetworkingStack extends cdk.Stack { }

// database-stack.ts
export class DatabaseStack extends cdk.Stack { }

// application-stack.ts
export class ApplicationStack extends cdk.Stack { }

3. Usa Variables de Entorno

Haz que tus stacks sean reutilizables entre entornos:

const app = new cdk.App();

new MyStack(app, 'DevStack', {
  env: { account: '123456789', region: 'us-east-1' },
  stage: 'dev',
});

new MyStack(app, 'ProdStack', {
  env: { account: '987654321', region: 'us-west-2' },
  stage: 'prod',
});

4. Aprovecha los Constructos

Usa constructos de alto nivel (L2 y L3) que encapsulan mejores prácticas:

// L1 (bajo nivel) - más verboso
new s3.CfnBucket(this, 'MiBucket', {
  bucketName: 'mi-bucket',
  versioningConfiguration: {
    status: 'Enabled',
  },
});

// L2 (alto nivel) - recomendado
new s3.Bucket(this, 'MiBucket', {
  versioned: true,
});

5. Escribe Pruebas

CDK soporta pruebas unitarias desde el inicio:

import { Template } from 'aws-cdk-lib/assertions';
import * as MyStack from '../lib/my-stack';

test('Bucket S3 Creado', () => {
  const app = new cdk.App();
  const stack = new MyStack.MyStack(app, 'MyTestStack');
  const template = Template.fromStack(stack);

  template.hasResourceProperties('AWS::S3::Bucket', {
    VersioningConfiguration: {
      Status: 'Enabled',
    },
  });
});

Ejecuta las pruebas con:

npm test

Solución de Problemas Comunes

Problema: "Command not found: cdk"

Solución: Cierra y vuelve a abrir tu terminal. Si el problema persiste, verifica que la ruta global de npm esté en tu variable de entorno PATH.

Verifica la ruta global de npm:

npm config get prefix

Problema: "Need to perform AWS calls for account..."

Solución: Ejecuta cdk bootstrap para preparar tu entorno de AWS.

Problema: Errores de Permisos Denegados

Solución: Verifica que tus credenciales de AWS tengan los permisos necesarios. Para desarrollo, podrías necesitar AdministratorAccess, pero en producción, usa políticas IAM de mínimo privilegio.

Problema: Error de Política de Ejecución de PowerShell

Si obtienes un error de política de ejecución, ejecuta PowerShell como Administrador y ejecuta:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Problema: Conflictos de Versión de Node

Solución: Usa nvm-windows para gestionar versiones de Node.js:

Descarga nvm-windows desde: https://github.com/coreybutler/nvm-windows/releases
Instálalo
Úsalo para gestionar versiones de Node.js:

# Instalar Node.js 18
nvm install 18

# Usar Node.js 18
nvm use 18

Problema: Problemas con rutas largas

Si encuentras problemas con la longitud de las rutas, habilita rutas largas en Windows (ejecuta como Administrador):

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

Próximos Pasos

¡Felicidades! Ahora tienes un entorno de desarrollo de AWS CDK completamente funcional en Windows. Aquí está lo que puedes explorar a continuación:

Aprende Patrones de CDK: Visita el sitio web CDK Patterns para patrones de arquitectura comunes
Explora Constructos de AWS: Navega por el Construct Hub para constructos predefinidos
Toma el Workshop de CDK: Completa el CDK Workshop oficial
Construye Proyectos Reales: Intenta crear una API serverless, un sitio web estático o un pipeline de datos
Únete a la Comunidad: Participa en las discusiones de GitHub de AWS CDK

Recursos Útiles

Conclusión

AWS CDK transforma la gestión de infraestructura al llevar el poder de los lenguajes de programación a la infraestructura en la nube. Con CDK instalado en tu sistema Windows, ahora estás equipado para definir, desplegar y gestionar recursos de AWS usando código con el que ya estás familiarizado.

El viaje desde CloudFormation tradicional a CDK puede parecer desalentador al principio, pero los beneficios—seguridad de tipos, soporte de IDE, reutilización y menos código repetitivo—hacen que valga la pena la inversión.

¿Qué construirás con CDK? ¡Comparte tus proyectos en los comentarios! 👇

¿Te resultó útil esta guía? Sígueme para más contenido sobre AWS y DevOps. ¿Tienes preguntas? ¡Déjalas en los comentarios!

Tags: #aws #cdk #devops #infraestructura #typescript #cloudformation #iac #tutorial #windows #principiantes

Getting Started with AWS CDK on Windows: A Complete Setup Guide

Cristian Paniagua — Sun, 30 Nov 2025 18:23:44 +0000

Getting Started with AWS CDK on Windows: A Complete Setup Guide

Infrastructure as Code (IaC) has revolutionized how we manage cloud resources, and AWS Cloud Development Kit (CDK) takes it to the next level by letting you define infrastructure using familiar programming languages. In this guide, I'll walk you through setting up AWS CDK on Windows, from installation to deploying your first stack.

What is AWS CDK?

AWS CDK is an open-source software development framework that allows you to define cloud infrastructure using programming languages like TypeScript, Python, Java, and C#. Unlike traditional CloudFormation templates written in JSON or YAML, CDK lets you leverage the full power of programming languages—including loops, conditionals, and object-oriented design patterns.

Why Choose CDK?

Type Safety: Catch errors at compile time, not deployment time
IDE Support: Get autocomplete, inline documentation, and refactoring tools
Reusability: Create and share constructs as libraries
Less Boilerplate: Write less code compared to raw CloudFormation
Higher-Level Abstractions: Use pre-built constructs that follow AWS best practices

Prerequisites

Before we dive in, make sure you have:

Windows 10 or Windows 11
An active AWS account
Basic familiarity with PowerShell or Command Prompt
Administrator privileges
About 15 minutes of your time

Step 1: Install Node.js

AWS CDK requires Node.js version 14.15.0 or higher.

Download and install Node.js from the official website:

Visit https://nodejs.org/
Download the LTS (Long Term Support) version
Run the installer and follow the installation wizard
Make sure to check "Automatically install the necessary tools" option

Verify the installation (open PowerShell or Command Prompt):

node --version
npm --version

Pro Tip: If you need to manage multiple Node.js versions, consider using nvm-windows.

Step 2: Install AWS CLI

The AWS Command Line Interface is essential for managing your AWS credentials and resources.

Download and install AWS CLI from: https://aws.amazon.com/cli/

Or using winget:

winget install Amazon.AWSCLI

Or using Chocolatey (if you have it):

choco install awscli

Verify the installation:

aws --version

Step 3: Configure AWS Credentials

Now we need to configure your AWS credentials. You'll need your AWS Access Key ID and Secret Access Key. If you don't have these yet, create them in the AWS IAM Console.

Open PowerShell or Command Prompt and run:

aws configure

You'll be prompted to enter:

AWS Access Key ID [None]: YOUR_ACCESS_KEY_ID
AWS Secret Access Key [None]: YOUR_SECRET_ACCESS_KEY
Default region name [None]: us-east-1
Default output format [None]: json

Security Note: Never commit your AWS credentials to version control. Consider using AWS IAM Identity Center (formerly AWS SSO) for enhanced security in production environments.

Step 4: Install AWS CDK

Now for the main event! Open PowerShell or Command Prompt as Administrator and install AWS CDK globally:

npm install -g aws-cdk

Verify the installation:

cdk --version

Congratulations! AWS CDK is now installed on your Windows system. 🎉

Step 5: Bootstrap Your AWS Environment

Before you can deploy CDK apps, you need to bootstrap your AWS environment. This creates the necessary resources (like an S3 bucket) that CDK uses to store deployment artifacts.

cdk bootstrap

You only need to do this once per AWS account/region combination.

Step 6: Create Your First CDK Project

Let's create a simple CDK project to verify everything is working correctly.

Create a Project Directory

mkdir my-first-cdk-app
cd my-first-cdk-app

Initialize a CDK App

We'll use TypeScript for this example:

cdk init app --language typescript

This creates a complete project structure with:

lib\ - Your CDK stack definitions
bin\ - The entry point for your CDK app
test\ - Unit tests
package.json - Node.js dependencies
cdk.json - CDK configuration

Install Dependencies

npm install

Step 7: Build Your First Stack

Let's create a simple S3 bucket to demonstrate CDK in action.

Open lib\my-first-cdk-app-stack.ts and replace its contents with:

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class MyFirstCdkAppStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Create an S3 bucket with versioning enabled
    const bucket = new s3.Bucket(this, 'MyFirstBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
      autoDeleteObjects: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });

    // Output the bucket name
    new cdk.CfnOutput(this, 'BucketName', {
      value: bucket.bucketName,
      description: 'The name of the S3 bucket',
    });
  }
}

What's Happening Here?

We're importing the necessary CDK libraries
Creating an S3 bucket with versioning enabled
Setting a removal policy to destroy the bucket when the stack is deleted
Enabling automatic object deletion
Adding server-side encryption
Outputting the bucket name for easy reference

Step 8: Synthesize CloudFormation Template

Before deploying, let's see what CloudFormation template CDK generates:

cdk synth

This command generates a CloudFormation template from your CDK code. You'll see YAML output in your terminal.

Step 9: Preview Changes

Before deploying, it's good practice to see what changes will be made:

cdk diff

Step 10: Deploy Your Stack

Now for the moment of truth—let's deploy to AWS:

cdk deploy

CDK will show you the changes and ask for confirmation. Type y and press Enter.

After a minute or two, your stack will be deployed! You'll see the bucket name in the outputs.

Verify in AWS Console

Head over to the S3 Console to see your newly created bucket.

Essential CDK Commands Cheat Sheet

Here are the commands you'll use most often:

Command	Description
`cdk init`	Initialize a new CDK project
`cdk synth`	Synthesize CloudFormation template
`cdk diff`	Compare deployed stack with current state
`cdk deploy`	Deploy stack to AWS
`cdk destroy`	Delete stack from AWS
`cdk list`	List all stacks in the app
`cdk doctor`	Check for potential problems
`cdk watch`	Watch for changes and deploy automatically

Step 11: Clean Up

To avoid incurring charges, let's destroy the stack:

cdk destroy

Confirm by typing y when prompted.

Best Practices for CDK Development

Now that you have CDK set up, here are some best practices to follow:

1. Use TypeScript for Type Safety

TypeScript provides excellent IDE support and catches errors before deployment:

// TypeScript will catch this error at compile time
const bucket = new s3.Bucket(this, 'MyBucket', {
  versioned: 'yes', // ❌ Error: Type 'string' is not assignable to type 'boolean'
});

2. Organize Your Stacks

For larger projects, separate concerns into multiple stacks:

// networking-stack.ts
export class NetworkingStack extends cdk.Stack { }

// database-stack.ts
export class DatabaseStack extends cdk.Stack { }

// application-stack.ts
export class ApplicationStack extends cdk.Stack { }

3. Use Environment Variables

Make your stacks reusable across environments:

const app = new cdk.App();

new MyStack(app, 'DevStack', {
  env: { account: '123456789', region: 'us-east-1' },
  stage: 'dev',
});

new MyStack(app, 'ProdStack', {
  env: { account: '987654321', region: 'us-west-2' },
  stage: 'prod',
});

4. Leverage Constructs

Use high-level constructs (L2 and L3) that encapsulate best practices:

// L1 (low-level) - more verbose
new s3.CfnBucket(this, 'MyBucket', {
  bucketName: 'my-bucket',
  versioningConfiguration: {
    status: 'Enabled',
  },
});

// L2 (high-level) - recommended
new s3.Bucket(this, 'MyBucket', {
  versioned: true,
});

5. Write Tests

CDK supports unit testing out of the box:

import { Template } from 'aws-cdk-lib/assertions';
import * as MyStack from '../lib/my-stack';

test('S3 Bucket Created', () => {
  const app = new cdk.App();
  const stack = new MyStack.MyStack(app, 'MyTestStack');
  const template = Template.fromStack(stack);

  template.hasResourceProperties('AWS::S3::Bucket', {
    VersioningConfiguration: {
      Status: 'Enabled',
    },
  });
});

Run tests with:

npm test

Troubleshooting Common Issues

Issue: "Command not found: cdk"

Solution: Close and reopen your terminal. If the issue persists, verify npm global path is in your PATH environment variable.

Check npm global path:

npm config get prefix

Issue: "Need to perform AWS calls for account..."

Solution: Run cdk bootstrap to prepare your AWS environment.

Issue: Permission Denied Errors

Solution: Verify your AWS credentials have the necessary permissions. For development, you might need AdministratorAccess, but in production, use least-privilege IAM policies.

Issue: PowerShell Execution Policy Error

If you get an execution policy error, run PowerShell as Administrator and execute:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Issue: Node Version Conflicts

Solution: Use nvm-windows to manage Node.js versions:

Download nvm-windows from: https://github.com/coreybutler/nvm-windows/releases
Install it
Use it to manage Node.js versions:

# Install Node.js 18
nvm install 18

# Use Node.js 18
nvm use 18

Issue: Long path issues

If you encounter path length issues, enable long paths in Windows (run as Administrator):

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

Next Steps

Congratulations! You now have a fully functional AWS CDK development environment on Windows. Here's what you can explore next:

Learn CDK Patterns: Check out the CDK Patterns website for common architecture patterns
Explore AWS Constructs: Browse the Construct Hub for pre-built constructs
Take the CDK Workshop: Complete the official CDK Workshop
Build Real Projects: Try creating a serverless API, a static website, or a data pipeline
Join the Community: Participate in the AWS CDK GitHub discussions

Useful Resources

Conclusion

AWS CDK transforms infrastructure management by bringing the power of programming languages to cloud infrastructure. With CDK installed on your Windows system, you're now equipped to define, deploy, and manage AWS resources using code you're already familiar with.

The journey from traditional CloudFormation to CDK might seem daunting at first, but the benefits—type safety, IDE support, reusability, and less boilerplate—make it well worth the investment.

What will you build with CDK? Share your projects in the comments below! 👇

Found this guide helpful? Follow me for more AWS and DevOps content. Have questions? Drop them in the comments!

Tags: #aws #cdk #devops #infrastructure #typescript #cloudformation #iac #tutorial #windows #beginners

Primeros Pasos con AWS CDK en macOS: Guía Completa de Instalación

Cristian Paniagua — Sun, 30 Nov 2025 18:17:50 +0000

Primeros Pasos con AWS CDK en macOS: Guía Completa de Instalación

La Infraestructura como Código (IaC) ha revolucionado la forma en que gestionamos recursos en la nube, y AWS Cloud Development Kit (CDK) lo lleva al siguiente nivel al permitirte definir infraestructura usando lenguajes de programación familiares. En esta guía, te mostraré cómo configurar AWS CDK en macOS, desde la instalación hasta el despliegue de tu primer stack.

¿Qué es AWS CDK?

¿Por Qué Elegir CDK?

Seguridad de Tipos: Detecta errores en tiempo de compilación, no en tiempo de despliegue
Soporte de IDE: Obtén autocompletado, documentación en línea y herramientas de refactorización
Reutilización: Crea y comparte constructos como librerías
Menos Código Repetitivo: Escribe menos código comparado con CloudFormation puro
Abstracciones de Alto Nivel: Usa constructos predefinidos que siguen las mejores prácticas de AWS

Requisitos Previos

Antes de comenzar, asegúrate de tener:

Una Mac con macOS (esta guía funciona tanto para Intel como Apple Silicon)
Una cuenta activa de AWS
Familiaridad básica con la terminal
Aproximadamente 15 minutos de tu tiempo

Paso 1: Instalar Homebrew (Si Aún No Lo Tienes)

Homebrew es el gestor de paquetes para macOS que facilita la instalación de herramientas de desarrollo.

Abre la Terminal y ejecuta:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Después de la instalación, verifica que funciona:

brew --version

Paso 2: Instalar Node.js

AWS CDK requiere Node.js versión 14.15.0 o superior. Instalaremos la última versión LTS usando Homebrew.

brew install node

Verifica la instalación:

node --version
npm --version

Deberías ver los números de versión tanto de Node.js como de npm.

Consejo Pro: Si necesitas gestionar múltiples versiones de Node.js, considera usar nvm (Node Version Manager).

Paso 3: Instalar AWS CLI

La Interfaz de Línea de Comandos de AWS es esencial para gestionar tus credenciales y recursos de AWS.

brew install awscli

Verifica la instalación:

aws --version

Paso 4: Configurar Credenciales de AWS

Ahora necesitamos configurar tus credenciales de AWS. Necesitarás tu AWS Access Key ID y Secret Access Key. Si aún no las tienes, créalas en la Consola de IAM de AWS.

Ejecuta el comando de configuración:

aws configure

Se te pedirá que ingreses:

AWS Access Key ID [None]: TU_ACCESS_KEY_ID
AWS Secret Access Key [None]: TU_SECRET_ACCESS_KEY
Default region name [None]: us-east-1
Default output format [None]: json

Nota de Seguridad: Nunca subas tus credenciales de AWS al control de versiones. Considera usar AWS IAM Identity Center (anteriormente AWS SSO) para mayor seguridad en entornos de producción.

Paso 5: Instalar AWS CDK

¡Ahora viene lo principal! Instala el CLI de AWS CDK globalmente usando npm:

npm install -g aws-cdk

Verifica la instalación:

cdk --version

¡Felicidades! AWS CDK está ahora instalado en tu Mac. 🎉

Paso 6: Preparar tu Entorno de AWS (Bootstrap)

Antes de poder desplegar aplicaciones CDK, necesitas preparar tu entorno de AWS. Esto crea los recursos necesarios (como un bucket S3) que CDK usa para almacenar artefactos de despliegue.

cdk bootstrap aws://NUMERO-CUENTA/REGION

O simplemente:

cdk bootstrap

Esto usará tu cuenta y región predeterminadas de AWS de tu configuración de AWS CLI.

Solo necesitas hacer esto una vez por combinación de cuenta/región de AWS.

Paso 7: Crear tu Primer Proyecto CDK

Vamos a crear un proyecto CDK simple para verificar que todo funciona correctamente.

Crear un Directorio de Proyecto

mkdir mi-primera-app-cdk
cd mi-primera-app-cdk

Inicializar una Aplicación CDK

Usaremos TypeScript para este ejemplo:

cdk init app --language typescript

Esto crea una estructura de proyecto completa con:

lib/ - Definiciones de tus stacks CDK
bin/ - Punto de entrada para tu aplicación CDK
test/ - Pruebas unitarias
package.json - Dependencias de Node.js
cdk.json - Configuración de CDK

Instalar Dependencias

npm install

Paso 8: Construir tu Primer Stack

Vamos a crear un bucket S3 simple para demostrar CDK en acción.

Abre lib/mi-primera-app-cdk-stack.ts y reemplaza su contenido con:

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class MiPrimeraAppCdkStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Crear un bucket S3 con versionado habilitado
    const bucket = new s3.Bucket(this, 'MiPrimerBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
      autoDeleteObjects: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });

    // Mostrar el nombre del bucket
    new cdk.CfnOutput(this, 'NombreBucket', {
      value: bucket.bucketName,
      description: 'El nombre del bucket S3',
    });
  }
}

¿Qué Está Pasando Aquí?

Estamos importando las librerías necesarias de CDK
Creando un bucket S3 con versionado habilitado
Estableciendo una política de eliminación para destruir el bucket cuando se elimine el stack
Habilitando la eliminación automática de objetos
Agregando cifrado del lado del servidor
Mostrando el nombre del bucket para fácil referencia

Paso 9: Sintetizar la Plantilla de CloudFormation

Antes de desplegar, veamos qué plantilla de CloudFormation genera CDK:

cdk synth

Este comando genera una plantilla de CloudFormation desde tu código CDK. Verás la salida en YAML en tu terminal.

Paso 10: Previsualizar Cambios

Antes de desplegar, es una buena práctica ver qué cambios se realizarán:

cdk diff

Paso 11: Desplegar tu Stack

Ahora el momento de la verdad—vamos a desplegar en AWS:

cdk deploy

CDK te mostrará los cambios y pedirá confirmación. Escribe y y presiona Enter.

Después de un minuto o dos, ¡tu stack estará desplegado! Verás el nombre del bucket en las salidas.

Verificar en la Consola de AWS

Dirígete a la Consola de S3 para ver tu bucket recién creado.

Hoja de Referencia de Comandos Esenciales de CDK

Aquí están los comandos que usarás con más frecuencia:

Comando	Descripción
`cdk init`	Inicializar un nuevo proyecto CDK
`cdk synth`	Sintetizar plantilla de CloudFormation
`cdk diff`	Comparar stack desplegado con estado actual
`cdk deploy`	Desplegar stack en AWS
`cdk destroy`	Eliminar stack de AWS
`cdk list`	Listar todos los stacks en la aplicación
`cdk doctor`	Verificar posibles problemas
`cdk watch`	Observar cambios y desplegar automáticamente

Paso 12: Limpiar

Para evitar incurrir en cargos, vamos a destruir el stack:

cdk destroy

Confirma escribiendo y cuando se te solicite.

Mejores Prácticas para el Desarrollo con CDK

Ahora que tienes CDK configurado, aquí hay algunas mejores prácticas a seguir:

1. Usa TypeScript para Seguridad de Tipos

TypeScript proporciona excelente soporte de IDE y detecta errores antes del despliegue:

// TypeScript detectará este error en tiempo de compilación
const bucket = new s3.Bucket(this, 'MiBucket', {
  versioned: 'yes', // ❌ Error: El tipo 'string' no es asignable al tipo 'boolean'
});

2. Organiza tus Stacks

Para proyectos más grandes, separa las responsabilidades en múltiples stacks:

// networking-stack.ts
export class NetworkingStack extends cdk.Stack { }

// database-stack.ts
export class DatabaseStack extends cdk.Stack { }

// application-stack.ts
export class ApplicationStack extends cdk.Stack { }

3. Usa Variables de Entorno

Haz que tus stacks sean reutilizables entre entornos:

const app = new cdk.App();

new MyStack(app, 'DevStack', {
  env: { account: '123456789', region: 'us-east-1' },
  stage: 'dev',
});

new MyStack(app, 'ProdStack', {
  env: { account: '987654321', region: 'us-west-2' },
  stage: 'prod',
});

4. Aprovecha los Constructos

Usa constructos de alto nivel (L2 y L3) que encapsulan mejores prácticas:

// L1 (bajo nivel) - más verboso
new s3.CfnBucket(this, 'MiBucket', {
  bucketName: 'mi-bucket',
  versioningConfiguration: {
    status: 'Enabled',
  },
});

// L2 (alto nivel) - recomendado
new s3.Bucket(this, 'MiBucket', {
  versioned: true,
});

5. Escribe Pruebas

CDK soporta pruebas unitarias desde el inicio:

import { Template } from 'aws-cdk-lib/assertions';
import * as MyStack from '../lib/my-stack';

test('Bucket S3 Creado', () => {
  const app = new cdk.App();
  const stack = new MyStack.MyStack(app, 'MyTestStack');
  const template = Template.fromStack(stack);

  template.hasResourceProperties('AWS::S3::Bucket', {
    VersioningConfiguration: {
      Status: 'Enabled',
    },
  });
});

Ejecuta las pruebas con:

npm test

6. Usa el Contexto de CDK

Almacena valores de configuración en cdk.json:

{
  "context": {
    "nombreApp": "mi-app",
    "entorno": "produccion"
  }
}

Accede en tu código:

const nombreApp = this.node.tryGetContext('nombreApp');

Solución de Problemas Comunes

Problema: "Command not found: cdk"

Solución: Asegúrate de que el directorio bin global de npm esté en tu PATH:

echo 'export PATH="$HOME/.npm-packages/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Problema: "Need to perform AWS calls for account..."

Solución: Ejecuta cdk bootstrap para preparar tu entorno de AWS.

Problema: Errores de Permisos Denegados

Problema: Conflictos de Versión de Node

Solución: Usa nvm para gestionar versiones de Node.js:

brew install nvm
nvm install 18
nvm use 18

Próximos Pasos

¡Felicidades! Ahora tienes un entorno de desarrollo de AWS CDK completamente funcional en tu Mac. Aquí está lo que puedes explorar a continuación:

Aprende Patrones de CDK: Visita el sitio web CDK Patterns para patrones de arquitectura comunes
Explora Constructos de AWS: Navega por el Construct Hub para constructos predefinidos
Toma el Workshop de CDK: Completa el CDK Workshop oficial
Construye Proyectos Reales: Intenta crear una API serverless, un sitio web estático o un pipeline de datos
Únete a la Comunidad: Participa en las discusiones de GitHub de AWS CDK

Recursos Útiles

Conclusión

AWS CDK transforma la gestión de infraestructura al llevar el poder de los lenguajes de programación a la infraestructura en la nube. Con CDK instalado en tu Mac, ahora estás equipado para definir, desplegar y gestionar recursos de AWS usando código con el que ya estás familiarizado.

¿Qué construirás con CDK? ¡Comparte tus proyectos en los comentarios! 👇

¿Te resultó útil esta guía? Sígueme para más contenido sobre AWS y DevOps. ¿Tienes preguntas? ¡Déjalas en los comentarios!

Tags: #aws #cdk #devops #infraestructura #typescript #cloudformation #iac #tutorial #macos #principiantes

Getting Started with AWS CDK on macOS: A Complete Setup Guide

Cristian Paniagua — Sun, 30 Nov 2025 18:15:23 +0000

Getting Started with AWS CDK on macOS: A Complete Setup Guide

Infrastructure as Code (IaC) has revolutionized how we manage cloud resources, and AWS Cloud Development Kit (CDK) takes it to the next level by letting you define infrastructure using familiar programming languages. In this guide, I'll walk you through setting up AWS CDK on macOS, from installation to deploying your first stack.

What is AWS CDK?

Why Choose CDK?

Type Safety: Catch errors at compile time, not deployment time
IDE Support: Get autocomplete, inline documentation, and refactoring tools
Reusability: Create and share constructs as libraries
Less Boilerplate: Write less code compared to raw CloudFormation
Higher-Level Abstractions: Use pre-built constructs that follow AWS best practices

Prerequisites

Before we dive in, make sure you have:

A Mac running macOS (this guide works for both Intel and Apple Silicon)
An active AWS account
Basic familiarity with the terminal
About 15 minutes of your time

Step 1: Install Homebrew (If You Haven't Already)

Homebrew is the package manager for macOS that makes installing development tools a breeze.

Open Terminal and run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

After installation, verify it's working:

brew --version

Step 2: Install Node.js

AWS CDK requires Node.js version 14.15.0 or higher. We'll install the latest LTS version using Homebrew.

brew install node

Verify the installation:

node --version
npm --version

You should see version numbers for both Node.js and npm.

Pro Tip: If you need to manage multiple Node.js versions, consider using nvm (Node Version Manager) instead.

Step 3: Install AWS CLI

The AWS Command Line Interface is essential for managing your AWS credentials and resources.

brew install awscli

Verify the installation:

aws --version

Step 4: Configure AWS Credentials

Now we need to configure your AWS credentials. You'll need your AWS Access Key ID and Secret Access Key. If you don't have these yet, create them in the AWS IAM Console.

Run the configuration command:

aws configure

You'll be prompted to enter:

AWS Access Key ID [None]: YOUR_ACCESS_KEY_ID
AWS Secret Access Key [None]: YOUR_SECRET_ACCESS_KEY
Default region name [None]: us-east-1
Default output format [None]: json

Security Note: Never commit your AWS credentials to version control. Consider using AWS IAM Identity Center (formerly AWS SSO) for enhanced security in production environments.

Step 5: Install AWS CDK

Now for the main event! Install the AWS CDK CLI globally using npm:

npm install -g aws-cdk

Verify the installation:

cdk --version

Congratulations! AWS CDK is now installed on your Mac. 🎉

Step 6: Bootstrap Your AWS Environment

Before you can deploy CDK apps, you need to bootstrap your AWS environment. This creates the necessary resources (like an S3 bucket) that CDK uses to store deployment artifacts.

cdk bootstrap aws://ACCOUNT-NUMBER/REGION

Or simply:

cdk bootstrap

This will use your default AWS account and region from your AWS CLI configuration.

You only need to do this once per AWS account/region combination.

Step 7: Create Your First CDK Project

Let's create a simple CDK project to verify everything is working correctly.

Create a Project Directory

mkdir my-first-cdk-app
cd my-first-cdk-app

Initialize a CDK App

We'll use TypeScript for this example:

cdk init app --language typescript

This creates a complete project structure with:

lib/ - Your CDK stack definitions
bin/ - The entry point for your CDK app
test/ - Unit tests
package.json - Node.js dependencies
cdk.json - CDK configuration

Install Dependencies

npm install

Step 8: Build Your First Stack

Let's create a simple S3 bucket to demonstrate CDK in action.

Open lib/my-first-cdk-app-stack.ts and replace its contents with:

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class MyFirstCdkAppStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Create an S3 bucket with versioning enabled
    const bucket = new s3.Bucket(this, 'MyFirstBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
      autoDeleteObjects: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });

    // Output the bucket name
    new cdk.CfnOutput(this, 'BucketName', {
      value: bucket.bucketName,
      description: 'The name of the S3 bucket',
    });
  }
}

What's Happening Here?

We're importing the necessary CDK libraries
Creating an S3 bucket with versioning enabled
Setting a removal policy to destroy the bucket when the stack is deleted
Enabling automatic object deletion
Adding server-side encryption
Outputting the bucket name for easy reference

Step 9: Synthesize CloudFormation Template

Before deploying, let's see what CloudFormation template CDK generates:

cdk synth

This command generates a CloudFormation template from your CDK code. You'll see YAML output in your terminal.

Step 10: Preview Changes

Before deploying, it's good practice to see what changes will be made:

cdk diff

Step 11: Deploy Your Stack

Now for the moment of truth—let's deploy to AWS:

cdk deploy

CDK will show you the changes and ask for confirmation. Type y and press Enter.

After a minute or two, your stack will be deployed! You'll see the bucket name in the outputs.

Verify in AWS Console

Head over to the S3 Console to see your newly created bucket.

Essential CDK Commands Cheat Sheet

Here are the commands you'll use most often:

Command	Description
`cdk init`	Initialize a new CDK project
`cdk synth`	Synthesize CloudFormation template
`cdk diff`	Compare deployed stack with current state
`cdk deploy`	Deploy stack to AWS
`cdk destroy`	Delete stack from AWS
`cdk list`	List all stacks in the app
`cdk doctor`	Check for potential problems
`cdk watch`	Watch for changes and deploy automatically

Step 12: Clean Up

To avoid incurring charges, let's destroy the stack:

cdk destroy

Confirm by typing y when prompted.

Best Practices for CDK Development

Now that you have CDK set up, here are some best practices to follow:

1. Use TypeScript for Type Safety

TypeScript provides excellent IDE support and catches errors before deployment:

// TypeScript will catch this error at compile time
const bucket = new s3.Bucket(this, 'MyBucket', {
  versioned: 'yes', // ❌ Error: Type 'string' is not assignable to type 'boolean'
});

2. Organize Your Stacks

For larger projects, separate concerns into multiple stacks:

// networking-stack.ts
export class NetworkingStack extends cdk.Stack { }

// database-stack.ts
export class DatabaseStack extends cdk.Stack { }

// application-stack.ts
export class ApplicationStack extends cdk.Stack { }

3. Use Environment Variables

Make your stacks reusable across environments:

const app = new cdk.App();

new MyStack(app, 'DevStack', {
  env: { account: '123456789', region: 'us-east-1' },
  stage: 'dev',
});

new MyStack(app, 'ProdStack', {
  env: { account: '987654321', region: 'us-west-2' },
  stage: 'prod',
});

4. Leverage Constructs

Use high-level constructs (L2 and L3) that encapsulate best practices:

// L1 (low-level) - more verbose
new s3.CfnBucket(this, 'MyBucket', {
  bucketName: 'my-bucket',
  versioningConfiguration: {
    status: 'Enabled',
  },
});

// L2 (high-level) - recommended
new s3.Bucket(this, 'MyBucket', {
  versioned: true,
});

5. Write Tests

CDK supports unit testing out of the box:

import { Template } from 'aws-cdk-lib/assertions';
import * as MyStack from '../lib/my-stack';

test('S3 Bucket Created', () => {
  const app = new cdk.App();
  const stack = new MyStack.MyStack(app, 'MyTestStack');
  const template = Template.fromStack(stack);

  template.hasResourceProperties('AWS::S3::Bucket', {
    VersioningConfiguration: {
      Status: 'Enabled',
    },
  });
});

Run tests with:

npm test

6. Use CDK Context

Store configuration values in cdk.json:

{
  "context": {
    "appName": "my-app",
    "environment": "production"
  }
}

Access in your code:

const appName = this.node.tryGetContext('appName');

Troubleshooting Common Issues

Issue: "Command not found: cdk"

Solution: Make sure npm's global bin directory is in your PATH:

echo 'export PATH="$HOME/.npm-packages/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Issue: "Need to perform AWS calls for account..."

Solution: Run cdk bootstrap to prepare your AWS environment.

Issue: Permission Denied Errors

Solution: Verify your AWS credentials have the necessary permissions. For development, you might need AdministratorAccess, but in production, use least-privilege IAM policies.

Issue: Node Version Conflicts

Solution: Use nvm to manage Node.js versions:

brew install nvm
nvm install 18
nvm use 18

Next Steps

Congratulations! You now have a fully functional AWS CDK development environment on your Mac. Here's what you can explore next:

Learn CDK Patterns: Check out the CDK Patterns website for common architecture patterns
Explore AWS Constructs: Browse the Construct Hub for pre-built constructs
Take the CDK Workshop: Complete the official CDK Workshop
Build Real Projects: Try creating a serverless API, a static website, or a data pipeline
Join the Community: Participate in the AWS CDK GitHub discussions

Useful Resources

Conclusion

AWS CDK transforms infrastructure management by bringing the power of programming languages to cloud infrastructure. With CDK installed on your Mac, you're now equipped to define, deploy, and manage AWS resources using code you're already familiar with.

The journey from traditional CloudFormation to CDK might seem daunting at first, but the benefits—type safety, IDE support, reusability, and less boilerplate—make it well worth the investment.

What will you build with CDK? Share your projects in the comments below! 👇

Found this guide helpful? Follow me for more AWS and DevOps content. Have questions? Drop them in the comments!

Tags: #aws #cdk #devops #infrastructure #typescript #cloudformation #iac #tutorial #macos #beginners

Primeros Pasos con AWS CDK en Linux: Guía Completa de Instalación

Cristian Paniagua — Sun, 30 Nov 2025 18:08:21 +0000

Primeros Pasos con AWS CDK en Linux: Guía Completa de Instalación

La Infraestructura como Código (IaC) ha revolucionado la forma en que gestionamos recursos en la nube, y AWS Cloud Development Kit (CDK) lo lleva al siguiente nivel al permitirte definir infraestructura usando lenguajes de programación familiares. En esta guía, te mostraré cómo configurar AWS CDK en Linux, desde la instalación hasta el despliegue de tu primer stack.

¿Qué es AWS CDK?

¿Por Qué Elegir CDK?

Seguridad de Tipos: Detecta errores en tiempo de compilación, no en tiempo de despliegue
Soporte de IDE: Obtén autocompletado, documentación en línea y herramientas de refactorización
Reutilización: Crea y comparte constructos como librerías
Menos Código Repetitivo: Escribe menos código comparado con CloudFormation puro
Abstracciones de Alto Nivel: Usa constructos predefinidos que siguen las mejores prácticas de AWS

Requisitos Previos

Antes de comenzar, asegúrate de tener:

Un sistema Linux (Ubuntu, Debian, Fedora, CentOS o Arch)
Una cuenta activa de AWS
Familiaridad básica con la terminal
Privilegios sudo
Aproximadamente 15 minutos de tu tiempo

Paso 1: Instalar Node.js

AWS CDK requiere Node.js versión 14.15.0 o superior.

Ubuntu/Debian

# Actualizar índice de paquetes
sudo apt update

# Instalar Node.js y npm
sudo apt install nodejs npm -y

# O instalar la última versión LTS usando NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install nodejs -y

Fedora/RHEL/CentOS

# Instalar Node.js y npm
sudo dnf install nodejs npm -y

# O usando NodeSource
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install nodejs -y

Arch Linux

sudo pacman -S nodejs npm

Verifica la instalación:

node --version
npm --version

Consejo Pro: Si necesitas gestionar múltiples versiones de Node.js, considera usar nvm (Node Version Manager).

Paso 2: Instalar AWS CLI

La Interfaz de Línea de Comandos de AWS es esencial para gestionar tus credenciales y recursos de AWS.

Ubuntu/Debian

sudo apt install awscli -y

Fedora/RHEL/CentOS

sudo dnf install awscli -y

Usando pip (todas las distribuciones)

pip3 install awscli --user

Verifica la instalación:

aws --version

Paso 3: Configurar Credenciales de AWS

Ahora necesitamos configurar tus credenciales de AWS. Necesitarás tu AWS Access Key ID y Secret Access Key. Si aún no las tienes, créalas en la Consola de IAM de AWS.

Ejecuta el comando de configuración:

aws configure

Se te pedirá que ingreses:

AWS Access Key ID [None]: TU_ACCESS_KEY_ID
AWS Secret Access Key [None]: TU_SECRET_ACCESS_KEY
Default region name [None]: us-east-1
Default output format [None]: json

Nota de Seguridad: Nunca subas tus credenciales de AWS al control de versiones. Considera usar AWS IAM Identity Center (anteriormente AWS SSO) para mayor seguridad en entornos de producción.

Paso 4: Instalar AWS CDK

¡Ahora viene lo principal! Instala el CLI de AWS CDK globalmente usando npm:

sudo npm install -g aws-cdk

Verifica la instalación:

cdk --version

¡Felicidades! AWS CDK está ahora instalado en tu sistema Linux. 🎉

Paso 5: Preparar tu Entorno de AWS (Bootstrap)

Antes de poder desplegar aplicaciones CDK, necesitas preparar tu entorno de AWS. Esto crea los recursos necesarios (como un bucket S3) que CDK usa para almacenar artefactos de despliegue.

cdk bootstrap

Solo necesitas hacer esto una vez por combinación de cuenta/región de AWS.

Paso 6: Crear tu Primer Proyecto CDK

Vamos a crear un proyecto CDK simple para verificar que todo funciona correctamente.

Crear un Directorio de Proyecto

mkdir mi-primera-app-cdk
cd mi-primera-app-cdk

Inicializar una Aplicación CDK

Usaremos TypeScript para este ejemplo:

cdk init app --language typescript

Esto crea una estructura de proyecto completa con:

lib/ - Definiciones de tus stacks CDK
bin/ - Punto de entrada para tu aplicación CDK
test/ - Pruebas unitarias
package.json - Dependencias de Node.js
cdk.json - Configuración de CDK

Instalar Dependencias

npm install

Paso 7: Construir tu Primer Stack

Vamos a crear un bucket S3 simple para demostrar CDK en acción.

Abre lib/mi-primera-app-cdk-stack.ts y reemplaza su contenido con:

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class MiPrimeraAppCdkStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Crear un bucket S3 con versionado habilitado
    const bucket = new s3.Bucket(this, 'MiPrimerBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
      autoDeleteObjects: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });

    // Mostrar el nombre del bucket
    new cdk.CfnOutput(this, 'NombreBucket', {
      value: bucket.bucketName,
      description: 'El nombre del bucket S3',
    });
  }
}

¿Qué Está Pasando Aquí?

Estamos importando las librerías necesarias de CDK
Creando un bucket S3 con versionado habilitado
Estableciendo una política de eliminación para destruir el bucket cuando se elimine el stack
Habilitando la eliminación automática de objetos
Agregando cifrado del lado del servidor
Mostrando el nombre del bucket para fácil referencia

Paso 8: Sintetizar la Plantilla de CloudFormation

Antes de desplegar, veamos qué plantilla de CloudFormation genera CDK:

cdk synth

Este comando genera una plantilla de CloudFormation desde tu código CDK. Verás la salida en YAML en tu terminal.

Paso 9: Previsualizar Cambios

Antes de desplegar, es una buena práctica ver qué cambios se realizarán:

cdk diff

Paso 10: Desplegar tu Stack

Ahora el momento de la verdad—vamos a desplegar en AWS:

cdk deploy

CDK te mostrará los cambios y pedirá confirmación. Escribe y y presiona Enter.

Después de un minuto o dos, ¡tu stack estará desplegado! Verás el nombre del bucket en las salidas.

Verificar en la Consola de AWS

Dirígete a la Consola de S3 para ver tu bucket recién creado.

Hoja de Referencia de Comandos Esenciales de CDK

Aquí están los comandos que usarás con más frecuencia:

Comando	Descripción
`cdk init`	Inicializar un nuevo proyecto CDK
`cdk synth`	Sintetizar plantilla de CloudFormation
`cdk diff`	Comparar stack desplegado con estado actual
`cdk deploy`	Desplegar stack en AWS
`cdk destroy`	Eliminar stack de AWS
`cdk list`	Listar todos los stacks en la aplicación
`cdk doctor`	Verificar posibles problemas
`cdk watch`	Observar cambios y desplegar automáticamente

Paso 11: Limpiar

Para evitar incurrir en cargos, vamos a destruir el stack:

cdk destroy

Confirma escribiendo y cuando se te solicite.

Mejores Prácticas para el Desarrollo con CDK

Ahora que tienes CDK configurado, aquí hay algunas mejores prácticas a seguir:

1. Usa TypeScript para Seguridad de Tipos

TypeScript proporciona excelente soporte de IDE y detecta errores antes del despliegue:

// TypeScript detectará este error en tiempo de compilación
const bucket = new s3.Bucket(this, 'MiBucket', {
  versioned: 'yes', // ❌ Error: El tipo 'string' no es asignable al tipo 'boolean'
});

2. Organiza tus Stacks

Para proyectos más grandes, separa las responsabilidades en múltiples stacks:

// networking-stack.ts
export class NetworkingStack extends cdk.Stack { }

// database-stack.ts
export class DatabaseStack extends cdk.Stack { }

// application-stack.ts
export class ApplicationStack extends cdk.Stack { }

3. Usa Variables de Entorno

Haz que tus stacks sean reutilizables entre entornos:

const app = new cdk.App();

new MyStack(app, 'DevStack', {
  env: { account: '123456789', region: 'us-east-1' },
  stage: 'dev',
});

new MyStack(app, 'ProdStack', {
  env: { account: '987654321', region: 'us-west-2' },
  stage: 'prod',
});

4. Aprovecha los Constructos

Usa constructos de alto nivel (L2 y L3) que encapsulan mejores prácticas:

// L1 (bajo nivel) - más verboso
new s3.CfnBucket(this, 'MiBucket', {
  bucketName: 'mi-bucket',
  versioningConfiguration: {
    status: 'Enabled',
  },
});

// L2 (alto nivel) - recomendado
new s3.Bucket(this, 'MiBucket', {
  versioned: true,
});

5. Escribe Pruebas

CDK soporta pruebas unitarias desde el inicio:

import { Template } from 'aws-cdk-lib/assertions';
import * as MyStack from '../lib/my-stack';

test('Bucket S3 Creado', () => {
  const app = new cdk.App();
  const stack = new MyStack.MyStack(app, 'MyTestStack');
  const template = Template.fromStack(stack);

  template.hasResourceProperties('AWS::S3::Bucket', {
    VersioningConfiguration: {
      Status: 'Enabled',
    },
  });
});

Ejecuta las pruebas con:

npm test

Solución de Problemas Comunes

Problema: "Command not found: cdk"

Solución: Asegúrate de que el directorio bin global de npm esté en tu PATH:

echo 'export PATH="$HOME/.npm-packages/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Problema: "Need to perform AWS calls for account..."

Solución: Ejecuta cdk bootstrap para preparar tu entorno de AWS.

Problema: Errores de Permisos Denegados

Problema: Permiso denegado al instalar paquetes npm globalmente

Si obtienes errores de permisos, configura npm para usar un directorio diferente:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g aws-cdk

Problema: Conflictos de Versión de Node

Solución: Usa nvm para gestionar versiones de Node.js:

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Reiniciar terminal o cargar perfil
source ~/.bashrc

# Instalar y usar Node.js 18
nvm install 18
nvm use 18

Próximos Pasos

¡Felicidades! Ahora tienes un entorno de desarrollo de AWS CDK completamente funcional en Linux. Aquí está lo que puedes explorar a continuación:

Aprende Patrones de CDK: Visita el sitio web CDK Patterns para patrones de arquitectura comunes
Explora Constructos de AWS: Navega por el Construct Hub para constructos predefinidos
Toma el Workshop de CDK: Completa el CDK Workshop oficial
Construye Proyectos Reales: Intenta crear una API serverless, un sitio web estático o un pipeline de datos
Únete a la Comunidad: Participa en las discusiones de GitHub de AWS CDK

Recursos Útiles

Conclusión

AWS CDK transforma la gestión de infraestructura al llevar el poder de los lenguajes de programación a la infraestructura en la nube. Con CDK instalado en tu sistema Linux, ahora estás equipado para definir, desplegar y gestionar recursos de AWS usando código con el que ya estás familiarizado.

¿Qué construirás con CDK? ¡Comparte tus proyectos en los comentarios! 👇

¿Te resultó útil esta guía? Sígueme para más contenido sobre AWS y DevOps. ¿Tienes preguntas? ¡Déjalas en los comentarios!

Tags: #aws #cdk #devops #infraestructura #typescript #cloudformation #iac #tutorial #linux #principiantes

Getting Started with AWS CDK on Linux: A Complete Setup Guide

Cristian Paniagua — Sun, 30 Nov 2025 18:01:14 +0000

Getting Started with AWS CDK on Linux: A Complete Setup Guide

Infrastructure as Code (IaC) has revolutionized how we manage cloud resources, and AWS Cloud Development Kit (CDK) takes it to the next level by letting you define infrastructure using familiar programming languages. In this guide, I'll walk you through setting up AWS CDK on Linux, from installation to deploying your first stack.

What is AWS CDK?

Why Choose CDK?

Type Safety: Catch errors at compile time, not deployment time
IDE Support: Get autocomplete, inline documentation, and refactoring tools
Reusability: Create and share constructs as libraries
Less Boilerplate: Write less code compared to raw CloudFormation
Higher-Level Abstractions: Use pre-built constructs that follow AWS best practices

Prerequisites

Before we dive in, make sure you have:

A Linux system (Ubuntu, Debian, Fedora, CentOS, or Arch)
An active AWS account
Basic familiarity with the terminal
Sudo privileges
About 15 minutes of your time

Step 1: Install Node.js

AWS CDK requires Node.js version 14.15.0 or higher.

Ubuntu/Debian

# Update package index
sudo apt update

# Install Node.js and npm
sudo apt install nodejs npm -y

# Or install latest LTS version using NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install nodejs -y

Fedora/RHEL/CentOS

# Install Node.js and npm
sudo dnf install nodejs npm -y

# Or using NodeSource
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo dnf install nodejs -y

Arch Linux

sudo pacman -S nodejs npm

Verify the installation:

node --version
npm --version

Pro Tip: If you need to manage multiple Node.js versions, consider using nvm (Node Version Manager).

Step 2: Install AWS CLI

The AWS Command Line Interface is essential for managing your AWS credentials and resources.

Ubuntu/Debian

sudo apt install awscli -y

Fedora/RHEL/CentOS

sudo dnf install awscli -y

Using pip (all distributions)

pip3 install awscli --user

Verify the installation:

aws --version

Step 3: Configure AWS Credentials

Now we need to configure your AWS credentials. You'll need your AWS Access Key ID and Secret Access Key. If you don't have these yet, create them in the AWS IAM Console.

Run the configuration command:

aws configure

You'll be prompted to enter:

AWS Access Key ID [None]: YOUR_ACCESS_KEY_ID
AWS Secret Access Key [None]: YOUR_SECRET_ACCESS_KEY
Default region name [None]: us-east-1
Default output format [None]: json

Security Note: Never commit your AWS credentials to version control. Consider using AWS IAM Identity Center (formerly AWS SSO) for enhanced security in production environments.

Step 4: Install AWS CDK

Now for the main event! Install the AWS CDK CLI globally using npm:

sudo npm install -g aws-cdk

Verify the installation:

cdk --version

Congratulations! AWS CDK is now installed on your Linux system. 🎉

Step 5: Bootstrap Your AWS Environment

Before you can deploy CDK apps, you need to bootstrap your AWS environment. This creates the necessary resources (like an S3 bucket) that CDK uses to store deployment artifacts.

cdk bootstrap

You only need to do this once per AWS account/region combination.

Step 6: Create Your First CDK Project

Let's create a simple CDK project to verify everything is working correctly.

Create a Project Directory

mkdir my-first-cdk-app
cd my-first-cdk-app

Initialize a CDK App

We'll use TypeScript for this example:

cdk init app --language typescript

This creates a complete project structure with:

lib/ - Your CDK stack definitions
bin/ - The entry point for your CDK app
test/ - Unit tests
package.json - Node.js dependencies
cdk.json - CDK configuration

Install Dependencies

npm install

Step 7: Build Your First Stack

Let's create a simple S3 bucket to demonstrate CDK in action.

Open lib/my-first-cdk-app-stack.ts and replace its contents with:

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class MyFirstCdkAppStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // Create an S3 bucket with versioning enabled
    const bucket = new s3.Bucket(this, 'MyFirstBucket', {
      versioned: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
      autoDeleteObjects: true,
      encryption: s3.BucketEncryption.S3_MANAGED,
    });

    // Output the bucket name
    new cdk.CfnOutput(this, 'BucketName', {
      value: bucket.bucketName,
      description: 'The name of the S3 bucket',
    });
  }
}

What's Happening Here?

We're importing the necessary CDK libraries
Creating an S3 bucket with versioning enabled
Setting a removal policy to destroy the bucket when the stack is deleted
Enabling automatic object deletion
Adding server-side encryption
Outputting the bucket name for easy reference

Step 8: Synthesize CloudFormation Template

Before deploying, let's see what CloudFormation template CDK generates:

cdk synth

This command generates a CloudFormation template from your CDK code. You'll see YAML output in your terminal.

Step 9: Preview Changes

Before deploying, it's good practice to see what changes will be made:

cdk diff

Step 10: Deploy Your Stack

Now for the moment of truth—let's deploy to AWS:

cdk deploy

CDK will show you the changes and ask for confirmation. Type y and press Enter.

After a minute or two, your stack will be deployed! You'll see the bucket name in the outputs.

Verify in AWS Console

Head over to the S3 Console to see your newly created bucket.

Essential CDK Commands Cheat Sheet

Here are the commands you'll use most often:

Command	Description
`cdk init`	Initialize a new CDK project
`cdk synth`	Synthesize CloudFormation template
`cdk diff`	Compare deployed stack with current state
`cdk deploy`	Deploy stack to AWS
`cdk destroy`	Delete stack from AWS
`cdk list`	List all stacks in the app
`cdk doctor`	Check for potential problems
`cdk watch`	Watch for changes and deploy automatically

Step 11: Clean Up

To avoid incurring charges, let's destroy the stack:

cdk destroy

Confirm by typing y when prompted.

Best Practices for CDK Development

Now that you have CDK set up, here are some best practices to follow:

1. Use TypeScript for Type Safety

TypeScript provides excellent IDE support and catches errors before deployment:

// TypeScript will catch this error at compile time
const bucket = new s3.Bucket(this, 'MyBucket', {
  versioned: 'yes', // ❌ Error: Type 'string' is not assignable to type 'boolean'
});

2. Organize Your Stacks

For larger projects, separate concerns into multiple stacks:

// networking-stack.ts
export class NetworkingStack extends cdk.Stack { }

// database-stack.ts
export class DatabaseStack extends cdk.Stack { }

// application-stack.ts
export class ApplicationStack extends cdk.Stack { }

3. Use Environment Variables

Make your stacks reusable across environments:

const app = new cdk.App();

new MyStack(app, 'DevStack', {
  env: { account: '123456789', region: 'us-east-1' },
  stage: 'dev',
});

new MyStack(app, 'ProdStack', {
  env: { account: '987654321', region: 'us-west-2' },
  stage: 'prod',
});

4. Leverage Constructs

Use high-level constructs (L2 and L3) that encapsulate best practices:

// L1 (low-level) - more verbose
new s3.CfnBucket(this, 'MyBucket', {
  bucketName: 'my-bucket',
  versioningConfiguration: {
    status: 'Enabled',
  },
});

// L2 (high-level) - recommended
new s3.Bucket(this, 'MyBucket', {
  versioned: true,
});

5. Write Tests

CDK supports unit testing out of the box:

import { Template } from 'aws-cdk-lib/assertions';
import * as MyStack from '../lib/my-stack';

test('S3 Bucket Created', () => {
  const app = new cdk.App();
  const stack = new MyStack.MyStack(app, 'MyTestStack');
  const template = Template.fromStack(stack);

  template.hasResourceProperties('AWS::S3::Bucket', {
    VersioningConfiguration: {
      Status: 'Enabled',
    },
  });
});

Run tests with:

npm test

Troubleshooting Common Issues

Issue: "Command not found: cdk"

Solution: Make sure npm's global bin directory is in your PATH:

echo 'export PATH="$HOME/.npm-packages/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Issue: "Need to perform AWS calls for account..."

Solution: Run cdk bootstrap to prepare your AWS environment.

Issue: Permission Denied Errors

Solution: Verify your AWS credentials have the necessary permissions. For development, you might need AdministratorAccess, but in production, use least-privilege IAM policies.

Issue: Permission denied when installing npm packages globally

If you get permission errors, configure npm to use a different directory:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g aws-cdk

Issue: Node Version Conflicts

Solution: Use nvm to manage Node.js versions:

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Restart terminal or source profile
source ~/.bashrc

# Install and use Node.js 18
nvm install 18
nvm use 18

Next Steps

Congratulations! You now have a fully functional AWS CDK development environment on Linux. Here's what you can explore next:

Learn CDK Patterns: Check out the CDK Patterns website for common architecture patterns
Explore AWS Constructs: Browse the Construct Hub for pre-built constructs
Take the CDK Workshop: Complete the official CDK Workshop
Build Real Projects: Try creating a serverless API, a static website, or a data pipeline
Join the Community: Participate in the AWS CDK GitHub discussions

Useful Resources

Conclusion

AWS CDK transforms infrastructure management by bringing the power of programming languages to cloud infrastructure. With CDK installed on your Linux system, you're now equipped to define, deploy, and manage AWS resources using code you're already familiar with.

The journey from traditional CloudFormation to CDK might seem daunting at first, but the benefits—type safety, IDE support, reusability, and less boilerplate—make it well worth the investment.

What will you build with CDK? Share your projects in the comments below! 👇

Found this guide helpful? Follow me for more AWS and DevOps content. Have questions? Drop them in the comments!

Tags:#aws #cdk #devops #infrastructure #typescript #cloudformation #iac #tutorial #linux #beginners