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

upgrading-chart — скилл для Claude Code: что делает и как установить

Скилл upgrading-chart обновляет зависимости Helm-чартов PostgreSQL и Vault в репозитории Chainloop, блокируя мажорные апгрейды.

Apache-2.0 1 установок ★ 615 обновлён 2026-10-29

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

Что делает upgrading-chart

Скилл автоматизирует обновление чартов Bitnami для postgresql и vault в структуре проекта Chainloop. Он поддерживает два сценария: точечную смену версии контейнерного образа либо переход на новый минорный релиз чарта с копированием вендоризованных файлов и правкой манифестов.

Перед внесением изменений проверяются текущие version и appVersion в Chart.yaml. Переход между мажорными версиями запрещён. При изменении первой цифры версии процесс немедленно останавливается с требованием ручной проверки. Сервис Dex скиллом не поддерживается, так как управляется отдельно.

Проверка корректности включает helm lint и запуск контейнеров через Docker Compose в каталоге devel.

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

  • поднять минорную версию чарта PostgreSQL или Vault в Chainloop
  • обновить тег контейнерного образа Bitnami в файлах рабочего процесса CI/CD
  • проверить совместимость версий и заблокировать опасный мажорный апгрейд
  • провалидировать шаблоны чартов через helm lint перед коммитом

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

  • Обнови чарт postgresql до последней минорной версии
  • Обнови контейнерный образ для vault на целевой коммит из репозитория Bitnami

Как установить upgrading-chart

1Через Skills CLI (Vercel)

npx skills add chainloop-dev/chainloop --skill upgrading-chart -a claude-code

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

~/.claude/skills/upgrading-chart/SKILL.md

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

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

Вопросы об upgrading-chart

Как установить upgrading-chart в Claude Code?

Выполните команду npx skills add chainloop-dev/chainloop --skill upgrading-chart -a claude-code.

Что делает скилл upgrading-chart?

Он обновляет минорные версии зависимостей Helm (PostgreSQL и Vault) в проекте Chainloop, синхронизирует вендоризованные файлы и коммиты образов в GitHub Actions.

Можно ли выполнить мажорное обновление через этот скилл?

Нет, мажорные апгрейды запрещены логикой скилла. При обнаружении смены мажорной версии выполнение немедленно прекращается для ручного вмешательства.

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

SKILL.md · Apache-2.0
---
name: upgrading-chart
description: Upgrades Helm chart dependencies (PostgreSQL, Vault) in the Chainloop project, including vendorized charts, container images, and CI/CD workflows. Use when the user mentions upgrading Helm charts, Bitnami dependencies, PostgreSQL chart, or Vault chart. CRITICAL - Major version upgrades are FORBIDDEN and must be escalated.
---

# Upgrading Helm Chart Dependencies

This skill automates the upgrade process for Helm chart dependencies in the Chainloop project. Supports PostgreSQL and Vault (both Bitnami charts).

## CRITICAL RESTRICTIONS

**Version Upgrade Rules**:
- Patch upgrades (1.2.3 → 1.2.4): ALLOWED
- Minor upgrades (1.2.x → 1.3.x): ALLOWED
- Major upgrades (1.x.x → 2.x.x): **FORBIDDEN - STOP IMMEDIATELY**

**MANDATORY**: If major version upgrade is detected, STOP the process and inform the user that manual review is required.

## Upgrade Types

The skill supports two upgrade types:

1. **Specific Image Upgrade**: Update container image to specific version (chart unchanged)
2. **Chart Minor Version Upgrade**: Update chart to latest minor version (may include image updates)

**IMPORTANT**: Container images are ONLY updated as part of chart upgrades, never independently (unless Type 1).

## Process

### 1. Identify Upgrade Type

Ask the user which type of upgrade they want:
- Type 1: Specific image version upgrade
- Type 2: Latest minor chart version upgrade

Also ask which chart: `postgresql` or `vault`

### 2. Pre-Upgrade Validation

Check current state:
```bash
cat deployment/chainloop/charts/<chart-name>/Chart.yaml | grep "^version:"
cat deployment/chainloop/charts/<chart-name>/Chart.yaml | grep "^appVersion:"
```

### 3. Version Compatibility Check

