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

nas-admin

Manage Kubernetes PVs and PVCs for an SMB-backed NAS admin panel.

1|Updated Apr 3, 2026
Search Tags:#fastapi#kubernetes#helm#oidc#nas#persistentvolumes#persistentvolumeclaims
One-click install
npx skills add https://github.com/villadalmine/infra --skill nas-admin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nas-admin
Source: https://github.com/villadalmine/infra/tree/main/skills/nas-admin
Command: npx skills add https://github.com/villadalmine/infra --skill nas-admin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the guesswork from managing Kubernetes storage backed by a legacy SMB NAS by showing which workloads own which PVs and PVCs, highlighting orphaned or unused volumes, and providing safe cleanup actions without touching the underlying NAS data.

Core Features & Use Cases

  • Volume visibility: Review all SMB-backed PersistentVolumes and PersistentVolumeClaims across namespaces, including status, ownership, age, and mounted pods.
  • Safe cleanup workflow: Delete released or orphaned Kubernetes storage objects while preserving NAS share contents when reclaim policy is set to Retain.
  • Web admin panel deployment: Work with the FastAPI app, HTMX UI, Helm chart, and Ansible automation used to build, configure, and deploy the panel in the cluster.
  • Authentication options: Configure either basic auth or GitHub OIDC via oauth2-proxy sidecar for secured access.
  • Iteration and debugging: Use the local Docker workflow or the Kaniko-based in-cluster build path to test UI and backend changes quickly.

Quick Start

Ask the assistant to deploy or update the nas-admin panel for your cluster, including the desired hostname and authentication mode.

Frequently Asked Questions about nas-admin

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

FAQPage Schema
How do I find orphaned PersistentVolumes and PersistentVolumeClaims in Kubernetes?▼

To find orphaned PersistentVolumes and PersistentVolumeClaims in Kubernetes, you can use a web admin panel to review SMB-backed storage inventory across namespaces, highlighting unused volumes and their mounted pods.

Can I safely delete released Kubernetes PersistentVolumes without losing NAS data?▼

You can safely delete released Kubernetes PersistentVolumes without losing NAS data when the reclaim policy is set to Retain, which preserves the underlying SMB share contents during cleanup.

How do I deploy a FastAPI storage admin panel with Helm?▼

To deploy a FastAPI storage admin panel with Helm, configure the chart with your desired hostname and authentication mode, using Kaniko-based in-cluster builds or local Docker workflows for iteration.

Does the Kubernetes storage admin panel support GitHub OIDC authentication?▼

The Kubernetes storage admin panel supports GitHub OIDC authentication via an oauth2-proxy sidecar, alongside basic auth options, securing browser-based NAS inspection and volume management.

What is the best way to map Kubernetes workloads to legacy SMB NAS volumes?▼

The best way to map Kubernetes workloads to legacy SMB NAS volumes is using an admin panel that displays volume ownership, status, and age, removing guesswork from cluster storage operations.

Why use HTMX for a Kubernetes volume cleanup interface?▼

Using HTMX for a Kubernetes volume cleanup interface provides dynamic UI behavior within a FastAPI application without heavy JavaScript frameworks, streamlining PersistentVolume inventory review and deletion.

Related Skills

Explore More Software Engineering Skills→
villadalminevilladalmine
1

storage

Configure SMB-backed Kubernetes storage for legacy NAS with static PV/PVC mounts.

Community
Intermediate
YH-05YH-05
1

sync-nas

Synchronize files from mounted NAS paths to local environments using differential rsync.

Community
Intermediate
MassimilianoPiliMassimilianoPili

oauth2-proxy-patterns

Implement OAuth2 Proxy dual-instance deployment with Keycloak OIDC and nginx auth_request.

Community
Advanced
googlegoogle
17.1k

gke-storage

Automate GKE storage management by configuring PersistentVolumes, PersistentVolumeClaims, Filestore, and GCS FUSE.

Official
Intermediate