Getting Started

Now, let’s clone the repo and make sure that everything works.

Clone the repository

Why this book is local-first

  • Zero cloud accounts, zero ongoing cost, predictable setup.
  • Everyone’s laptop is the same “platform”: Docker + Minikube + Make.
  • Artifacts saved locally → easy “audit packet” and reproducible labs.

What you’ll install (once)

  • Git, Docker Desktop (or Docker Engine), Make, Go, Minikube.
  • Optional: VS Code (recommended).

Repo layout (quick tour)

ship-securely-starter/
├─ app/
│  ├─ main.go
│  ├─ go.mod
│  └─ Dockerfile
├─ infra/
│  ├─ docker/
│  │  └─ compose.yaml
│  └─ k8s/
│     ├─ deployment.yaml
│     ├─ service.yaml
│     └─ kustomization.yaml
├─ tools/
│  └─ zap/
│     └─ README.md              # place ZAP context/auth if needed
├─ artifacts/                   # CI reports written here (generated)
├─ .pre-commit-config.yaml
├─ .gitignore
├─ Makefile                     # `make ci`, `make cd`, mk-* targets
└─ README.md