yonatangross/orchestkitMIT28 files

Devops Deployment

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.

Specification
Skill ID
yonatangross/orchestkit/devops-deployment
Publisher
yonatangross
Repository
orchestkit
Installs
0
Files
28
License
MIT
Requires
Claude Code 2.1.277+.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

yonatangross/orchestkit/devops-deploymentInstalls these files
  • SKILL.md
  • references/capability-details.md
  • references/checklists-and-templates.md
  • references/deployment-strategies.md
  • references/docker-patterns.md
  • references/multi-service-setup.md
  • references/nixpacks-customization.md
  • references/ork-delta.md
  • references/railway-json-config.md
  • rules/_sections.md
  • rules/_template.md
  • rules/devops-branch-protection.md
  • rules/devops-ci-caching.md
  • rules/devops-db-migrations.md
  • rules/docker-layer-security.md
  • rules/docker-multistage.md
  • rules/railway-deployment.md
  • scripts/Dockerfile
  • scripts/argocd-application.yaml
  • scripts/create-ci-pipeline.md
  • scripts/create-docker-compose.md
  • scripts/docker-compose.yml
  • scripts/external-secrets.yaml
  • scripts/github-actions-pipeline.yml
  • scripts/helm-values.yaml
  • scripts/k8s-manifests.yaml
  • scripts/terraform-aws.tf
  • test-cases.json

What this skill tells the agent

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  │
└──────────┘ └──────────┘ └──────────┘ └──────────┘
  triggers     artifacts    reports      monitoring

Key Concepts

CI/CD Pipeline Stages

  1. Lint & Type Check - Code quality gates
  2. Unit Tests - Test coverage with reporting
  3. Security Scan - npm audit + Trivy vulnerability scanner
  4. Build & Push - Docker image to container registry
  5. Deploy Staging - Environment-gated deployment
  6. 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

StrategyUse CaseRisk
RollingDefault, gradual replacementLow - automatic rollback
Blue-GreenInstant switch, easy rollbackMedium - double resources
CanaryProgressive traffic shiftLow - 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.

TopicFetch from
GitHub Actions workflow syntax, matrix builds, artifact upload/download, cache mechanicshttps://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 testshttps://docs.github.com/en/actions/tutorials/use-containerized-services/use-docker-service-containers
Deployment environments and approval gateshttps://docs.github.com/en/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments
Protected branches and required status checkshttps://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 fieldhttps://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 classeshttps://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ (house baseline stays in references/ork-delta.md)
PodDisruptionBudget semantics and eviction APIhttps://kubernetes.io/docs/tasks/run-application/configure-pdb/ (house minAvailable floor stays in references/ork-delta.md)
StatefulSets, ordinal identity, volumeClaimTemplateshttps://kubernetes.io/docs/concepts/workloads/controllers/statefulset/
Helm chart authoring, templating and values fileshttps://helm.sh/docs/topics/charts/ (the chart directory layout we use stays in references/checklists-and-templates.md)
External Secrets Operator CRD fields and backendshttps://external-secrets.io/latest/api/externalsecret/ (house refresh/creation policy stays in references/ork-delta.md)
ArgoCD automated sync, prune and self-healhttps://argo-cd.readthedocs.io/en/stable/user-guide/auto_sync/ (house retry/backoff stays in references/ork-delta.md)
Terraform S3 backend and state lockinghttps://developer.hashicorp.com/terraform/language/backend/s3 (house backend config stays in references/ork-delta.md)
Terraform module composition and variable fileshttps://developer.hashicorp.com/terraform/language/modules
Alembic revision, upgrade and downgrade CLIhttps://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 dashboardshttps://prometheus.io/docs/prometheus/latest/querying/functions/
Prometheus alerting rule syntaxhttps://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 spanshttps://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/fastapi/fastapi.html
structlog context bindinghttps://www.structlog.org/en/stable/contextvars.html (the bind-then-call ordering stays in references/ork-delta.md)

Use this skill in a project

Open any RiverX project, search the Skills panel for yonatangross/orchestkit/devops-deployment, and install it in one click.

Use this skill