Setup: AWS CLI + LocalStack + credenciales

1# 🟦 Windows (PowerShell) y 🍎 Mac (Terminal) — mismo comando
2docker --version
3# Docker version 24.x.x o superior
4
5docker ps
6# Debería mostrar la lista de contenedores (puede estar vacía)

Si docker ps da error, abre Docker Desktop y espera a que inicie

1# 🟦 Windows (PowerShell) — ejecutar como administrador
2msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
3
4# Verificar instalación (cerrar y reabrir PowerShell):
5aws --version
6# aws-cli/2.x.x Python/3.x.x Windows/10 ...

Instalación en Windows — descarga e instala el MSI oficial

1# 🍎 Mac (Terminal) — con Homebrew
2brew install awscli
3
4# Verificar instalación:
5aws --version
6# aws-cli/2.x.x Python/3.x.x Darwin/23.x.x ...

Instalación en Mac — Homebrew es el método más limpio

1# 🟦 Windows y 🍎 Mac — dentro de tu venv
2pip install boto3
3
4# Verificar
5python -c "import boto3; print(boto3.__version__)"
6# 1.34.x

boto3 es el SDK oficial de AWS para Python

1# Crea un archivo docker-compose.yml en tu directorio de trabajo
2# 🟦 Windows y 🍎 Mac — mismo contenido

Prepara el directorio del proyecto

1# docker-compose.yml
2services:
3  localstack:
4    image: localstack/localstack:3.5
5    ports:
6      - "127.0.0.1:4566:4566"
7    environment:
8      - AWS_DEFAULT_REGION=eu-west-1
9      - DEBUG=0
10    volumes:
11      # Necesario para Lambda EN LOS TRES SISTEMAS.
12      # Docker Desktop expone el socket también en Windows (WSL2).
13      - "/var/run/docker.sock:/var/run/docker.sock"

docker-compose.yml — LocalStack con la imagen 3.5 (la última sin cuenta obligatoria)

1# 🟦 Windows y 🍎 Mac — levantar LocalStack
2docker-compose up -d
3
4# Verificar que está corriendo:
5docker ps
6# Deberías ver localstack/localstack:3.5 corriendo
7
8# Verificar que responde:
9curl http://localhost:4566/_localstack/health
10# {"services": {"s3": "running", "iam": "running", ...}}

En Windows PowerShell usa Invoke-WebRequest en vez de curl si no lo tienes

1# 🟦 Windows y 🍎 Mac — configurar un perfil "localstack"
2aws configure --profile localstack
3# AWS Access Key ID: test
4# AWS Secret Access Key: test
5# Default region name: eu-west-1
6# Default output format: json

Las credenciales son ficticias — LocalStack acepta cualquier valor

1# 🟦 Windows y 🍎 Mac — crear un bucket S3 en LocalStack
2aws --endpoint-url=http://localhost:4566 --profile localstack \
3    s3 mb s3://mi-primer-bucket
4
5# Listar buckets
6aws --endpoint-url=http://localhost:4566 --profile localstack \
7    s3 ls
8# 2024-01-15 10:30:00 mi-primer-bucket

El --endpoint-url apunta a LocalStack en vez de a AWS real

1import boto3
2
3# Crear cliente S3 apuntando a LocalStack
4s3 = boto3.client(
5    's3',
6    endpoint_url='http://localhost:4566',
7    aws_access_key_id='test',
8    aws_secret_access_key='test',
9    region_name='eu-west-1'
10)
11
12# Listar buckets
13response = s3.list_buckets()
14for bucket in response['Buckets']:
15    print(f"Bucket: {bucket['Name']}")
16# Bucket: mi-primer-bucket

boto3 hablando con LocalStack — idéntico a AWS real excepto el endpoint_url

1import os
2import boto3
3
4def get_aws_client(service_name: str):
5    """
6    Crea un cliente boto3 contra LocalStack si AWS_ENDPOINT_URL
7    está definida; contra AWS real si no.
8    """
9    kwargs = {'region_name': os.getenv('AWS_DEFAULT_REGION', 'eu-west-1')}
10    endpoint = os.getenv('AWS_ENDPOINT_URL')
11    if endpoint:
12        kwargs.update(
13            endpoint_url=endpoint,
14            aws_access_key_id=os.getenv('AWS_ACCESS_KEY_ID', 'test'),
15            aws_secret_access_key=os.getenv('AWS_SECRET_ACCESS_KEY', 'test')
16        )
17    return boto3.client(service_name, **kwargs)
18
19# Uso:
20s3 = get_aws_client('s3')
21iam = get_aws_client('iam')
22lambda_client = get_aws_client('lambda')

Guarda esto en un archivo aws_helper.py — lo usarás en TODOS los ejercicios