kubespray-airgap

Automate Kubernetes deployment in air-gapped environments with kubespray-offline.

6|2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/sigridjineth/kubespray-skills --skill kubespray-airgap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubespray-airgap
Source: https://github.com/sigridjineth/kubespray-skills/tree/main/kubespray-airgap
Command: npx skills add https://github.com/sigridjineth/kubespray-skills --skill kubespray-airgap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables the deployment of Kubernetes clusters in environments completely isolated from the internet, ensuring security and compliance for sensitive networks.

Core Features & Use Cases

  • Offline Deployment: Automates the staging and deployment of all necessary binaries and container images for Kubernetes without internet access.
  • Private Registry Setup: Configures and utilizes a private container registry for image distribution within the air-gapped network.
  • Use Case: Deploy a production-ready Kubernetes cluster on a secure, air-gapped government network where external connectivity is strictly prohibited.

Quick Start

Use the kubespray-airgap skill to deploy a Kubernetes cluster to an air-gapped environment following the provided workflow.

Frequently Asked Questions about kubespray-airgap

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

FAQPage Schema
How do I deploy Kubernetes in an air-gapped network without internet access?

To deploy Kubernetes in an air-gapped network, you must stage all required binaries and container images offline. This Skill automates staging binaries, setting up a private registry, and configuring containerd mirrors to ensure isolated deployment.

What is the best way to set up a private container registry for an offline Kubernetes cluster?

Setting up a private container registry for offline Kubernetes involves staging images externally and transferring them inward. This Skill configures a private registry and containerd mirror settings to distribute images within the isolated network.

How does containerd mirror configuration work for offline image distribution?

Containerd mirror configuration for offline distribution redirects image pulls to a local private registry. This Skill configures containerd to use the private registry, ensuring nodes fetch staged images without requiring external internet connectivity.

Can I use kubespray to automate staging binaries and container images for isolated environments?

Yes, you can use kubespray with the kubespray-offline tool to automate staging for isolated environments. This Skill facilitates the multi-step pipeline to download binaries and images, transfer them, and deploy Kubernetes securely.

What are the steps to transfer Kubernetes binaries into a secure air-gapped environment?

Transferring Kubernetes binaries into a secure air-gapped environment requires a multi-step download, transfer, and deployment pipeline. You must carefully adhere to this workflow to stage files externally and move them into the isolated network for deployment.

Does offline Kubernetes deployment require configuring containerd separately from the private registry?

Offline Kubernetes deployment requires both a private registry and containerd mirror configuration. This Skill ensures containerd is set up to pull from the private registry, maintaining cluster operations across the air-gapped network.