菜单
Deploy Go Gin APIs with Docker, docker-compose, Kubernetes. Use when Dockerizing a Go app, setting up docker-compose, deploying to K8s, or configuring CI/CD and health probes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | golang-gin-deploy |
| description | Deploy Go Gin APIs with Docker, docker-compose, Kubernetes. Use when Dockerizing a Go app, setting up docker-compose, deploying to K8s, or configuring CI/CD and health probes. |
| license | MIT |
| metadata | {"author":"henriqueatila","version":"1.0.3"} |
Package and deploy Gin APIs to production. This skill covers the essential deployment patterns: multi-stage Docker builds, local dev with docker-compose, and Kubernetes manifests with health checks.
Multi-Stage Dockerfile
golang:1.24-bookworm as builder, gcr.io/distroless/static-debian12:nonroot as runtimeCGO_ENABLED=0 mandatory for distroless/scratch — produces statically linked binary, no libc dependencyTARGETARCH build arg for multi-platform builds-ldflags="-s -w" -trimpath strips debug info and reduces binary sizeHealth Checks
DBPinger interface (PingContext) — satisfied by *sql.DB and *sqlx.DB503 Service Unavailable when DB is unreachableReadiness vs Liveness probes:
| Probe | Checks | On failure |
|---|---|---|
| Liveness | Is the process alive? | Restart container |
| Readiness | Can the app serve traffic? | Remove from load balancer (no restart) |
/health/live — returns 200 if process is running (no DB check)/health/ready — returns 200 only when DB is reachable/health endpoint that pings the DB is sufficient12-Factor Config
DATABASE_URL and JWT_SECRET are required; fail fast on startup if missingPORT=8080, GIN_MODE=release in productionparseDuration helper with sensible fallbacks for timeout valuesDocker best practices
.git, .env, *.md, docs/, plans/ in .dockerignore.env prevents secrets from leaking into the imagedepends_on with condition: service_healthy in docker-composedocker inspect, kubectl describe pod, curl /health. Paste the output. "I believe it's running" is not "health check returns 200"This skill handles containerization and deployment of Go Gin APIs: Docker multi-stage builds, docker-compose, Kubernetes manifests, health checks, 12-factor config, and CI/CD pipelines. Does NOT handle application code (see golang-gin-api), authentication (see golang-gin-auth), database queries (see golang-gin-database), or testing (see golang-gin-testing).
cmd/api/main.go): see the golang-gin-api skillreferences/migrations.md)references/clean-architecture.md)If this skill doesn't cover your use case, consult the Docker documentation, Kubernetes documentation, or OpenTelemetry Go docs.
Build REST APIs with Go Gin. Use when creating Go web servers, adding Gin routes, writing handlers, or asking about middleware, binding, error handling, or project structure.
JWT auth and RBAC for Go Gin APIs. Use when adding login, signup, JWT tokens, role checks, protected routes, or password hashing to a Gin app.
PostgreSQL integration for Go Gin with GORM/sqlx. Use when adding a database, writing queries, creating repositories, running migrations, or wiring DB layers in a Gin project.
Software architect for Go Gin APIs. Use when making architecture decisions, evaluating complexity, designing systems, choosing patterns, or coordinating across gin skills.
PostgreSQL DBA for Go Gin APIs. Use when designing schemas, analyzing migrations, choosing indexes, optimizing queries, or selecting extensions (pgvector, PostGIS, TimescaleDB).
Swagger/OpenAPI docs for Go Gin with swaggo/swag. Use when adding API docs, Swagger UI, endpoint annotations, or generating swagger.json for a Gin application.