docs/infrastructure/test-contour/k3s-test-reference/index.md

Справочник файлов k3s-test

Полный перечень файлов песочницы k3s-test/ с кратким назначением каждого. Для понимания как пользоваться контуром начните с обзора test-контура и статьи «что сделано». Этот справочник отвечает на вопрос «что лежит в каком файле».

Документировано файлов: ~1086 (без vendor/node_modules/dist/.tmp-chart).

Дерево каталогов

k3s-test/
├── README.md, plan-sentry-redmine.md, presentation-practical-guide.md
├── .generated/          # platform-credentials.env, CI SSH keys
├── .images/             # *.tar для import-images-to-vm.sh
├── docs/                  # указатели на VitePress
├── scripts/               # bootstrap, deploy, CI, smoke
├── sova-adminpanel/       # React admin + Gitea CI
├── sova-backend/          # Symfony API + Gitea CI
├── sova-cabinet/          # Symfony ЛК + Gitea CI
├── sova-deploy/           # Helm + ArgoCD GitOps
├── sova-docs/             # VitePress documentation site
├── sova-mocks/            # WireMock + Mailpit
├── sova-platform/         # Terraform k3s bootstrap
└── sova-redmine/          # custom Redmine image (optional)

Разделы справочника

Раздел	Файлов	Описание
Скрипты k3s-test	38	scripts/
sova-deploy: Helm и ArgoCD	56	sova-deploy/
sova-platform: Terraform	10	sova-platform/
sova-mocks: WireMock и Mailpit	19	sova-mocks/
sova-redmine: custom image	2	sova-redmine/
docs/: указатели	2	docs/
sova-backend: Symfony API	277	sova-backend/
sova-adminpanel: React admin	129	sova-adminpanel/
sova-cabinet: Symfony ЛК	428	sova-cabinet/
sova-docs: сайт документации	114	sova-docs/
Корень и артеfacts	11	README, .generated/, .images/

Типовые сценарии (какие скрипты вызывать)

Сценарий	Команды
Первый запуск (Multipass)	bootstrap-multipass.sh → build-images.sh → import-images-to-vm.sh → deploy-platform.sh → deploy-test-stack.sh
Первый запуск (k3d на Mac)	sync-from-monorepo.sh → build-images.sh → k3d-bootstrap.sh
Старт/стоп VM	multipass start sova-test / multipass stop sova-test → source scripts/use-kubeconfig.sh
Релиз приложения	scripts/release-tag.sh {backend|adminpanel|cabinet|docs} {tag} test
Обновить БД test	prepare-db-init.sh → удалить job db-init → redeploy data-test
Redmine	deploy-redmine.sh --bootstrap
Скриншоты для доков	capture-platform-screenshots/run.sh

Связанная документация

• Git-flow — ветки prod/test/stage
• Система тегов — {component}-v{semver}-{env}
• ArgoCD приложения — sova-root, data-test
• Gitea CI — pipeline и registry
• Redmine — issue tracker