skills.rest
villadalmine
villadalmineCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

k3s

Manage K3s cluster operations on ARM64 nodes and control-plane services.

1|Updated Apr 3, 2026
Search Tags:#troubleshooting#kubernetes#ansible#arm64#kubeconfig#k3s
One-click install
npx skills add https://github.com/villadalmine/infra --skill k3s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: k3s
Source: https://github.com/villadalmine/infra/tree/main/.agents/skills/k3s
Command: npx skills add https://github.com/villadalmine/infra --skill k3s

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The k3s skill helps you operate and troubleshoot an ARM64 K3s cluster without guessing at the correct installation, runtime, or upgrade steps.

Core Features & Use Cases

  • Explains the active K3s server flags and how they affect networking, storage, and control-plane behavior.
  • Guides service management, kubeconfig retrieval, node joins, and version upgrades in an Ansible-managed environment.
  • Helps diagnose common issues such as NotReady nodes, crash loops, port conflicts, and storage or permission problems.

Quick Start

Ask for a safe, step-by-step guide to inspect the current K3s status, review the active flags, and perform the next required cluster operation.

Frequently Asked Questions about k3s

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

FAQPage Schema
How do I troubleshoot K3s nodes stuck in NotReady state on ARM64?▼

Troubleshooting NotReady K3s nodes on ARM64 involves checking systemd service status, resolving port conflicts, and verifying network connectivity to the control plane. This skill diagnoses common node failure causes like crash loops and permission problems to restore cluster health.

What is the best way to manage kubeconfig retrieval for an Ansible-managed K3s cluster?▼

Managing kubeconfig retrieval for an Ansible-managed K3s cluster requires extracting the configuration from the control-plane node and structuring it for idempotent playbook execution. This skill guides safe kubeconfig handling to ensure reproducible cluster access.

How do K3s server flags affect networking and storage on bare-metal Raspberry Pi clusters?▼

K3s server flags directly control networking, local-path-provisioner storage, and control-plane behavior on bare-metal Raspberry Pi clusters. This skill explains active flags to help you configure cluster runtime parameters without guessing.

Can I use Cilium with K3s on ARM64 nodes?▼

Yes, you can use Cilium with K3s on ARM64 nodes by configuring the appropriate server flags during installation. This skill requires awareness of Cilium to help you maintain compatible networking and control-plane services.

Why does my K3s upgrade fail or break idempotency in Ansible playbooks?▼

K3s upgrades break idempotency in Ansible when installation state is not properly tracked or server flags are inconsistent across nodes. This skill helps manage version upgrades and installation state to keep changes reproducible.

How do I join new worker nodes to an existing K3s cluster on ARM64?▼

Joining new worker nodes to an ARM64 K3s cluster requires the correct server URL, node token, and service management steps via systemd. This skill provides step-by-step guidance for node joins in Ansible-managed environments.

Related Skills

Explore More Software Engineering Skills→
Kord96Kord96

add-node

Provision remote machines as k3s nodes over SSH and Tailscale.

Community
Advanced
fajshahfajshah
1

multicloud-k8s

Provision and manage Kubernetes clusters across DigitalOcean DOKS and Hetzner Cloud K3s.

Community
Advanced
LucasSantana-DevLucasSantana-Dev

Homelab k3s Operations

Inspect pods, manage Helm releases, and debug k3s clusters.

Community
Intermediate
villadalminevilladalmine
1

cluster-planning

Analyzes surveyed cluster hardware and creates a phased K3s deployment roadmap.

Community
Advanced