mozcloud-chart-migration

Automate custom tenant Helm chart migration to the mozcloud shared chart.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mozilla/mozcloud --skill mozcloud-chart-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mozcloud-chart-migration
Source: https://github.com/mozilla/mozcloud/tree/main/claude/plugins/mozcloud-tools/skills/mozcloud-chart-migration
Command: npx skills add https://github.com/mozilla/mozcloud --skill mozcloud-chart-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires helm, git, render-diff, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables safe, guided migration of custom tenant Helm charts to the mozcloud shared chart by providing a structured workflow, gating templates, and comprehensive documentation and validation artifacts.

Core Features & Use Cases

  • Scaffold migration by downloading the latest mozcloud reference chart into a dedicated .migration workspace
  • Gate non-mozcloud templates behind mozcloud.enabled to support multi-environment migrations (dev/stage/prod)
  • Generate migration planning artifacts (MIGRATION_PLAN_<ENV>.md, CHANGES_<ENV>.md) and diff analyses (DIFF_ANALYSIS_<ENV>.md)
  • Render and compare manifests using render-diff and helm template to verify semantic equivalence
  • Preserve original resource/workload names and provide guidance for regional/multi-environment values
  • Support resuming work by reading and updating the .migration README and status trackers

Quick Start

Initiate the migration workflow from the target chart directory to scaffold the MozCloud migration, download the reference chart, and prepare the migration workspace.

This sentence is a natural-language instruction for hands-on initiation of the migration process.

Quick Start (example)

Begin in the target chart directory, run the preflight checks, then start the migration workflow to scaffold planning docs and fetch the MozCloud reference.

Frequently Asked Questions about mozcloud-chart-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate custom Helm charts to a shared mozcloud chart?

Migrate custom Helm charts to mozcloud by running the workflow from the target chart directory to download the reference chart, gate templates, and generate planning artifacts. It preserves resource names and validates semantic equivalence using render-diff and helm template.

What is the best way to validate Helm chart migration changes across dev, stage, and prod environments?

Validating Helm chart migration across environments uses render-diff and helm template to compare original manifests against the mozcloud chart. It generates diff analyses and changes documentation for each specific environment to ensure equivalence.

Does migrating Helm charts to mozcloud require git or helm dependencies?

Migrating Helm charts to mozcloud requires both helm and git dependencies, plus the render-diff tool. The workflow operates within a dedicated .migration workspace and explicitly prevents user git commits during the migration process.

Can I preserve original workload names when moving tenant Helm charts to a shared chart?

Preserving original resource and workload names during tenant chart migration is supported by the mozcloud workflow. It gates non-mozcloud templates behind mozcloud.enabled and provides guidance for regional and multi-environment values.

Why does my Helm chart migration workflow prevent git commits?

The Helm chart migration workflow prevents user git commits to ensure all changes remain isolated within the .migration workspace. This structured approach captures original manifests and writes migration docs safely without altering repository history.

How do I resume an interrupted mozcloud Helm chart migration?

Resume an interrupted mozcloud chart migration by reading and updating the .migration README and status trackers. The workflow scaffolds planning docs and fetches reference charts, allowing you to continue from your last saved state.