kcc-direct-controller-logic-implementer

Implement direct KCC Adapter logic and E2E fixtures for GCP service resources.

1.1k|367|Updated Apr 8, 2019
One-click install
npx skills add https://github.com/GoogleCloudPlatform/k8s-config-connector --skill kcc-direct-controller-logic-implementer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kcc-direct-controller-logic-implementer
Source: https://github.com/GoogleCloudPlatform/k8s-config-connector/tree/main/.gemini/skills/kcc-direct-controller-logic-implementer
Command: npx skills add https://github.com/GoogleCloudPlatform/k8s-config-connector --skill kcc-direct-controller-logic-implementer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers implement direct Config Connector reconciliation (Adapter logic) and validate it end-to-end against real or mocked GCP so updates reliably reach the desired state.

Core Features & Use Cases

  • Adapter implementation: Implements Find, Create, Update, and Delete for a direct KCC resource, including correct mapper usage and error handling such as 404 behavior in Find.
  • Test fixture authoring: Produces Minimal and Maximal E2E resource fixtures that exercise required-only vs full-field coverage.
  • Golden recording & verification: Records HTTP traffic and generated object golden files against Real GCP (with timeouts) or MockGCP for faster iteration, then verifies CRD field coverage via API checks.

Quick Start

Ask the AI to guide you through implementing the Adapter in pkg/controller/direct/<service>/<resource_lower>_controller.go, creating the minimal and maximal fixture create/update.yaml files, and recording golden files using the provided RUN_E2E and E2E_GCP_TARGET settings.

Frequently Asked Questions about kcc-direct-controller-logic-implementer

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

FAQPage Schema
How do I implement direct Config Connector reconciliation for a GCP resource?

Implement direct Config Connector reconciliation by adding Adapter logic for Find, Create, Update, and Delete operations in the specific controller file, ensuring correct mapper usage and proper error handling like 404 behavior in Find.

How do I create E2E test fixtures for Kubernetes controller CRD field coverage?

Create E2E test fixtures by building Minimal and Maximal resource YAML files that exercise required-only versus full-field coverage, validating CRD field behavior through fixture-driven end-to-end verification.

How does golden test recording work for GCP reconciliation adapters?

Golden test recording captures HTTP traffic and generated object state outputs against real GCP or MockGCP, storing them as golden files to verify adapter reconciliation correctness and ensure updates reliably reach the desired state.

Can I validate KCC adapter logic against MockGCP instead of real GCP?

Yes, you can validate KCC adapter logic against MockGCP for faster iteration by configuring the E2E_GCP_TARGET setting, or run against real GCP with timeouts to verify actual GCP reconciliation behavior.

What directory structure is needed for KCC direct adapter testdata fixtures?

The testdata fixture directory structure requires organizing files using resource_kind, service_name, api_version, and resource_lower parameters to correctly route minimal and maximal E2E fixtures for create and update verification.

Why does my Config Connector Find operation return a 404 error during reconciliation?

A 404 error during Config Connector Find indicates the GCP resource does not exist, which adapter logic must handle gracefully by triggering Create rather than failing the reconciliation cycle.