Przejdź do treści
Biblioteka skilli
DevOps i chmura · Planowanie

generation-upgrade-acceptance

/generation-upgrade-acceptance

Planuje i weryfikuje parametryzowane migracje ze źródła do celu, od wydań, świeżego wdrożenia i uzgodnienia po testy odtwarzania i pętlę poprawek przed przełączeniem ruchu.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Planuje i weryfikuje parametryzowane migracje ze źródła do celu, od wydań, świeżego wdrożenia i uzgodnienia po testy odtwarzania i pętlę poprawek przed przełączeniem ruchu.

Oryginalny opis (EN)

Plan and verify parameterized source-to-target upgrades through manual or pipeline execution, immutable main-based releases, fresh deployment, reconciliation, restore drills, incident regression, and a fix-PR-release-retest loop. Use for generation replacement and pre-cutover acceptance; keep source traffic and writer ownership unchanged unless cutover is explicitly authorized.

Jak działa

  1. 参数契约
  2. 输入与执行归属
  3. 阶段 0–7:候选验收
  4. 运行和证据约束
  5. 修复、发布与重新验收闭环
  6. 切换及下一代
Sekcje z nagłówków SKILL.md, w oryginale · 100 linii, 316 słów
Podgląd SKILL.md
---
name: generation-upgrade-acceptance
description: Plan and verify parameterized source-to-target upgrades through manual or pipeline execution, immutable main-based releases, fresh deployment, reconciliation, restore drills, incident regression, and a fix-PR-release-retest loop. Use for generation replacement and pre-cutover acceptance; keep source traffic and writer ownership unchanged unless cutover is explicitly authorized.
---

# 可重复代际升级验收

证明固定构件可全新部署、安全重跑并恢复,而非只证明构建或健康检查成功。适用于 Vn→Vnext、蓝绿或主机替换;不绑定云平台、业务域名、数据库或 CD 产品。默认完成阶段 0–7 并提交待切换报告。

## 参数契约

云平台/基础设施类型、目标环境、源/目标代际、执行入口、配置执行器、固定声明和部署控制器均为输入,不以某个云、代际或工具链作为隐式默认:

```yaml
upgrade:
  provider: <选定云平台或基础设施类型>
  environment: <目标环境>
  source_generation: <当前已验收代际>
  target_generation: <待验收代际>
execution:
  mode: <manual或pipeline>
  entrypoint: <人工连接入口或流水线入口及固定版本>
  configuration_executor: <既有配置执行器及固定版本>
  desired_state_ref: <固定声明仓库commit或不可变tag>
  deployment_controller: <既有部署控制器及固定版本>
acceptance:
  stages: "0-7"
  cutover: manual_confirmation
```

将输入归一化为同一份已核实的环境、inventory 和构件清单,再交给执行 owner。必填输入缺失或相互矛盾时不启动相应变更;不静默选择生产平台、源或目标。不适用的配置执行器/控制器明确说明替代执行路径及证据,不引入工具来填字段。

manual 可映射 SSH → Playbook → 固定 GitOps → Doco-CD,pipeline 可映射已审查的流水线 → 固定执行器 → 固定声明 → 部署控制器。两种模式共享阶段、数据保护和证据门禁,不能因选择流水线而获得额外权限。

## 输入与执行归属

- 核实环境、provider、source_generation、target_generation、已验收源、目标 inventory、公共/版本域名、构件和观察预算。不要推定目标代际名称意味着已部署或源代际已验收。
- 阅读实际仓库 AGENTS.md,保护工作区修改、业务库、演练库和既有证据;不默认清库重来。以固定 commit 构建/执行工具,不从混有无关改动的工作区发布。
- GitOps 是执行前的目标声明;控制面负责选择、授权和证据放行;IaC 负责资源/DNS/权威 inventory;Playbooks 等配置执行器负责主机、部署、证书、迁移和恢复;应用迁移工具拥有业务合并语义。遵循现有 owner,不新增平行执行路径。
- 手动 Selfhost 可采用 **SSH → Playbook → 固定 GitOps → Doco-CD**:SSH 仅连接经核实目标,Playbook 消费固定声明,CD 收敛服务。其他已授权执行器可替换;不因本技能触发 CI 部署或新增网关。
- 修复进入所属配置源并重跑对应路径;主机热修和本地文档不构成可重复交付。PR、合并、发布、部署、切换分别以任务授权为准。

## 阶段 0–7:候选验收

