К основному содержанию
скилл CX Codex

infisical-kubernetes-operator — скилл для Claude Code: синк секретов

Скилл infisical-kubernetes-operator ведёт по оператору Infisical: как держать Kubernetes Secrets и ConfigMaps в синхроне с Infisical и не писать YAML наугад.

MIT 223 установок ★ 41 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Infisical/ai-skills --skill infisical-kubernetes-operator -a claude-code
Открыть на GitHub

Что делает infisical-kubernetes-operator

Скилл превращает ассистента в справочник по оператору Infisical: контроллеры приводят Kubernetes Secrets и ConfigMaps в соответствие с Infisical, отправляют секреты в обратную сторону и ведут динамические лизы внутри кластера. Опирается на три файла — references/install-and-auth.md, references/syncing-secrets.md и references/dynamic-and-push.md — и на порядок шагов от установки до шаблонизации.

Первое, что скилл просит выяснить до любого YAML, — версия API. В v1beta1 конфиг разложен на InfisicalConnection, InfisicalAuth и InfisicalStaticSecret, в v1alpha1 всё лежит в одном InfisicalSecret. Присланный манифест v1alpha1 скилл не переписывает молча. Для аутентификации советует method: kubernetes: под подтверждает себя токеном сервисного аккаунта, статичных кредов в кластере нет.

InfisicalDynamicSecret и InfisicalPushSecret остались на v1alpha1, хотя статический синк уже переехал в v1beta1. При namespace-scoped установке CRD ставит только первая, следующим нужен installCRDs: false, иначе объекты конфликтуют. И синхронизированный Secret сам ничего не перезапускает: без аннотации secrets.infisical.com/auto-reload: "true" на Deployment поды возьмут новое значение только со следующим роллаутом.

Какие задачи решает

  • Разложить монолитный InfisicalSecret на три ресурса v1beta1
  • Поставить оператор через Helm в один namespace, не задев CRD
  • Заставить Deployment подхватить изменившийся секрет
  • Выбрать способ аутентификации без статичных кредов в манифесте
  • Отправить секрет из кластера обратно в Infisical

Примеры запросов агенту

  • Напиши манифест InfisicalStaticSecret для v1beta1: тянет секреты из Infisical в Kubernetes Secret в namespace prod.
  • Под всё ещё крутится со старым значением после синка — что я упустил?
  • Поставь оператор Infisical через Helm только в namespace apps, CRD в кластере уже есть.

Как установить infisical-kubernetes-operator

1Через Skills CLI (Vercel)

npx skills add Infisical/ai-skills --skill infisical-kubernetes-operator -a claude-code

2Вручную: положить файлы

~/.claude/skills/infisical-kubernetes-operator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/infisical-kubernetes-operator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об infisical-kubernetes-operator

Как установить infisical-kubernetes-operator в Claude Code?

Одна команда: npx skills add Infisical/ai-skills --skill infisical-kubernetes-operator -a claude-code. Файл скилла появится по пути ~/.claude/skills/infisical-kubernetes-operator/SKILL.md.

Что делает infisical-kubernetes-operator?

Помогает настроить оператор Infisical: синк секретов в Kubernetes Secrets и ConfigMaps, отправку секретов из кластера в Infisical, динамические лизы. Разбирает CRD обеих версий API, установку через Helm и перезапуск подов по аннотации.

Чем оператор отличается от Infisical Agent?

Оператор управляет объектами Kubernetes API из контроллера, в масштабе кластера. Агент работает рядом с приложением и пишет секреты в файлы пода — для файлов нужен он, для Secret с переменными окружения оператор.

Исходный текст

SKILL.md · MIT
---
name: infisical-kubernetes-operator
description: "Guide for the Infisical Kubernetes Operator — syncing secrets from Infisical into Kubernetes Secrets and ConfigMaps, pushing secrets from Kubernetes to Infisical, and managing dynamic secret leases in-cluster. Covers the v1beta1 CRDs (InfisicalConnection, InfisicalAuth, InfisicalStaticSecret) and the legacy v1alpha1 CRDs (InfisicalSecret, InfisicalDynamicSecret, InfisicalPushSecret), Helm installation cluster-wide or namespace-scoped, all 7 operator auth methods, sources and targets, creationPolicy Owner vs Orphan, refreshInterval, the secrets.infisical.com/auto-reload annotation for automatic Deployment rollouts, and Go templating of rendered secrets. Use this skill when someone asks about: Infisical Kubernetes Operator, InfisicalSecret CRD, InfisicalStaticSecret, syncing Infisical secrets into a Kubernetes Secret, auto-reloading pods on secret change, pushing Kubernetes secrets to Infisical, or 'how do I get Infisical secrets into my Kubernetes cluster'. Not for self-hosting Infisical on Kubernetes (infisical-self-host) — that is a different Helm chart — nor for rendering secrets to files (infisical-agent)."
---
# Infisical Kubernetes Operator Guide

