PLANKA Flow Docs

Migration и init сценарии

Migration и init сценарии

Когда нужен initializer, а когда migration kit

СценарийПравильный entrypoint
Новый repo без существующего flow-контураflow-init.sh
Перенос уже работающего consumer-projectcreate_migration_kit -> do_migration.sh
Частично materialized .flow в target repobootstrap_repo/repair path, затем flow_configurator

Migration path

  1. В source project собрать migration kit:
.flow/shared/scripts/run.sh create_migration_kit --project acme --target-repo <HOME>/sites/acme-app
  1. В target repo запустить launcher:
.flow/migration/do_migration.sh
  1. После materialize-пути завершить конфигурацию:
.flow/shared/scripts/run.sh flow_configurator questionnaire --profile acme
.flow/shared/scripts/run.sh onboarding_audit --profile acme
.flow/shared/scripts/run.sh profile_init orchestrate --profile acme

Что migration kit переносит

  • flow.env и flow.sample.env;
  • repo overlay .github/*, если он включен в payload;
  • manifest required files/secrets;
  • migration metadata и launcher для target repo.

Что migration kit намеренно не решает сам

  • бизнес-выбор нового GITHUB_REPO и PROJECT_*, если binding не закреплен явно;
  • подготовку GitHub Actions secrets в новом repo;
  • запуск smoke за пользователя;
  • выравнивание legacy-docs стиля вне того, что нужно для канонической web-навигации.

Repo sources

  • .flow/shared/docs/flow-portability-runbook.md
  • .flow/shared/docs/flow-toolkit-packaging.md
  • docs/issue-378-flow-bootstrap.md
  • docs/issue-388-flow-initializer.md
  • .flow/shared/scripts/README.md