What changed in gorizond-cluster 0.5.x​

• Switched Fleet deployment to HelmOp for headscale/k3s with automatic namespace creation.
• Hardened name handling for downstream resources to fit DNS-1123 (max 63 chars) and avoid invalid Rancher names.
• Added validation for gorizond cluster names to prevent invalid provisioning clusters.

Compatibility and cleanup notes​

• 0.5.x is backward compatible with clusters provisioned via 0.4.x.
• The headscale/k3s cleanup format changed: instead of a Fleet Bundle we now use HelmOp.
• When deleting older clusters, manually clean up the legacy Fleet Bundle. Ideally, replace old clusters fully to avoid mixed cleanup paths.

GitOps backbone: fleet-gitops​

We use fleet-gitops as a bootstrap repository for Fleet. It is a Helm chart that renders Fleet GitRepo and HelmOp resources from values.yaml, so one repo becomes the single source of truth for everything from the runtime cluster to core services and databases.

How it is structured today:

• fleet-local repos for platform control plane: fleet-gorizond-cluster (gorizond-cluster controller + charts), fleet-workspace-controller, fleet-cert-manager, yookassa-url-generator, docusaurus, jspolicy-for-autoscaler, and fleet-clusters.
• fleet-default repos for shared runtime workloads: fleet-cert-manager and fleet-gorizond-database.
• HelmOps for infra charts like jspolicy and longhorn.

Operational details we rely on:

• Fleet targets clusters by labels like <name>=enabled, plus optional cluster selectors/groups for extra scoping.
• paths allows pointing GitRepos directly at chart or policy subfolders.
• Drift correction is enabled in the generated Fleet resources.

How to upgrade​

• In your GitOps/Fleet bundle set chartVersion of gorizond-cluster-controller to 0.5.x (tag v0.5.x).
• If you manage infrastructure via fleet-gitops, update the controller bundle values there and let Fleet reconcile.
• Roll out via Fleet/Helm and wait for BundleDeployment to reach Ready and controller pods to restart.

How to verify​

• New headscale/k3s namespaces are created automatically by HelmOp for fresh clusters.
• Creating a cluster with an invalid name is rejected before provisioning.
• Controller logs show clean reconcile and Rancher resources use DNS-1123-safe names.

Что изменилось​

• v0.4.0 — финалайзер Billing блокирует удаление, пока баланс не перенесён; контроллер переводит остаток и консистентно восстанавливает связанные Cluster ресурсы. Это устраняет потерю средств при удалении биллинга.
• v0.4.1 — переработана reconcile-логика FleetBundle: обновляются только нужные объекты без перезаписи или удаления несвязанных ресурсов, чтобы Fleet UI/расширения не пропадали при чистке workspaces.
• v0.4.2 — вынесены версии K3S/Headscale chart в конфигурацию окружения; рекомендуем обновляться до последнего патча 0.4.2.

Полные детали: v0.4.0, v0.4.1, v0.4.2 и общий diff v0.3.0…v0.4.2.

Как обновиться​

• В GitOps/Fleet bundle обновите chartVersion gorizond-cluster-controller до 0.4.2 (или тег v0.4.2).
• Перекатите bundle через Fleet/Helm, дождитесь BundleDeployment в состоянии Ready и обновления подов контроллера.

Как проверить​

• При попытке удалить Billing с балансом ресурс остаётся в Terminating, пока контроллер не перенесёт остаток; баланс не пропадает.
• После удаления тестового Fleet workspace расширение Fleet в Rancher остаётся доступным, остальные workspaces можно продолжать создавать/удалять.
• В логах контроллера нет ошибок reconcile для Billing/FleetBundle; метрики/пробы остаются зелёными.

Добавили CRD и логику контроллера для биллинга: обработка событий и обновление статуса биллинга кластера. Входит:

1. Новые CRD для ресурсов Billing и BillingEvent.
2. Логика контроллера:
   • отслеживание статуса биллинга кластера;
   • генерация периодических событий биллинга;
   • обработка событий и обновление балансов.
3. Настройки для включения/отключения контроллера биллинга.
4. Обновление зависимостей и чистка.

Известные проблемы:

• Можно удалить billing и потерять весь баланс (и положительный, и отрицательный).
• Если удалить все workspaces Fleet, пользователь теряет Fleet UI и больше не может создавать/удалять workspaces.

Вышла первая альфа Gorizond. Доступно создание кластера и обновление версии; ошибок может быть много — это нормально :)