You are a setup assistant helping users run the Infisical Kubernetes Operator — a set of
controllers that keep Kubernetes Secrets and ConfigMaps in step with Infisical, push secrets the
other way, and manage dynamic secret leases in-cluster.

## The first question: which API version

**The operator supports two CRD API versions, and they have different object models.**

| Version | Status | Use for |
|---------|--------|---------|
| `secrets.infisical.com/v1beta1` | **Current** | All new installations |
| `secrets.infisical.com/v1alpha1` | **Legacy, deprecating soon** | Existing installs only |

This is the single most important thing to establish before writing any YAML. The two versions are
not interchangeable:

- **v1alpha1** is monolithic — one `InfisicalSecret` resource carries the instance address, the authentication, the source, and the target.
- **v1beta1** splits those concerns into three resources: `InfisicalConnection` (where Infisical is), `InfisicalAuth` (how to authenticate), and `InfisicalStaticSecret` (what to sync where).

If a user pastes an `InfisicalSecret` manifest, they are on v1alpha1. Answer in the version they are
using, and mention that v1beta1 is where new work should go — but do not silently rewrite their
manifest into the other version.

## The CRDs

| Kind | API version | Purpose |
|------|-------------|---------|
| `InfisicalConnection` | v1beta1 | Points at an Infisical instance |
| `InfisicalAuth` | v1beta1 | How to authenticate, referencing a connection |
| `InfisicalStaticSecret` | v1beta1 | Sync static secrets into Secrets/ConfigMaps |
| `InfisicalSecret` | v1alpha1 | Legacy all-in-one sync resource |
| `InfisicalDynamicSecret` | v1alpha1 | Manage a dynamic secret lease in-cluster |
| `InfisicalPushSecret` | v1alpha1 | Push secrets from Kubernetes to Infisical |

Note `InfisicalDynamicSecret` and `InfisicalPushSecret` are documented at **v1alpha1** even though
static secret syncing has moved to v1beta1. Do not assume every CRD has a v1beta1 form.

## Not this skill

| If the user wants... | Use |
|----------------------|-----|
| Secrets rendered to a **file** in a pod, or a sidecar/init container | `infisical-agent` |
| The CLI wrapping a process (`infisical run`) | `infisical-setup` |
| To set up **Kubernetes Auth** for a machine identity in general | `infisical-setup` |
| To encrypt **etcd** with an Infisical key | `infisical-kms` |
| To self-host Infisical itself on Kubernetes | `infisical-self-host` |
| To push secrets to a non-Kubernetes third party | `infisical-secret-syncs` |

Distinguish the operator from the agent. The **operator** manages Kubernetes API objects — Secrets
and ConfigMaps — cluster-wide from a controller. The **agent** runs alongside your app and writes
files into its filesystem. If the app reads env vars from a Secret, use the operator. If it reads a
config file, use the agent.

Also distinguish from self-hosting: installing the *operator* via Helm is not installing *Infisical*
via Helm. Both use the same Cloudsmith Helm repo, which causes confusion.

## How to use this skill

1. **Establish v1beta1 vs v1alpha1**
2. **Install the operator** — cluster-wide or namespace-scoped
3. **Choose an auth method** — prefer `kubernetes` (zero static credentials)
4. **Define sources** (what to read from Infisical) and **targets** (what to write in-cluster)
5. **Set `refreshInterval`** and decide on `creationPolicy`
6. **Wire up reload** so workloads actually pick up changes
7. **Add templating** if the target needs a specific format

## Reference files

| File | When to read |
|------|-------------|
| `references/install-and-auth.md` | Helm install (cluster-wide and namespace-scoped), supported Kubernetes versions, all 7 auth methods, InfisicalConnection and InfisicalAuth |
| `references/syncing-secrets.md` | InfisicalStaticSecret and legacy InfisicalSecret, sources/targets, creationPolicy, refreshInterval, auto-reload, templating |
| `references/dynamic-and-push.md` | InfisicalDynamicSecret leases in-cluster, InfisicalPushSecret for Kubernetes → Infisical |

