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.