For any version change, validate that major version remains the same:
```bash
CURRENT_MAJOR=$(echo "$CURRENT_VERSION" | cut -d. -f1)
TARGET_MAJOR=$(echo "$TARGET_VERSION" | cut -d. -f1)

if [ "$CURRENT_MAJOR" != "$TARGET_MAJOR" ]; then
    echo "FORBIDDEN: Major version upgrade detected"
    exit 1
fi
```

If major version upgrade detected, STOP and escalate.

## Type 1: Specific Image Upgrade

See [image-upgrade-process.md](image-upgrade-process.md) for detailed steps.

**Summary**:
1. Locate target container image in [Bitnami Containers](https://github.com/bitnami/containers)
2. Find commit with release message pattern
3. Extract APP_VERSION from Dockerfile
4. Update `deployment/charts/<chart-name>/Chart.yaml` appVersion
5. Update `.github/workflows/build_external_container_images.yaml` commit hash

## Type 2: Chart Minor Version Upgrade

See [chart-upgrade-process.md](chart-upgrade-process.md) for detailed steps.

**Summary**:
1. Locate target chart version in [Bitnami Charts](https://github.com/bitnami/charts) CHANGELOG.md
2. Validate minor version upgrade only
3. Download and extract target chart
4. Check for image changes (compare Chart.yaml)
5. If images changed, update container image references
6. Vendorize chart update (copy files)
7. Update dependencies in correct order
8. Update main chart dependency version
9. Clean up temporary files

## Verification

After any upgrade type, run:
```bash
# Lint charts
helm lint deployment/charts/<chart-name>
helm lint deployment/chainloop

# Template validation
helm template deployment/charts/<chart-name>
helm template deployment/chainloop

# Local testing
cd devel && docker compose up

# Verify image consistency
grep -r "appVersion\|image.*tag" deployment/charts/<chart-name>/
```

## Files Modified

See [files-modified.md](files-modified.md) for complete list.

## Troubleshooting

Common issues:
- **Image Version Mismatch**: Verify APP_VERSION matches Chart.yaml appVersion
- **Build Failures**: Check commit reference in build workflow
- **Dependency Conflicts**: Verify dependencies updated in correct order (vendorized first, then main chart)

## Rollback

If issues occur:
```bash
git checkout HEAD -- deployment/
find deployment/ -name "Chart.lock" -delete
cd deployment/chainloop && helm dependency build
cd ../../devel && docker compose down && docker compose up
```

## Important Notes

- Dex is self-managed and follows a separate process (not covered by this skill)
- Always use commit hashes for reproducibility
- Dependencies must be updated in correct order: vendorized chart first, then main chart
- Container images are found in Bitnami Containers repo, charts in Bitnami Charts repo

© chainloop-dev · Apache-2.0 · chainloop-dev/chainloop

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

Все скиллы по теме «DevOps и инфраструктура» →
helm-chart-scaffolding Seth Hobson Скилл helm-chart-scaffolding помогает создавать и поддерживать Helm-чарты для Kubernetes, настраивать шаблоны и готовить приложения к разным окружениям. CX Codex +1 11 964установок helm-chart-builder Alireza Rezvani Скилл helm-chart-builder генерирует структуру Helm-чартов, проверяет шаблоны на ошибки и проводит аудит безопасности манифестов Kubernetes. Пригодится при упаковке сервисов в чарты. CX Codex +1 581установок helm-chart-generator Jeremy Longshore Скилл helm-chart-generator помогает создавать Helm-конфигурации, разбирать задачи по шагам и проверять результат. Срабатывает по запросам о генераторе Helm chart. CX Codex +1 3установок Datris datris MCP-сервер Datris разворачивает шлюз управления данными для ИИ-агентов: сбор, проверка правил, сохранение в хранилища и аудит через 79 встроенных инструментов. CX Codex +1 ★ 14звёзд репо incident-runbook-templates Seth Hobson Скилл incident-runbook-templates помогает писать пошаговые инструкции для инцидентов: от обнаружения и первичной проверки до восстановления, отката и эскалации. CX Codex +1 10 900установок infisical-dynamic-secrets Infisical Скилл infisical-dynamic-secrets для Claude Code настраивает выпуск временных доступов в Infisical для 30 провайдеров: разовые учётные данные баз данных и облака для CI и отладки. CX Codex +1 852установок

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

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