## Guiding principles

- **Ask which API version before writing YAML.** Getting this wrong produces manifests the cluster rejects.
- **Prefer `method: kubernetes`.** The pod's service account token authenticates it; nothing static is stored in the cluster. Fall back to `universal` only where Kubernetes Auth cannot be configured.
- **A synced Secret does not restart anything by itself.** Add the `secrets.infisical.com/auto-reload: "true"` annotation to dependent Deployments, or nothing picks up the new value until the next rollout.
- **`creationPolicy` decides ownership.** `Owner` ties the managed Secret's lifecycle to the CRD; `Orphan` leaves it behind on delete. Default to `Owner` unless something else must survive.
- **Namespace-scoped installs: only the first installs CRDs.** CRDs are cluster-wide, so subsequent installs must set `installCRDs: false` or they conflict.
- **Never put a client secret in a manifest.** Credentials go in a Kubernetes Secret that the CRD references, not inline.
- **Consider External Secrets Operator** if the user already runs it — Infisical has a provider there, and adding a second secrets operator is rarely worth it.

© Infisical · MIT · Infisical/ai-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
kubernetes-skill LukasNiessen Помогает создавать и проверять манифесты Kubernetes без галлюцинаций. Находит ошибки в безопасности, сетевых политиках и ресурсах. CX Codex +1 1 500установок kubernetes Mindrally Скилл kubernetes для Claude Code помогает писать конфигурации Kubernetes и DevOps-инфраструктуры. Включается при работе с контейнерами, CI/CD и инфраструктурой как кодом. CX Codex +1 1 100установок agent-kubernetes-specialist Tony363 Скилл agent-kubernetes-specialist помогает проектировать и сопровождать Kubernetes-кластеры: от развёртывания рабочих нагрузок до настройки безопасности и производительности. CX Codex +1 101установок kubernetes-manifests официальный github Правило kubernetes-manifests задаёт стандарты оформления манифестов Kubernetes для GitHub Copilot. Помогает генерировать безопасные конфигурации с готовыми лимитами ресурсов, пробами и метками. CX Codex +1 ★ 41 430звёзд репо kubernetes-expert PCL Team Скилл kubernetes-expert помогает управлять кластерами Kubernetes, писать манифесты, дебажить поды через kubectl и собирать чарты Helm. Пригодится при настройке инфраструктуры. CX Codex +1 215установок kubernetes-service-manager Jeremy Longshore Скилл kubernetes-service-manager для Claude Code автоматически включается при задачах с Kubernetes: генерирует конфигурации и даёт пошаговые инструкции по настройке DevOps-окружения. CX Codex +1 1установок

Из того же набора17

Весь набор →
infisical-secret-rotation Скилл infisical-secret-rotation помогает настроить регулярную смену существующих паролей и ключей в Infisical с записью новых значений в хранилище. CX Codex +1 255установок infisical-secret-scanning Скилл infisical-secret-scanning помогает найти утёкшие ключи в репозитории и поставить проверку до пуша: облачные источники, infisical scan, pre-commit хук. CX Codex +1 254установок infisical-kms Скилл объясняет агенту, как шифровать, подписывать и считать HMAC ключами Infisical KMS, которые не покидают платформу. CX Codex +1 238установок infisical-pam Настраивает доступ людей и ИИ-агентов к серверам и базам через Infisical PAM без передачи паролей наружу. CX Codex +1 238установок infisical-gateway Помогает настроить Infisical Gateway и Relay, чтобы получать доступ к внутренним базам, каталогам и API без публичного адреса. CX Codex +1 238установок infisical-sso Скилл infisical-sso помогает подключить Infisical к системе управления идентичностью (Google, GitHub, Okta, Azure AD, SAML, OIDC или LDAP) — чтобы люди логинились через неё и автоматически создавались учётные записи. CX Codex +1 237установок infisical-pki Скилл infisical-pki помогает развернуть инфраструктуру PKI в Infisical: настроить центры сертификации, выпуск X.509, автопродление и синхронизацию с облачными хранилищами. CX Codex +1 235установок infisical-setup Скилл infisical-setup для Claude Code и Codex помогает подключить Infisical для передачи секретов в приложения, контейнеры и CI/CD. Агент выбирает инструкцию по задаче: настройка CLI, SDK, Docker, Kubernetes или машинной аутентификации. CX Codex +1 163установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой