Skip to content

Latest commit

 

History

History
185 lines (128 loc) · 5.38 KB

SETUP.md

File metadata and controls

185 lines (128 loc) · 5.38 KB

Setup — herramientas para hacer el curso

Guía para Mac (recomendada). Con esto podés seguir los 38 labs desde la terminal, con Docker, Kubernetes local y (opcional) el panel de logs de WezTerm.

Idioma del curso (después del setup): ./scripts/curso.sh → elegí Español o English.


1. Descargas e instalación (links oficiales)

Obligatorias (desde el día 1 / lab 05+)

Herramienta Para qué Link oficial
Homebrew Instalar el resto en Mac https://brew.sh
Docker Desktop Contenedores + Compose + LocalStack https://docs.docker.com/desktop/setup/install/mac-install/
Git Repo y labs de CI https://git-scm.com/downloads · o brew install git
WezTerm Terminal recomendada (panel de logs con l) https://wezfurlong.org/wezterm/install/macos.html

Recomendadas (labs 17–25)

Herramienta Labs Link oficial
GitHub CLI (gh) 17–18 https://cli.github.com/
kind 21–25 https://kind.sigs.k8s.io/docs/user/quick-start/#installation
kubectl 21–25 https://kubernetes.io/docs/tasks/tools/

Opcionales (labs 26–32)

Herramienta Labs Link oficial
Terraform 28, 31 https://developer.hashicorp.com/terraform/install
AWS CLI 27–28 https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html

Tipografía (opcional, queda bien en WezTerm)

Fuente Link
JetBrains Mono https://www.jetbrains.com/lp/mono/

2. Instalación rápida en Mac (copiá y pegá)

# Homebrew — si aún no lo tenés (abre https://brew.sh)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# CLI del curso
brew install git gh kind kubectl terraform awscli

# WezTerm (cask)
brew install --cask wezterm

# Docker Desktop (cask) — o descargalo del link oficial de arriba
brew install --cask docker

Abrí Docker Desktop desde Applications y esperá a que quede en verde.

Recursos de Docker Desktop (importante)

Settings → Resources (aprox.):

  • CPU: 4+
  • Memory: 6–8 GB
  • Disk: 40 GB+ libres ayudan con imágenes

Sin eso, kind + Compose + LocalStack se quedan cortos.

Verificar

docker version
docker compose version
git --version
wezterm --version
kind version
kubectl version --client
terraform version
aws --version
gh --version

3. WezTerm — configuración del curso

El runner usa wezterm cli para abrir un panel de logs a la derecha (tecla l en un paso del lab). Hace falta:

  1. Correr el curso dentro de WezTerm (no solo Terminal.app).
  2. Tener la CLI disponible (wezterm en el PATH).
  3. Usar la config del repo (status bar con el lab actual).

Instalar la config

Desde la raíz del repo:

./scripts/setup-wezterm.sh

Eso copia config/wezterm/wezterm.lua a ~/.config/wezterm/wezterm.lua (hace backup si ya existía).

Manual:

mkdir -p ~/.config/wezterm
cp config/wezterm/wezterm.lua ~/.config/wezterm/wezterm.lua

Reiniciá WezTerm. Docs de config: https://wezfurlong.org/wezterm/config/files.html

Qué trae esta config

  • Fuente legible (JetBrains Mono si está instalada; si no, Menlo)
  • Scrollback amplio
  • Barra superior con el estado del lab (~/.cache/ops-lab/status)
  • Colores contrastados para teoría / comandos / checks
  • Atajos útiles de splits (además del panel que abre el curso con l)

Arrancar el curso en WezTerm

cd ~/Projects/java-linux-ops-lab   # o donde clones
wezterm start --cwd "$(pwd)" -- ./scripts/curso.sh --docker

O abrí WezTerm, cd al repo y:

./scripts/curso.sh --docker

4. Clonar el lab y smoke

git clone https://github.com/reeb-dev/java-linux-ops-lab.git
cd java-linux-ops-lab
./scripts/curso.sh --docker

Smoke del stack (app + MySQL):

./scripts/check-lab.sh
# App:     http://localhost:8080/actuator/health
# Adminer: http://localhost:8081

Agenda Mac: AGENDA.md · calendario: calendar/ops-lab-agenda-8-semanas.ics


5. Checklist “listo para lab 01”

  • Homebrew instalado
  • Docker Desktop corriendo (docker version muestra Server)
  • Recursos Docker ≥ 4 CPU / 6 GB RAM
  • git, gh, kind, kubectl (antes del bloque K8s)
  • WezTerm + ./scripts/setup-wezterm.sh
  • Repo clonado y ./scripts/curso.sh --docker responde
  • Idioma elegido (ES/EN)

6. Links del material del curso

Recurso Path / URL
Repo https://github.com/reeb-dev/java-linux-ops-lab
Track / DoD TRACK.md
Agenda AGENDA.md
Referencias oficiales cheatsheets/referencias-oficiales.md
Manifiestos K8s examples/k8s/
Terraform LocalStack examples/terraform/localstack/
Prometheus/Grafana examples/observability/

7. Linux (nota breve)

En Linux: Docker Engine + Compose plugin, WezTerm desde https://wezfurlong.org/wezterm/install/linux.html, y el mismo brew (Linuxbrew) o paquetes distro para kind/kubectl/terraform. La config WezTerm del repo es la misma.