diff --git a/HISTORY/2026-09-02_full_docs_pipeline_analysis.md b/HISTORY/2026-09-02_full_docs_pipeline_analysis.md new file mode 100644 index 0000000..886f4dd --- /dev/null +++ b/HISTORY/2026-09-02_full_docs_pipeline_analysis.md @@ -0,0 +1,29 @@ +# Анализ полного pipeline документации и публикации + +Дата: 2026-09-02 + +Проверен полный маршрут `tf_provider`: + +```text +Nubes API + -> TOOLS/scripts/01_generate_yamls.sh + -> generated//resources_yaml/*.yaml + -> TOOLS/scripts/02_generate_resources_and_docs_v2.sh + -> generated//go/*.go + -> generated//docs/*.md + _nav_fragment.yml + -> TOOLS/scripts/05_generate_docs_llm.py (опционально) + -> TOOLS/scripts/04_build_and_publish_docs.sh + -> .mkdocs.tmp.yml + -> site/ + -> S3 terraform-registry/docs//// +``` + +Параллельно релиз провайдера идёт через `03_build_and_upload_provider.sh` и `build-provider.sh`: временная копия provider собирается под linux/windows/darwin, подписывается GPG и загружается в `nubes-terraform-registry/////`. + +Ключевые реализации: `TOOLS/yaml-generator/main.go`, `TOOLS/resource-generator/main.go`, `TOOLS/docs-generator/main.go`, их `internal/**`, `mkdocs.yml`, профильные конфиги `TOOLS/config//*`, `.github/workflows/publish-docs.yml` и серверные файлы `/home/naeel/TF/tf_registry/server/{main.go,handlers.go,router_versions.go,proxy.go}`. + +Обнаружен фактический разрыв: `TOOLS/scripts/04_build_and_publish_docs.sh` и CI вызывают `./scripts/publish-docs.sh`, но такого файла в `tf_provider/scripts/` нет. Справочная рабочая копия находится в `DOCS_PIPELINE/publish-docs.sh`. Поэтому генерация `site/` возможна, а штатная финальная загрузка из текущего репозитория завершается ошибкой отсутствующего файла. + +Подробный пользовательский отчёт сохранён в: + +`/home/naeel/TF/TMP/tf_provider_full_docs_pipeline_2026-09-02.md`