# upgrading-mwaa-environments

Проведёт окружение MWAA на новую версию Airflow: подберёт путь обновления и один из трёх сценариев по тому, нужно ли сохранить историю запусков.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 811 установок · ★ 3282
- Автор: aws
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/aws/agent-toolkit-for-aws/tree/HEAD/plugins/aws-data-analytics/skills/upgrading-mwaa-environments/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/upgrading-mwaa-environments

## Что делает

Скилл из набора aws/agent-toolkit-for-aws берёт текущую версию Airflow и целевую, а затем строит упорядоченный список переходов. Промежуточная версия 2.11.x и шаг смены линейки Python добавляются, только если без них путь не проходит. Дальше агент выбирает стратегию по двум вопросам: важна ли история прогонов и остаётся ли то же окружение со своим URL и ARN.

Вариантов три. Новое окружение с переносом нагрузки — когда история не нужна. Репетиция на тестовой копии с последующим обновлением на месте. И прямой апгрейд на месте, который в описании помечен как нерекомендуемый. Для перехода на 3.x подключаются сканирование Ruff и разбор логов с предупреждениями об устаревших вызовах, а также проверка в Docker, выкладка партиями и переключение трафика. План сохраняется, поэтому работу можно продолжить в следующей сессии.

Скилл рассчитан на provisioned-окружения с Python-DAG-ами; для MWAA Serverless он не подходит, как и для написания новых DAG-ов. Каждая смена версии через `aws mwaa update-environment` требует отдельного подтверждения, а `aws mwaa create-environment` не запустится до того, как вы согласуете план. Для IAM нужны права на создание и обновление окружения с доступом к конкретным ARN, без `*FullAccess`.

Опционально команды можно гонять через AWS MCP-сервер, тогда появляется изолированное исполнение и аудит. С обычным AWS CLI тоже работает.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill upgrading-mwaa-environments -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill upgrading-mwaa-environments -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill upgrading-mwaa-environments -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aws/agent-toolkit-for-aws upgrading-mwaa-environments
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill upgrading-mwaa-environments -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aws/agent-toolkit-for-aws --path plugins/aws-data-analytics/skills/upgrading-mwaa-environments
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aws/agent-toolkit-for-aws --skill upgrading-mwaa-environments -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aws/agent-toolkit-for-aws/tree/HEAD/plugins/aws-data-analytics/skills/upgrading-mwaa-environments/SKILL.md

## Когда брать
- проложить путь обновления Airflow с промежуточной версией 2.11.x
- решить, сохранять ли историю запусков или поднять новое окружение
- отрепетировать апгрейд на тестовой копии до переключения
- найти в DAG-ах вызовы, устаревшие для Airflow 3
- продолжить прерванный апгрейд с сохранённого плана

## Примеры запросов агенту
- Обнови окружение MWAA до последней поддерживаемой версии Airflow 3, историю прогонов сохранять не нужно
- Составь план перехода с Airflow 2 на 3 и сначала прогони проверку на тестовой копии
- Проверь DAG-и на устаревшие вызовы перед сменой версии

## Похожие
- [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 установок

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

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