Files
tf_provider/HISTORY/2026-09-02_full_docs_pipeline_analysis.md
T

2.1 KiB

Анализ полного pipeline документации и публикации

Дата: 2026-09-02

Проверен полный маршрут tf_provider:

Nubes API
  -> TOOLS/scripts/01_generate_yamls.sh
  -> generated/<stand>/resources_yaml/*.yaml
  -> TOOLS/scripts/02_generate_resources_and_docs_v2.sh
       -> generated/<stand>/go/*.go
       -> generated/<stand>/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/<namespace>/<name>/<version>/

Параллельно релиз провайдера идёт через 03_build_and_upload_provider.sh и build-provider.sh: временная копия provider собирается под linux/windows/darwin, подписывается GPG и загружается в nubes-terraform-registry/<host>/<namespace>/<name>/<version>/.

Ключевые реализации: TOOLS/yaml-generator/main.go, TOOLS/resource-generator/main.go, TOOLS/docs-generator/main.go, их internal/**, mkdocs.yml, профильные конфиги TOOLS/config/<stand>/*, .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