Installazione

L'operatore offre tre metodi di installazione. Scegli quello più adatto al tuo modello di delivery:

Metodo	Ideale per
Helm chart	La maggior parte dei cluster; installazioni GitOps e basate su template
kustomize (config/)	Semplice kubectl apply -k, senza Helm
Bundle OLM	OpenShift / OperatorHub.io e Operator Lifecycle Manager

Tutti e tre installano la stessa cosa: il Deployment dell'operatore, i suoi CRD, l'RBAC e (facoltativamente) i webhook. L'operatore installa poi su richiesta gli operatori di capacità upstream a partire dai chart incorporati nel suo binario.

Cluster-admin per l'installazione

L'operatore gestisce CRD, RBAC di cluster e webhook in più namespace, quindi l'installazione richiede cluster-admin. L'uso quotidiano delle custom resource no.

Opzione 1 — Helm

helm install navique-ai-core-operator \
  oci://ghcr.io/scigility/charts/navique-ai-core-operator \
  --namespace navique-system --create-namespace

Valori utili (consulta il values.yaml del chart per l'elenco completo):

image:
  repository: ghcr.io/scigility/navique-ai-core-operator
  tag: ""               # defaults to the chart appVersion
# Restrict which namespaces the operator watches (empty = all namespaces).
watchNamespaces: []
resources:
  limits:   { memory: 1Gi }
  requests: { cpu: 100m, memory: 512Mi }
# Leader election is on by default for HA-safe single-active reconciliation.
leaderElection: true

Opzione 2 — kustomize

Da un checkout del repository dell'operatore:

# Install the CRDs.
make install

# Deploy the manager (set IMG to your image).
make deploy IMG=ghcr.io/scigility/navique-ai-core-operator:latest

Oppure applica direttamente l'overlay kustomize:

kubectl apply -k config/default

Kustomization dei CRD

Quando compili dai sorgenti, ogni CRD deve essere elencato in config/crd/kustomization.yaml, altrimenti un'installazione kustomize lo ometterà silenziosamente. Gli overlay forniti li includono già tutti.

Opzione 3 — OLM / OperatorHub

Su un cluster con Operator Lifecycle Manager installato, compila e distribuisci il bundle dai sorgenti:

make bundle IMG=ghcr.io/scigility/navique-ai-core-operator:latest
make bundle-build bundle-push BUNDLE_IMG=ghcr.io/scigility/navique-ai-core-operator-bundle:latest
operator-sdk run bundle ghcr.io/scigility/navique-ai-core-operator-bundle:latest \
  --namespace navique-system

Su OpenShift l'operatore compare anche in OperatorHub una volta pubblicata la catalog source.

Verifica l'installazione

# The manager should be Running.
kubectl -n navique-system get deploy navique-ai-core-operator

# All CRDs should be present.
kubectl get crds | grep core.navique.com

# The management console is deployed by default (no CR required).
kubectl -n navique-system get deploy,svc -l app.kubernetes.io/component=management-plane

Il Deployment dell'operatore dovrebbe risultare disponibile, i CRD *.core.navique.com in stato established e la console del management plane in esecuzione. La console viene distribuita di default — la risorsa ManagementPlane si limita a configurarla (host, ingress, SSO).

Cosa viene installato in seguito, su richiesta

L'operatore non installa in anticipo tutti gli operatori upstream. Gli operatori di capacità (CloudNativePG, External Secrets, cert-manager, …) vengono installati in modo lazy — solo quando una custom resource ne ha bisogno — e ciascuno è una release Helm autonoma che tiene conto della provenienza. Consulta Chart inclusi e Provenienza e ciclo di vita.

Prossimo passo

Metti in piedi una piattaforma con l'Avvio rapido, oppure regola il manager tramite la pagina Configurazione.