ankra-import-cluster

Apply ImportCluster manifests to onboard Kubernetes clusters into Ankra GitOps workflows.

26|2|Updated Jul 11, 2025
One-click install
npx skills add https://github.com/ankraio/ankra-cli --skill ankra-import-cluster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ankra-import-cluster
Source: https://github.com/ankraio/ankra-cli/tree/main/internal/skills/embedded/skills/ankra-import-cluster
Command: npx skills add https://github.com/ankraio/ankra-cli --skill ankra-import-cluster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboard an existing Kubernetes cluster into Ankra by authoring and applying an ImportCluster manifest that wires a GitOps repository and declares stacks of manifests and Helm addons with dependency ordering. This enables seamless onboarding of clusters and integration with Git-backed workflows for continuous deployment.

Core Features & Use Cases

  • Declarative cluster onboarding: define an ImportCluster resource to represent your cluster and its configuration.
  • GitOps-backed stacks: connect a Git repository to store and synchronize stacks of manifests and Helm addons.
  • Dependency-aware deployment: specify parent relationships to enforce deployment order between manifests and addons.

Quick Start

Create a cluster.yaml ImportCluster manifest and apply it with ankra cluster apply -f cluster.yaml --cluster <name>.

Frequently Asked Questions about ankra-import-cluster

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

FAQPage Schema
How do I onboard an existing Kubernetes cluster into a GitOps workflow?

GitOps-backed cluster onboarding uses an ImportCluster manifest to connect a Git repository to your Kubernetes cluster. This manifest declares stacks of manifests and Helm addons, synchronizing them via a version-controlled repository to manage continuous deployment.

Can I enforce deployment ordering for Helm addons and manifests in Kubernetes?

Yes, you can enforce deployment ordering by specifying parent relationships within your ImportCluster manifest. This dependency-aware mechanism ensures manifests and Helm addons deploy in the correct sequence to maintain reproducible environments.

Does this GitOps onboarding approach work for EKS, GKE, and AKS clusters?

Yes, importing clusters via an ImportCluster manifest applies to use cases such as importing EKS, GKE, AKS, or on-prem clusters. It connects these existing Kubernetes platforms to a version-controlled GitOps workflow to manage manifests and addons.

What fields are required in an ImportCluster manifest?

An ImportCluster manifest requires structured fields like spec.git_repository and stacks containing manifests and addons. Proper parent relationships must also be defined to enforce deployment order and promote reproducible environments.

How do I apply an ImportCluster manifest to connect a Git repository?

You apply an ImportCluster manifest by running the command ankra cluster apply -f cluster.yaml --cluster <name>. This action wires the specified GitOps repository to your cluster and deploys the declared stacks.

What is the best way to manage Kubernetes manifests and Helm addons via Git?

The best way to manage manifests and Helm addons via Git is declaring them as stacks within an ImportCluster manifest. This method wires a GitOps repository to your cluster and uses dependency ordering to ensure proper deployment.