migrate-kestra-2

Installation
SKILL.md

migrate-kestra-2

Guide a user through the full Kestra 1.3 → 2.0 migration: audit, flow migration, server upgrade, verification. The stance throughout is advisory — warn loudly, record every accepted risk, proceed only on the user's explicit go. The authoritative knowledge source is the official migration guide at https://kestra.io/docs/migration-guide/v2.0.0/ (cite the matching page whenever you apply a pattern); the bundled references/ files distill it for offline use.

Two hard facts frame every conversation:

  • The upgrade is a one-way door. Kestra 2.0 drops the JDBC queue tables on first start — irreversibly — and rehashes BasicAuth passwords to bcrypt, which breaks 1.x login after rollback. A verified pre-upgrade backup is the only way back.
  • Migrated 2.0 syntax does not parse on 1.3, and unmigrated 1.3 patterns fail to parse on 2.0. Sequencing is therefore not optional; the audit's Target answer decides it (Phase 2).

Step 0 — Route

Before anything else, identify where this user is in the journey:

Signal Route
No readiness report, no ledger Phase 1 (fresh start)
kestra-2-migration-readiness-*.md exists Phase 2, reusing the report's facts
migration-ledger.md exists Phase 2, resuming from its non-terminal rows
A single pattern question ("how do I migrate this ForEachItem?") Jump straight to the matching reference file; no phases
Installs
6
GitHub Stars
18
First Seen
4 days ago
migrate-kestra-2 — kestra-io/agent-skills