add: documentation

2026-06-30 15:45:24 +04:00
parent 540c1f7293
commit ca276d200f
1055 changed files with 47294 additions and 0 deletions
@@ -0,0 +1,79 @@
+# Session report 2026-02-13
+
+## What was done
+- Implemented input param sync from state_params to avoid drift (e.g., git_path).
+- Added parsers for state_params string values (bool/int64/string).
+- Localized diagnostics to Russian in core paths and generated resources.
+- Bumped provider version to 2.0.6.
+- Regenerated resources with tools/gen and built the provider.
+
+## Files touched
+- universal_rebuild/internal/resources_core/helpers.go
+- universal_rebuild/internal/resources_core/outputs.go
+- universal_rebuild/internal/resources_core/resource_diagnostics.go
+- universal_rebuild/tools/gen/generate_resources.go
+- universal_rebuild/internal/resources_gen/*.go (regenerated)
+- universal_rebuild/main.go
+- docs/30_registry/guides/getting-started.md
+
+## Commands
+- go run ./tools/gen
+- go build ./...
+
+## Follow-up
+- Saved new access/refresh tokens to ${ROOT_DIR}/19-28-48.token and .refresh.
+- Updated test_dummy api_token and provider version to 2.0.6.
+- Published provider 2.0.6 to registry S3 via devops/03_build_and_upload_provider.sh.
+
+## Terraform test_dummy
+- terraform init -upgrade pulled terra.k8c.ru/nubes/nubes v2.0.6.
+- terraform plan: 2 changes (nubes_postgres.db2, nubes_lucee.app1) with Vault TLS handshake timeouts.
+- terraform apply failed: API error 408 during modify (failed to set param 267).
+
+## RefSvcId display name sync
+- Added reverse mapping UUID -> display_name for refSvcId params to avoid drift.
+- Regenerated resources and rebuilt provider.
+
+## Registry publish retry
+- devops/03_build_and_upload_provider.sh 2.0.6 failed: mc alias set timeout to s3.msk-1.ngcloud.ru.
+- Retry succeeded: provider 2.0.6 uploaded to registry S3.
+
+## UUID->display_name lookup
+- Switched refSvcId reverse mapping to direct /instances/<uid> lookup with list fallback.
+- Regenerated resources and rebuilt provider.
+- Publish attempt failed: DNS timeout to s3.msk-1.ngcloud.ru.
+- Publish retry succeeded: provider 2.0.6 uploaded to registry S3.
+
+## Как правильно запускать CURL modify (Lucee)
+- Шаг 1: POST /instanceOperations (operation=modify, svcOperationId=55, instanceUid) -> получить instanceOperationUid.
+- Шаг 2: GET /instanceOperations/{opUid}?fields=cfsParams -> получить список параметров, включая instanceOperationCfsParamUid.
+- Шаг 3: Для каждого параметра отправить paramValue как строку.
+	- Если instanceOperationCfsParamUid есть -> PUT /instanceOperationCfsParams (UID в теле JSON).
+	- Если UID нет -> POST /instanceOperationCfsParams (instanceOperationUid + svcOperationCfsParamId).
+- Шаг 4: GET /instanceOperations/{opUid}/validate-cfs.
+- Шаг 5: POST /instanceOperations/{opUid}/run с payload {}.
+- Шаг 6: Polling GET /instanceOperations/{opUid} до dtFinish.
+
+Важно:
+- Все paramValue отправлять как строки (включая числа и JSON), чтобы не ломать checkParam.
+- Нельзя пропускать required и дефолтные параметры.
+- При пустом healthPath отправлять пустую строку.
+
+## Lucee + Gitea: итоги и гипотезы
+- Успешный деплой на своём Gitea: git_path = https://gitea-naeel.giteak8s.services.ngcloud.ru/naeel/gitftomhub-mirror.git (modify via curl прошёл, isSuccessful=true).
+- Неуспешный деплой на чужом Gitea: git_path = https://gitea.services.ngcloud.ru/smishchuk/testlucee.git (ошибка: pod(ы) не работают).
+- UI деплой для smishchuk/testlucee успешно завершался (HAR: lucee.har).
+
+### Проверка репозиториев
+- Изначально naeel/gitftomhub был пустой -> деплой падал (нет файлов).
+- Создано зеркало GitHub репо xahys/testlucee -> naeel/gitftomhub-mirror (файлы появились, деплой прошёл).
+- Попытка зеркала smishchuk/testlucee через API migrate -> стабильный 504 (nginx), повтор не помог.
+
+### Обходной путь
+- Создан репозиторий naeel/testlucee-mirror и выполнен локальный clone --mirror + push --mirror.
+- После этого деплой на naeel/testlucee-mirror проходит.
+
+### Вывод
+- Проблема не в коде репозитория, а в доступе/доверии к хосту gitea.services.ngcloud.ru из инфраструктуры деплоя.
+- Возможные причины: TLS/CA недоверен, egress/ACL на хост, различие маршрутов между UI и API-оркестратором.
+- Суффикс .git не является корнем проблемы; ключевое — наличие контента и доступность хоста.