| 阶段 | 放行条件 |
| --- | --- |
| 0 固定候选 | 核实源及参数;从各参与仓库已合并且必需检查通过的 main commit 创建唯一不可变 tag,验证构件确由该 tag/commit 产生;固定镜像 digest、声明 commit、schema/迁移校验和、目标及 run_id,列出必测 case。tag 成功不代表构件已存在或可部署。 |
| 1 前置检查 | 主机/连接身份、数据卷、网络端口、密钥引用、证书和域名正确;数据库按其实际协议/隧道检查,不套用 Web 健康检查。 |
| 2 全新部署 | 在独立候选目标或新业务库使用正式初始化路径部署,保留已有库;实际运行版本、CD 观察 commit、卷、权限及数据库连接符合声明。 |
| 3 单向对齐 | 对既有目标变更前完成可恢复备份;一致性预览后仅应用审核过的无冲突计划,保留目标独有事实;记录源快照边界。 |
| 4 恢复演练 | 备份含代表性业务数据的候选并隔离恢复,核对数据、schema、版本/dirty、权限及应用连接。空库恢复不能替代业务恢复证据。 |
| 5 真实回归 | 每个历史问题绑定真实脚本和可观察结果;执行入口、认证/回调、数据链路、迁移及相关客户端 case。 |
| 6 重复与恢复 | 相同候选重跑验证幂等、并发锁、重试、中断/目标重启恢复,无重复业务事实、配置漂移或不必要重启。恢复成功不替代全新部署成功。 |
| 7 待切换 | 完成明确观察预算,汇总证据、阻断及具体切换/恢复计划;必测项未通过则不可切换。此阶段不移交写入权,不登记目标为下一轮来源。 |

阶段 0 及数据操作前读取[运维验收与回归清单](../../operations-management/backup-disaster-recovery-and-data-migration/references/generation-upgrade-validation.md),使用其中的恢复、冲突及回归证据契约。无需重复载入无关技能。

## 运行和证据约束

- 候选阶段源继续服务;不修改、不重启或冻结源,不更改公共 DNS/流量。对源的迁移连接只读并不代表源业务已只读。源持续写入时不声称目标已零延迟追平。
- 目标允许受控迁移和隔离测试写入;生产消费者、真实扣退款、通知及外部副作用不得随测试开启。生产配置就绪与 Sandbox 功能验证分别记录。
- 每个 case 为 PASS/FAIL/BLOCKED/NOT_RUN;不适用项须有理由和依据。必测项缺测试条件即阻断,不用静态配置、行数相同、跳过证书验证或 readyz 代替业务验收。
- 证据绑定 run_id、固定候选和实际运行版本,包含命令/脚本版本、目标、时间、退出码、脱敏结果、恢复和指纹记录及关联问题。密钥运行时读取,不记录值或敏感身份。
- 修复生成新候选,重跑受影响阶段及依赖项;部署/恢复共享配置变化需重验全新部署、幂等和恢复。旧版本回执不能直接放行新版本。
- 观察预算基于业务/采集/调度周期和任务约定,记录起止和样本;时间或条件不足明确标未完成。

## 修复、发布与重新验收闭环

升级或迁移发现问题时,保留失败候选及证据,按以下闭环推进,不能以文档更新、主机热修或 PR 通过代替运行关闭:

```text
记录故障和复现证据
→ 在所属仓库修复,新增或修正真实回归 case
→ 提交 PR,通过必需检查和审查
→ 按任务授权合并 main,核实远端合并 commit
→ 从该 main commit 创建新的唯一不可变 tag,验证构件及来源
→ 更新消费者的固定声明,经其审查流程形成新的声明 commit
→ 重新部署候选,重跑受影响阶段及后续依赖验收
→ 依据运行证据关闭问题;未通过则进入下一轮
```

- 版本命名采用所属仓库批准的规则,不移动、覆盖、删除或复用旧 tag;失败重试分配新版本。生产资格仍受原有环境/ref 门禁约束,不把 main 直接当作生产部署 ref。
- 多仓修复分别走所属 PR,并按 producer → 已验证构件 → consumer 固定声明顺序推进。未改仓库可保留已验证的不可变版本,重新绑定本轮完整构件矩阵,不强制无意义重建。
- 每轮记录 attempt_id、上一失败轮次、问题、修复 PR、main 合并 SHA、新 tag/digest、声明 commit 和 case 回执。构件或参数变化需明确证据失效范围;新候选不能继承已失效结论。
- 若共享部署/恢复配置、schema/迁移或跨服务契约改变,重新执行其影响的全新部署、数据保护、恢复、回归和幂等验证;新候选重新完成相关稳定观察。
- 合并、tag 发布和目标部署依据任务已有授权执行,无需重复索取已给出的授权;本技能不自行授予这些权限。未授权/门禁阻断时记录精确边界,继续独立工作。修复循环不包含公共流量或写入权的自动切换。

