Preparar tu equipo

El curso funciona en Windows (con o sin WSL), macOS y Linux. Necesitas lo mismo en todos: Go, Docker y un navegador. Aquí tienes cómo instalarlo en cada sistema y qué cambia al seguir las lecciones.

Qué necesitas

Dónde se ha probado

macOS

1. Go: el instalador .pkg de go.dev/dl (elige darwin-arm64 para Apple Silicon, darwin-amd64 para Intel) o brew install go.
2. Docker: Docker Desktop para Mac (con el chip correcto) u OrbStack. Arráncalo antes de seguir.
3. Terminal: la de macOS (zsh). Los comandos del curso funcionan tal cual.

go version                 # go version go1.26… darwin/arm64
docker compose version     # Docker Compose version v2…
docker run --rm hello-world

Windows sin WSL

1. Go: el instalador .msi de go.dev/dl o winget install GoLang.Go. Abre una terminal nueva después.
2. Docker: Docker Desktop para Windows. Por dentro usa WSL 2, pero tú no necesitas trabajar dentro de una distribución Linux.
3. Terminal: PowerShell (mejor la 7, winget install Microsoft.PowerShell) o Git Bash (viene con Git para Windows). Con Git Bash los comandos del curso funcionan casi tal cual; con PowerShell, mira la tabla de equivalencias.

go version                 # go version go1.26… windows/amd64
docker compose version
docker run --rm hello-world

Windows con WSL 2

1. Instala Go dentro de tu distribución (el tarball de go.dev/dl para linux-amd64). El paquete de la distribución suele ser demasiado antiguo.
2. Docker Desktop en Windows, con Settings → Resources → WSL integration activado para tu distribución.
3. Si docker ps dice permission denied … docker.sock: tu usuario está en el grupo docker, pero la terminal se abrió antes. Cierra la terminal (o wsl --shutdown desde PowerShell) y abre otra.

Linux

1. Go: el tarball de go.dev/dl (sudo tar -C /usr/local -xzf go1.26…linux-amd64.tar.gz y añade /usr/local/go/bin al PATH). Los paquetes de las distribuciones suelen ir por detrás.
2. Docker: Docker Engine con el plugin de Compose (docker-compose-plugin), siguiendo la guía oficial de tu distribución.
3. Permisos: sudo usermod -aG docker $USER y abre una sesión nueva. Sin eso verás permission denied … /var/run/docker.sock.

Los comandos del curso en PowerShell

Las lecciones usan sintaxis de bash (macOS, Linux, WSL, Git Bash). En PowerShell cambian unas pocas cosas:

Enviar JSON con curl en Windows

Es el único punto delicado, porque PowerShell 5.1 y 7 pasan las comillas a curl.exe de forma distinta. Resultados reales contra api-pedidos:

Lo más sencillo: guarda el cuerpo en un archivo y envíalo con @. Funciona en todas las terminales.

Set-Content -Path pedido.json -Value '{"producto":"taza","cantidad":1}'
curl.exe -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" `
  --data "@pedido.json" http://localhost:8081/pedidos

Git Bash

En Git Bash los comandos de bash funcionan tal cual, con una excepción comprobada: Git Bash convierte las rutas que empiezan por / en rutas de Windows, y eso rompe los volúmenes de Docker. En la exportación de la lección 2, /tmp/export se convirtió en C:/Users/…/Temp/export y Keycloak falló. Se arregla así:

MSYS_NO_PATHCONV=1 docker compose run --rm -v "$PWD/export:/tmp/export" keycloak \
  export --dir /tmp/export --realm tienda --users realm_file

Tu app vista desde Keycloak

Solo una lección (la 4, back-channel logout) necesita que Keycloak, desde su contenedor, llame a un programa tuyo. La URL depende del entorno:

Problemas típicos por sistema