ankra-gitops

Structure Ankra GitOps repositories with modular include paths and ImportCluster configuration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ankra GitOps helps teams structure and manage Kubernetes deployments by storing cluster and stack definitions in a Git repository and syncing changes to your clusters via ArgoCD.

Core Features & Use Cases

  • Modular layout with include paths to keep stacks organized across repos.
  • ImportCluster integration to reference stacks from a Git repository (examples show provider, credential_name, repository, branch).
  • Git as the single source of truth; PR-based workflow for changes; guardrails to prevent direct in-cluster edits.

Quick Start

Connect your Git repository to Ankra and follow the recommended folder structure to begin syncing clusters and stacks.

Frequently Asked Questions about ankra-gitops

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

FAQPage Schema
How do I structure a GitOps repository for Kubernetes cluster and stack definitions?

To structure a GitOps repository for Kubernetes, use a modular layout with include paths to organize stacks across repos. This keeps cluster and stack definitions in Git, syncing them to clusters via ArgoCD as the single source of truth.

What is the PR-driven workflow for Kubernetes GitOps and how does it prevent direct in-cluster edits?

A PR-driven workflow for Kubernetes GitOps governs changes by requiring pull requests to update cluster configurations. This enforces Git as the source of truth and provides guardrails to prevent direct, untracked in-cluster edits.

How do I connect a Git repository to a Kubernetes cluster using ImportCluster configuration?

To connect a Git repository to a Kubernetes cluster, use ImportCluster configuration by specifying the git_repository, provider, credential_name, and branch. This links your Git definitions to the cluster for syncing.

Does ArgoCD work with a modular GitOps layout for Kubernetes stacks?

Yes, ArgoCD works with a modular GitOps layout by syncing Kubernetes stacks organized through include paths across multiple repositories. This integration keeps your clusters aligned with the definitions stored in Git.

Why use Git as the single source of truth for Kubernetes configurations instead of direct cluster edits?

Using Git as the single source of truth for Kubernetes configurations ensures all changes are tracked, reviewed via PRs, and auditable. This prevents configuration drift and avoids the risks of direct, unrecorded in-cluster edits.

Can I organize multiple Kubernetes stacks across different Git repositories?

Yes, you can organize multiple Kubernetes stacks across different Git repositories using a modular include-path layout. This allows you to reference stacks from separate repositories while maintaining a unified GitOps workflow.