# debug-openshell-cluster

Скилл находит причины сбоев шлюза OpenShell, проблем с TLS и ошибок запуска песочниц в контейнерах и Kubernetes.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 474 установки · ★ 19954
- Автор: NVIDIA
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NVIDIA/OpenShell/tree/HEAD/skills/debug-openshell-cluster/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/debug-openshell-cluster

## Что делает

Скилл анализирует состояние развёртывания шлюза OpenShell, когда тот не отвечает на запросы или зависает при создании песочниц. Проверка начинается с утилиты `openshell`: агент считывает список шлюзов через `openshell gateway list --output json`, проверяет статус и инспектирует активный адрес. Если прямое подключение падает, скилл тестирует адрес напрямую через флаг `--gateway-endpoint`.

Дальше диагностика переходит на уровень вычислительного драйвера: проверяются сокеты Docker или Podman, а также поды через `kubectl`. При автоопределении шлюз опрашивает драйверы по цепочке: сначала Kubernetes, затем Podman, потом Docker. Драйвер виртуальных машин требует явного включения. На Windows скилл сразу столкнётся с ограничением: встроенные драйверы там оформлены как заглушки-отказы и работать не будут.

Для работы требуется установленная утилита `openshell`, доступный сокет рантайма, а для Kubernetes — `kubectl` и Helm версии 3 или новее. Особое внимание нужно уделить Snap-пакету. Запуск пользовательского шлюза под двумя сессиями вызовет сбой из-за конфликта адреса `127.0.0.1:17670`.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/OpenShell --skill debug-openshell-cluster -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/OpenShell --skill debug-openshell-cluster -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/OpenShell --skill debug-openshell-cluster -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NVIDIA/OpenShell debug-openshell-cluster
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/OpenShell --skill debug-openshell-cluster -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/NVIDIA/OpenShell --path skills/debug-openshell-cluster
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add NVIDIA/OpenShell --skill debug-openshell-cluster -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NVIDIA/OpenShell/tree/HEAD/skills/debug-openshell-cluster/SKILL.md

## Когда брать
- найти причину недоступности шлюза OpenShell
- проверить ошибки TLS и сертификатов mTLS
- устранить сбои драйверов Docker, Podman или Kubernetes
- разобрать конфликт портов при установке через Snap

## Примеры запросов агенту
- Проверь, почему шлюз OpenShell не отвечает на запросы CLI.
- Диагностируй ошибку создания песочниц в кластере Kubernetes.
- Разбери сбой подключения к openshell gateway через docker driver.

## Похожие
- [gitops-cluster-debug](https://affpapa.org/nevibecode/skills/gitops-cluster-debug.md) — скилл · 1100 установок
- [tao-launch-workflow](https://affpapa.org/nevibecode/skills/tao-launch-workflow.md) — скилл · 1600 установок
- [github-actions-templates](https://affpapa.org/nevibecode/skills/github-actions-templates.md) — скилл · 17420 установок
- [gitlab-ci-patterns](https://affpapa.org/nevibecode/skills/gitlab-ci-patterns.md) — скилл · 13112 установок
- [devops-engineer](https://affpapa.org/nevibecode/skills/devops-engineer.md) — скилл · 11200 установок
- [gke-app-onboarding](https://affpapa.org/nevibecode/skills/gke-app-onboarding.md) — скилл · 6489 установок

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

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

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