## 切换及下一代

### 数据库身份与正式运行配置

- 区分审计读取、迁移执行、业务运行三类身份。本项目的 `readonly_release` 仅用于快照/备份读取、迁移源读取及审核,不是业务 DB 用户;不得接入 Accounts/Billing,也不得为修复业务写入而给它 DML、DDL、角色成员或绕过行级权限。迁移目标写入由单独的受控执行身份完成。
- 业务角色按实际 SQL 授予必要的表读写、序列使用及 schema 使用权限;不以超级用户、对象所有权、建库/建角色或清表权限修复普通业务写入。现有 RLS 契约须单独核实,不能用扩大权限掩盖策略错误。
- 候选只读或仅写会话的角色是隔离测试配置,不能直接作为正式运行配置。本项目 `generation_auth` 仅写会话、`generation_app` 只读时,登录成功不证明注册、账单或流量入账可用。
- Playbook 显式区分候选与正式运行模式;准备好正式配置后,在已授权切换中核实旧写入隔离、事务排空及目标备份,再提升目标业务角色和切换应用连接。共同核对声明、环境文件、进程实际连接身份、数据库有效权限、事务只读设置、后台写入及入口方法规则。暂停/恢复容器本身不完成角色提升。
- 角色提升不轮换认证凭据、不修改业务数据、不改变审计身份;重跑必须幂等。已提升目标不得被候选/恢复默认配置静默改回只读。若正式运行所需 SMTP、OAuth/Webhook 或支付配置仍是候选占位值,按实际功能标阻断,不以补授权宣称全部修复。
- 候选阶段用隔离身份和事务回滚验证业务写入、拒绝越权及恢复后的权限;单写入者交接后验证真实注册/会话和流量落库。业务写入成功及审计身份写入被拒绝都要有运行回执。

阶段 7 给出具体计划:隔离全部源写入者 → 排空事务 → 最终追齐及校验 → 捕获一致性/身份基线 → 确认源持续禁写 → 移交目标写入权与流量 → 切换后真实业务验收。

切换只在任务已有明确授权或人类审阅具体计划后确认时执行;默认停在 0–7。DNS 缓存或已有连接不能保证单写入者,所有 API、后台任务、Webhook、消费者及直连脚本都须纳入。无法隔离旧写入则停止。

目标接受新写入后,旧代际已经落后;不以仅切回 DNS 自动恢复旧库写入,不执行破坏性数据库降级。切换后观察及业务验收完成才将目标登记为下一轮来源。完整回退和遗漏数据修复见运维参考。
Pliki w paczce (2)
  • SKILL.md 11 KB
  • agents/openai.yaml 1 KB

Wersje

W bazie nie ma innych skilli o nazwie generation-upgrade-acceptance.

Migawka bazy z 13.11.2026 · wersja paczki 86541745251a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100guidewire-migration-and-upgrade
    Przenosi wdrożenie Guidewire na nową platformę lub wydanie bez przerywania działających polis i szkód: przejście z on-prem do chmury, aktualizacja wersji, próby generalne i plan wycofania.
  • 100backup-restore-upgrade
    Wykonuje kopie przed zmianą, sprawdza możliwość odtworzenia i aktualizuje urządzenia RouterOS z planem wycofania.
  • 100migration-engineering
    Planuje i przeprowadza bezpieczne migracje między systemami, w tym wydzielanie usług z monolitów, z oknami zgodności, dual-running, uzgadnianiem, przełączeniem i wycofaniem starego rozwiązania.
  • 100cutover-planning
    Planuje przełączenie ruchu produkcyjnego metodą Blue-Green lub Canary na ALB i Route53, definiuje wyzwalacze wycofania, synchronizację danych przez DMS i listę kontrolną po przełączeniu.
  • 90aws-migration-cutover-architect
    Planuje, przegląda i ogranicza ryzyko migracji AWS i przełączeń: odkrywanie, mapa zależności, fale, Application Migration Service, testy akceptacyjne, rollback, DNS i walidacja po przełączeniu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.