Homelab Wave Migration (Compose → k3s)
CommunityMigrate homelab services to k3s
AuthorLucasSantana-Dev
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill automates the complex process of migrating services from Docker Compose to a Kubernetes (k3s) environment, ensuring a smooth transition with minimal downtime.
Core Features & Use Cases
- Phased Migration: Execute services in waves (A, B, C, D) based on risk and statefulness.
- Preflight Checks & Validation: Ensures k3s, Terraform, SOPS, and service health are ready before migration.
- Automated Deployment: Builds and deploys Helm charts for services in k3s.
- Network Policy Management: Automatically configures essential Network Policies for Traefik ingress.
- Stateful Data Migration: Provides a workflow for migrating data from Docker volumes to k3s Persistent Volume Claims.
- Cutover & Rollback: Facilitates seamless switching from Docker Compose to k3s and includes rollback procedures.
- Use Case: Migrating your self-hosted password manager (Vaultwarden) from a Docker Compose setup to k3s, ensuring data integrity and secure access.
Quick Start
Initiate the pre-flight checks for migrating services to k3s by running the migration preflight command.
Dependency Matrix
Required Modules
None requiredComponents
scriptsreferences
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: Homelab Wave Migration (Compose → k3s) Download link: https://github.com/LucasSantana-Dev/homelab/archive/main.zip#homelab-wave-migration-compose-k3s Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.