upgrading-chart — скилл для Claude Code: что делает и как установить
Скилл upgrading-chart обновляет зависимости Helm-чартов PostgreSQL и Vault в репозитории Chainloop, блокируя мажорные апгрейды.
Apache-2.0 1 установок ★ 615 обновлён 2026-10-29
npx skills add chainloop-dev/chainloop --skill upgrading-chart -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/upgrading-chart/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/upgrading-chart/
1Через Skills CLI (Vercel)
npx skills add chainloop-dev/chainloop --skill upgrading-chart -a codex2Вручную: положить файлы
.agents/skills/upgrading-chart/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add chainloop-dev/chainloop --skill upgrading-chart -a cursor2Вручную: положить файлы
.cursor/skills/upgrading-chart/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install chainloop-dev/chainloop .claude/skills/upgrading-chart2Вручную: положить файлы
.github/skills/upgrading-chart/SKILL.md1Через Skills CLI (Vercel)
npx skills add chainloop-dev/chainloop --skill upgrading-chart -a gemini-cli2Командой платформы
gemini skills install https://github.com/chainloop-dev/chainloop --path .claude/skills/upgrading-chartВручную: положить файлы
.devin/skills/upgrading-chart/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add chainloop-dev/chainloop --skill upgrading-chart -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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