# aks-known-issues

Находит решения сбоев Azure Kubernetes Service по точным сигнатурам ошибок. Срабатывает при конкретных отказах виртуальных машин, дисков и сетевых расширений.

- скилл · `type=skill` · Claude Code, GitHub Copilot · ★ 3149
- Автор: Microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/aks-known-issues

## Что делает

Скилл ищет задокументированные исправления для сбоев AKS в каталоге ошибок Microsoft. Он распознаёт чёткие сигнатуры: отказы `VMCannotFitEphemeralOSDisk`, несовместимость `NodePoolMcVersionIncompatible`, нехватку мощностей `ZonalAllocationFailed`, а также проблемы с расширениями vmssCSE вроде `VMExtensionError_OutboundConnFail` или `VMExtensionError_K8SAPIServerConnFail`.

Для запуска скилла требуется полная сигнатура со всеми квалификаторами, включая размер инстанса, регион или зону. Подстроки и голые числовые коды скилл отбрасывает. Ошибки превышения лимитов квот здесь не обрабатываются: их положено направлять в `aks-troubleshooting`. Для работы серверы MCP не требуются, агент применяет интерфейс командной строки Azure или доступные инструменты чтения.

Перед любым изменением ресурсов скилл обязан запросить явное одобрение пользователя. Без точного совпадения сигнатуры из каталога диагностика не запустится.

## Требования
- Работает с: Azure

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add microsoft/skills
```
В чате агента (не в терминале):
```text
/plugin install aks-skills@skills
```
Команда ставит плагин aks-skills целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/skills --skill aks-known-issues -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/aks-known-issues/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/aks-known-issues/

### Codex

**Вручную: положить файлы**
- Файл: `.agents/skills/aks-known-issues/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/aks-known-issues/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/skills aks-known-issues
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/aks-known-issues/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/microsoft/skills --path .github/plugins/aks-skills/skills/aks-known-issues
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/aks-known-issues/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/skills/tree/HEAD/.github/plugins/aks-skills/skills/aks-known-issues/SKILL.md

## Когда брать
- подобрать решение при ошибке VMCannotFitEphemeralOSDisk во время создания пула узлов
- устранить сбой подключения к API-серверу при ошибках VMExtensionError_K8SAPIServerConnFail
- найти официальные шаги исправления для ZonalAllocationFailed с нехваткой ёмкости зоны
- разобрать отказ развёртывания OverconstrainedAllocationRequest с заданными ограничениями

## Примеры запросов агенту
- При создании пула узлов в AKS возникла ошибка `VMCannotFitEphemeralOSDisk`. Как её исправить?
- Кластер AKS вернул ошибку `VMExtensionError_K8SAPIServerConnFail` при инициализации узлов vmssCSE. Найди причину и шаги решения.
- Развёртывание упало с `ZonalAllocationFailed` из-за недостатка ресурсов в зоне 1. Что рекомендует документация Microsoft?

## Похожие
- [caveman-manage](https://affpapa.org/nevibecode/skills/caveman-manage.md) — скилл · 104200 установок
- [workers-best-practices](https://affpapa.org/nevibecode/skills/cloudflare-workers-best-practices.md) — скилл · 126100 установок
- [cloudflare-email-service](https://affpapa.org/nevibecode/skills/cloudflare-email-service.md) — скилл · 102300 установок
- [firebase-basics](https://affpapa.org/nevibecode/skills/firebase-basics.md) — скилл · 14100 установок
- [cloudflare-one](https://affpapa.org/nevibecode/skills/cloudflare-one.md) — скилл · 93100 установок
- [cloudflare-one-migrations](https://affpapa.org/nevibecode/skills/cloudflare-one-migrations.md) — скилл · 89500 установок

Из того же набора: [microsoft/skills](https://affpapa.org/nevibecode/by/microsoft/skills.md) — 242 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md