# Shopify/krane

A command-line tool that helps you ship changes to a Kubernetes namespace and understand the result

Repository: https://github.com/Shopify/krane
Canonical: https://ross.abutalabs.com/products/krane
Language: Ruby
License: MIT
License Family: permissive
Topics: kubernetes, deploy-tool
Last push: 2026-02-18T13:42:55+00:00

## Health v2 (maintenance only)
Score: 53/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 68, release rhythm 8, longevity 100
- inputs: {"age_days": 3515, "days_push": 196, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1417, forks 117 (observed 2026-08-28T04:04:40.097878+00:00)

## What it is
Krane is a Ruby command-line tool from Shopify that deploys changes to a Kubernetes namespace and reports a clear pass/fail result with debugging info on failure. It wraps kubectl with rollout watching, predeploys, EJSON-based secrets, and helper commands for rendering templates, running tasks, and restarting deployments.

## Use cases
- deploy kubernetes manifests from CI with a clear pass/fail result
- watch kubernetes rollouts and debug failed deploys
- predeploy configmaps and secrets before deployments
- create kubernetes secrets from encrypted e committed to git
- run one-off tasks like rails migrations as bare pods during deploy
- restart a kubernetes deployment from the command line
- render dynamic values into kubernetes templates before deploying

## When to choose
- you deploy to a single kubernetes namespace from CI/CD and need actionable success/failure output
- you want predeploy ordering and rollout verification beyond plain kubectl apply
- you use Shopify's Shipit or want e-managed secrets in your repo

## When to avoid
- you need gitops-style continuous reconciliation rather than push-based deploys
- you prefer helm, kustomize, or a full CD platform like Argo CD or Flux
- your project is not Ruby-friendly or you need a tool with active feature development

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: deployment, cli, infrastructure-as-code, monitoring
- domain: cloud-computing, developer-tools
- platform: cli, ruby
- tags: kubernetes, deploy-tool, kubernetes-deploy, e-secrets, shipit, devops, containers

## Member repositories
- Shopify/krane (main) score 53

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:40.097878+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:59.858723+00:00, confidence not recorded.
  - readme: https://github.com/Shopify/krane (fetched 2026-08-28T04:04:40.097878+00:00, sha 4c3045f801c9)
- Data as of 2026-08-30T08:39:29.467469+00:00.