DevOps & Deployment Skill
Comprehensive frameworks for CI/CD pipelines, containerization, deployment strategies, and infrastructure automation.
Note: If disableSkillShellExecution is enabled (CC 2.1.91), the Docker install check won't run. Verify Docker is available for container operations: docker --version.
Overview
- Setting up CI/CD pipelines
- Containerizing applications
- Deploying to Kubernetes or cloud platforms
- Implementing GitOps workflows
- Managing infrastructure as code
- Planning release strategies
Pipeline Architecture
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Code │──>│ Build │──>│ Test │──>│ Deploy │
│ Commit │ │ & Lint │ │ & Scan │ │ & Release │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│ │ │ │
v v v v
Triggers Artifacts Reports Monitoring
Key Concepts
CI/CD Pipeline Stages
- Lint & Type Check - Code quality gates
- Unit Tests - Test coverage with reporting
- Security Scan - npm audit + Trivy vulnerability scanner
- Build & Push - Docker image to container registry
- Deploy Staging - Environment-gated deployment
- Deploy Production - Manual approval or automated
Container Best Practices
Multi-stage builds minimize image size:
- Stage 1: Install production dependencies only
- Stage 2: Build application with dev dependencies
- Stage 3: Production runtime with minimal footprint
Security hardening:
- Non-root user (uid 1001)
- Read-only filesystem where possible
- Health checks for orchestrator integration
Kubernetes Deployment
Essential manifests:
- Deployment with rolling update strategy
- Service for internal routing
- Ingress for external access with TLS
- HorizontalPodAutoscaler for scaling
Security context:
runAsNonRoot: true
allowPrivilegeEscalation: false
readOnlyRootFilesystem: true
- Drop all capabilities
Deployment Strategies
| Strategy |
Use Case |
Risk |
| Rolling |
Default, gradual replacement |
Low - automatic rollback |
| Blue-Green |
Instant switch, easy rollback |
Medium - double resources |
| Canary |
Progressive traffic shift |
Low - gradual exposure |
Rolling Update (Kubernetes default):
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 25%
maxUnavailable: 0 # Zero downtime
Secrets Management
Use External Secrets Operator to sync from cloud providers:
- AWS Secrets Manager
- HashiCorp Vault
- Azure Key Vault
- GCP Secret Manager
References
Docker Patterns
Load: Read("references/docker-patterns.md")
Key topics covered:
- Multi-stage build examples with 78% size reduction
- Layer caching optimization
- Security hardening (non-root, health checks)
- Trivy vulnerability scanning
- Docker Compose development setup
OrchestKit Delta (house rules)
Load: Read("references/ork-delta.md")
Key topics covered:
- CI concurrency groups, the sub-5-minute feedback budget, path filtering
- Service-container health gating, SHA-pinned deploys, CDN invalidation order
- Kubernetes probe budget, request/limit baseline, PodDisruptionBudget floor
- External Secrets refresh interval, ArgoCD prune plus selfHeal, Terraform state locking
- Alert thresholds with dwell windows, request-id log binding, rollback rehearsal
Railway Deployment
Load: Read("rules/railway-deployment.md")
Key topics covered:
- railway.json configuration, Nixpacks builds
- Environment variable management, database provisioning
- Multi-service setups, Railway CLI workflows
- References:
references/railway-json-config.md, references/nixpacks-customization.md, references/multi-service-setup.md
Deployment Strategies
Load: Read("references/deployment-strategies.md")
Key topics covered:
- Rolling deployment (
maxUnavailable / maxSurge)
- Blue-green deployment (service-selector switch and rollback)
- Canary releases (replica-ratio traffic split)
Upstream coverage (do not restate)
This skill wraps third-party products. Vendor mechanics are not restated here; fetch them from the
source below. Where a row says "house subset stays in X", that file keeps only OrchestKit's
threshold, config or ordering decision, not the vendor tutorial.
| Topic |
Fetch from |
| GitHub Actions workflow syntax, matrix builds, artifact upload/download, cache mechanics |
https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax (house cache-key subset stays in rules/devops-ci-caching.md) |
Trigger filters (on.push.paths, schedules, workflow_dispatch) |
https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow |
| Service containers for integration tests |
https://docs.github.com/en/actions/tutorials/use-containerized-services/use-docker-service-containers |
| Deployment environments and approval gates |
https://docs.github.com/en/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments |
| Protected branches and required status checks |
https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches (house approval counts stay in rules/devops-branch-protection.md) |
| Kubernetes probe semantics and every probe field |
https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/ (house probe numbers stay in references/ork-delta.md) |
| Requests, limits, quotas and QoS classes |
https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ (house baseline stays in references/ork-delta.md) |
| PodDisruptionBudget semantics and eviction API |
https://kubernetes.io/docs/tasks/run-application/configure-pdb/ (house minAvailable floor stays in references/ork-delta.md) |
| StatefulSets, ordinal identity, volumeClaimTemplates |
https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/ |
| Helm chart authoring, templating and values files |
https://helm.sh/docs/topics/charts/ (the chart directory layout we use stays in references/checklists-and-templates.md) |
| External Secrets Operator CRD fields and backends |
https://external-secrets.io/latest/api/externalsecret/ (house refresh/creation policy stays in references/ork-delta.md) |
| ArgoCD automated sync, prune and self-heal |
https://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/ (house retry/backoff stays in references/ork-delta.md) |
| Terraform S3 backend and state locking |
https://developer.hashicorp.com/terraform/language/backend/s3 (house backend config stays in references/ork-delta.md) |
| Terraform module composition and variable files |
https://developer.hashicorp.com/terraform/language/modules |
| Alembic revision, upgrade and downgrade CLI |
https://alembic.sqlalchemy.org/en/latest/tutorial.html (the zero-downtime migration ordering stays in rules/devops-db-migrations.md) |
| Prometheus client instrumentation (Counter, Histogram, exposition) |
https://prometheus.github.io/client_python/ |
PromQL functions (rate, histogram_quantile) for dashboards |
https://prometheus.io/docs/prometheus/latest/querying/functions/ |
| Prometheus alerting rule syntax |
https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/ (house thresholds and dwell windows stay in references/ork-delta.md) |
| OpenTelemetry FastAPI auto-instrumentation and manual spans |
https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/fastapi/fastapi.html |
| structlog context binding |
https://www.structlog.org/en/stable/contextvars.html (the bind-then-call ordering stays in references/ork-delta.md) |
| Trivy severity filtering and scan configuration |
https://trivy.dev/latest/docs/configuration/filtering/ (the house image-scan CI wiring stays in references/docker-patterns.md, the weekly-scan schedule and severity floor in references/ork-delta.md) |
| CloudFront invalidation semantics and cost |
https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html (the sync-then-invalidate order stays in references/ork-delta.md) |
| Pre-launch security, load-testing and monitoring checklists |
ork:security-patterns, ork:testing-perf, ork:monitoring-observability (the deploy-day checklist stays in references/checklists-and-templates.md) |
Deployment Checklist & Templates
Load: Read("references/checklists-and-templates.md") for pre/during/post-deployment checklists, Helm chart structure, template reference table, and extended thinking triggers.
Related Skills
ork:security-patterns - Security scanning and hardening patterns for CI/CD pipelines
ork:monitoring-observability - Prometheus, Grafana and alerting for deployed applications
ork:database-patterns - Python/Alembic migration workflow for backend deployments
portless (upstream) - Named .localhost URLs for multi-service local dev (portless alias api 8080)
Key Decisions
| Decision |
Choice |
Rationale |
| Container user |
Non-root (uid 1001) |
Security best practice, required by many orchestrators |
| Deployment strategy |
Rolling update (default) |
Zero downtime, automatic rollback, resource efficient |
| Secrets management |
External Secrets Operator |
Syncs from cloud providers, GitOps compatible |
| Health checks |
Separate startup/liveness/readiness |
Prevents premature traffic, enables graceful shutdown |
Capability Details
Load: Read("references/capability-details.md") for full keyword index and problem-solution mapping across all 6 capabilities (ci-cd, docker, kubernetes, infrastructure-as-code, deployment-strategies, observability).
1---
2name: devops-deployment
3license: MIT
4compatibility: "Claude Code 2.1.251+."
5description: Use when setting up CI/CD pipelines, containerizing applications, deploying to Kubernetes, or writing infrastructure as code. DevOps & Deployment covers GitHub Actions, Docker, Helm, and Terraform patterns.
6tags: [devops, ci-cd, docker, kubernetes, terraform]
7context: fork
8agent: ci-cd-engineer
9version: 1.0.0
10author: OrchestKit
11user-invocable: false
12disable-model-invocation: false
13complexity: medium
14persuasion-type: guidance
15metadata:
16 source: https://skillmd.com/skills/yonatangross/devops-deployment
17 category: workflow-automation
18allowed-tools:
19 - Read
20 - Glob
21 - Grep
22 - WebFetch
23 - WebSearch
24paths: [".github/workflows/**", "Dockerfile*", "docker-compose*", "**/k8s/**", "**/terraform/**"]
25path_patterns: ["*.tf", "*.tfvars", "**/k8s/**", "**/helm/**", "Dockerfile*", ".github/workflows/*"]
26invocation_hooks:
27 - "command -v docker >/dev/null 2>&1 || echo 'Warning: docker not found — container operations will fail'"
28---
29
30# DevOps & Deployment Skill
31
32Comprehensive frameworks for CI/CD pipelines, containerization, deployment strategies, and infrastructure automation.
33
34> **Note:** If `disableSkillShellExecution` is enabled (CC 2.1.91), the Docker install check won't run. Verify Docker is available for container operations: `docker --version`.
35
36## Overview
37
38- Setting up CI/CD pipelines
39- Containerizing applications
40- Deploying to Kubernetes or cloud platforms
41- Implementing GitOps workflows
42- Managing infrastructure as code
43- Planning release strategies
44
45## Pipeline Architecture
46
47```
48┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
49│ Code │──>│ Build │──>│ Test │──>│ Deploy │
50│ Commit │ │ & Lint │ │ & Scan │ │ & Release │
51└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
52 │ │ │ │
53 v v v v
54 Triggers Artifacts Reports Monitoring
55```
56
57## Key Concepts
58
59### CI/CD Pipeline Stages
60
611. **Lint & Type Check** - Code quality gates
622. **Unit Tests** - Test coverage with reporting
633. **Security Scan** - npm audit + Trivy vulnerability scanner
644. **Build & Push** - Docker image to container registry
655. **Deploy Staging** - Environment-gated deployment
666. **Deploy Production** - Manual approval or automated
67
68### Container Best Practices
69
70**Multi-stage builds** minimize image size:
71- Stage 1: Install production dependencies only
72- Stage 2: Build application with dev dependencies
73- Stage 3: Production runtime with minimal footprint
74
75**Security hardening**:
76- Non-root user (uid 1001)
77- Read-only filesystem where possible
78- Health checks for orchestrator integration
79
80### Kubernetes Deployment
81
82**Essential manifests**:
83- Deployment with rolling update strategy
84- Service for internal routing
85- Ingress for external access with TLS
86- HorizontalPodAutoscaler for scaling
87
88**Security context**:
89- `runAsNonRoot: true`
90- `allowPrivilegeEscalation: false`
91- `readOnlyRootFilesystem: true`
92- Drop all capabilities
93
94### Deployment Strategies
95
96| Strategy | Use Case | Risk |
97|----------|----------|------|
98| **Rolling** | Default, gradual replacement | Low - automatic rollback |
99| **Blue-Green** | Instant switch, easy rollback | Medium - double resources |
100| **Canary** | Progressive traffic shift | Low - gradual exposure |
101
102**Rolling Update** (Kubernetes default):
103```yaml
104strategy:
105 type: RollingUpdate
106 rollingUpdate:
107 maxSurge: 25%
108 maxUnavailable: 0 # Zero downtime
109```
110
111### Secrets Management
112
113Use External Secrets Operator to sync from cloud providers:
114- AWS Secrets Manager
115- HashiCorp Vault
116- Azure Key Vault
117- GCP Secret Manager
118
119---
120
121## References
122
123### Docker Patterns
124**Load: `Read("references/docker-patterns.md")`**
125
126Key topics covered:
127- Multi-stage build examples with 78% size reduction
128- Layer caching optimization
129- Security hardening (non-root, health checks)
130- Trivy vulnerability scanning
131- Docker Compose development setup
132
133### OrchestKit Delta (house rules)
134**Load: `Read("references/ork-delta.md")`**
135
136Key topics covered:
137- CI concurrency groups, the sub-5-minute feedback budget, path filtering
138- Service-container health gating, SHA-pinned deploys, CDN invalidation order
139- Kubernetes probe budget, request/limit baseline, PodDisruptionBudget floor
140- External Secrets refresh interval, ArgoCD prune plus selfHeal, Terraform state locking
141- Alert thresholds with dwell windows, request-id log binding, rollback rehearsal
142
143### Railway Deployment
144**Load: `Read("rules/railway-deployment.md")`**
145
146Key topics covered:
147- railway.json configuration, Nixpacks builds
148- Environment variable management, database provisioning
149- Multi-service setups, Railway CLI workflows
150- References: `references/railway-json-config.md`, `references/nixpacks-customization.md`, `references/multi-service-setup.md`
151
152### Deployment Strategies
153**Load: `Read("references/deployment-strategies.md")`**
154
155Key topics covered:
156- Rolling deployment (`maxUnavailable` / `maxSurge`)
157- Blue-green deployment (service-selector switch and rollback)
158- Canary releases (replica-ratio traffic split)
159
160---
161
162## Upstream coverage (do not restate)
163
164This skill wraps third-party products. Vendor mechanics are not restated here; fetch them from the
165source below. Where a row says "house subset stays in X", that file keeps only OrchestKit's
166threshold, config or ordering decision, not the vendor tutorial.
167
168| Topic | Fetch from |
169|-------|-----------|
170| GitHub Actions workflow syntax, matrix builds, artifact upload/download, cache mechanics | https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax (house cache-key subset stays in `rules/devops-ci-caching.md`) |
171| Trigger filters (`on.push.paths`, schedules, `workflow_dispatch`) | https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow |
172| Service containers for integration tests | https://docs.github.com/en/actions/tutorials/use-containerized-services/use-docker-service-containers |
173| Deployment environments and approval gates | https://docs.github.com/en/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments |
174| Protected branches and required status checks | https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches (house approval counts stay in `rules/devops-branch-protection.md`) |
175| Kubernetes probe semantics and every probe field | https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/ (house probe numbers stay in `references/ork-delta.md`) |
176| Requests, limits, quotas and QoS classes | https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ (house baseline stays in `references/ork-delta.md`) |
177| PodDisruptionBudget semantics and eviction API | https://kubernetes.io/docs/tasks/run-application/configure-pdb/ (house `minAvailable` floor stays in `references/ork-delta.md`) |
178| StatefulSets, ordinal identity, volumeClaimTemplates | https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/ |
179| Helm chart authoring, templating and values files | https://helm.sh/docs/topics/charts/ (the chart directory layout we use stays in `references/checklists-and-templates.md`) |
180| External Secrets Operator CRD fields and backends | https://external-secrets.io/latest/api/externalsecret/ (house refresh/creation policy stays in `references/ork-delta.md`) |
181| ArgoCD automated sync, prune and self-heal | https://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/ (house retry/backoff stays in `references/ork-delta.md`) |
182| Terraform S3 backend and state locking | https://developer.hashicorp.com/terraform/language/backend/s3 (house backend config stays in `references/ork-delta.md`) |
183| Terraform module composition and variable files | https://developer.hashicorp.com/terraform/language/modules |
184| Alembic revision, upgrade and downgrade CLI | https://alembic.sqlalchemy.org/en/latest/tutorial.html (the zero-downtime migration ordering stays in `rules/devops-db-migrations.md`) |
185| Prometheus client instrumentation (Counter, Histogram, exposition) | https://prometheus.github.io/client_python/ |
186| PromQL functions (`rate`, `histogram_quantile`) for dashboards | https://prometheus.io/docs/prometheus/latest/querying/functions/ |
187| Prometheus alerting rule syntax | https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/ (house thresholds and dwell windows stay in `references/ork-delta.md`) |
188| OpenTelemetry FastAPI auto-instrumentation and manual spans | https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/fastapi/fastapi.html |
189| structlog context binding | https://www.structlog.org/en/stable/contextvars.html (the bind-then-call ordering stays in `references/ork-delta.md`) |
190| Trivy severity filtering and scan configuration | https://trivy.dev/latest/docs/configuration/filtering/ (the house image-scan CI wiring stays in `references/docker-patterns.md`, the weekly-scan schedule and severity floor in `references/ork-delta.md`) |
191| CloudFront invalidation semantics and cost | https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html (the sync-then-invalidate order stays in `references/ork-delta.md`) |
192| Pre-launch security, load-testing and monitoring checklists | `ork:security-patterns`, `ork:testing-perf`, `ork:monitoring-observability` (the deploy-day checklist stays in `references/checklists-and-templates.md`) |
193
194---
195
196## Deployment Checklist & Templates
197
198Load: `Read("references/checklists-and-templates.md")` for pre/during/post-deployment checklists, Helm chart structure, template reference table, and extended thinking triggers.
199
200---
201
202## Related Skills
203
204- `ork:security-patterns` - Security scanning and hardening patterns for CI/CD pipelines
205- `ork:monitoring-observability` - Prometheus, Grafana and alerting for deployed applications
206- `ork:database-patterns` - Python/Alembic migration workflow for backend deployments
207- `portless` (upstream) - Named `.localhost` URLs for multi-service local dev (`portless alias api 8080`)
208
209## Key Decisions
210
211| Decision | Choice | Rationale |
212|----------|--------|-----------|
213| Container user | Non-root (uid 1001) | Security best practice, required by many orchestrators |
214| Deployment strategy | Rolling update (default) | Zero downtime, automatic rollback, resource efficient |
215| Secrets management | External Secrets Operator | Syncs from cloud providers, GitOps compatible |
216| Health checks | Separate startup/liveness/readiness | Prevents premature traffic, enables graceful shutdown |
217
218## Capability Details
219
220Load: `Read("references/capability-details.md")` for full keyword index and problem-solution mapping across all 6 capabilities (ci-cd, docker, kubernetes, infrastructure-as-code, deployment-strategies, observability).