crd-update

Modify Kubernetes/OpenShift CRDs and API types with kubebuilder validation markers.

1|1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/wangke19/my-claude-skills --skill crd-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crd-update
Source: https://github.com/wangke19/my-claude-skills/tree/main/plugins/ocp/skills/crd-update
Command: npx skills add https://github.com/wangke19/my-claude-skills --skill crd-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely updating Kubernetes/OpenShift CRDs and API types requires careful planning to preserve compatibility, manage API versioning, and avoid breaking changes. This skill provides a protocol for applying kubebuilder validation markers, regenerating manifests, and implementing migrations or conversion webhooks.

Core Features & Use Cases

  • Safeguards CRD evolution with explicit validation markers and versioned API changes.
  • Guides manifest regeneration and backward-compatibility checks across releases.
  • Includes migration paths and guidance for conversion webhooks, ensuring smooth upgrades.

Quick Start

Follow the CRD update protocol to modify API types, regenerate manifests, and migrate changes safely.

Frequently Asked Questions about crd-update

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

FAQPage Schema
How do I safely update Kubernetes CRDs without breaking existing deployments?

To safely update Kubernetes CRDs, you modify API types with kubebuilder validation markers, regenerate manifests, and verify backward-compatibility. This process prevents breaking existing deployments by carefully managing field additions, removals, and version transitions.

When do I need a conversion webhook for backward-compatible API changes?

You need a conversion webhook for backward-compatible API changes when altering CRD field types or structures across versions. It translates data between API versions, ensuring smooth upgrades and preserving compatibility when fields are modified in breaking ways.

What is the best way to add kubebuilder validation markers to existing CRD types?

The best way to add kubebuilder validation markers to CRD types is applying them directly to Go struct fields before regenerating manifests. This ensures the Kubernetes API server enforces schema validation rules, safeguarding CRD evolution.

How do I handle breaking API changes when migrating OpenShift CRDs?

Handling breaking API changes in OpenShift CRDs requires implementing versioned API types and conversion webhooks. You must establish clear migration paths, update API types, regenerate manifests, and integrate tests to manage the transition safely.

Do I need to regenerate manifests after modifying CRD API types?

Yes, you need to regenerate manifests after modifying CRD API types. Regenerating manifests applies the updated kubebuilder validation markers and schema definitions to your Kubernetes manifests, ensuring the deployed CRDs match the new API type definitions.

What are the limitations of updating CRD types without conversion webhooks?

Updating CRD types without conversion webhooks limits you to non-breaking changes like adding optional fields. Removing or renaming fields requires conversion webhooks to translate between API versions, preventing data loss and ensuring backward-compatibility.