IT
EUR
Edizione gratuitaGratuito Installa

Kubernetes

Deploy the data plane with the Helm chart (or plain manifests, or as a sidecar), with a control plane in the cluster if you want one: install, check, upgrade and uninstall.

All ways to install

Quale versione installi

La versione pubblica è una versione di sviluppo, chiamata 0.3.0-dev. Il suo nome non cambia: ogni pubblicazione sostituisce la precedente e un identificativo di build distingue due build. Non esiste ancora una versione stabile: sarà pubblicata solo quando ogni sistema e ogni pacchetto saranno stati testati end to end. I comandi di questa pagina installano quindi dal canale dev. Una versione di sviluppo può contenere difetti: provala su un sito di prova prima di farci affidamento.

At a glance

  • Kubernetes 1.25 or later. The data plane is deployed as a Deployment or a DaemonSet, stateless; the policy comes from Helm values (a hot-reloaded ConfigMap) or from a control plane.
  • Pods run unprivileged (user 65532), with a read-only root filesystem, all capabilities dropped and the RuntimeDefault seccomp profile.
  • The chart, the manifests and the sidecar example are in the deploy folder of your ToutWAF distribution, not in the public repository.
  • The in-cluster control plane is a single instance with SQLite (PostgreSQL is not implemented).

The commands, step by step

Installa con Helm

Distribuisce il data plane come ingress, con un control plane nel cluster se lo desideri. Il chart e i manifest (modalità sidecar inclusa) sono nella cartella deploy della tua distribuzione ToutWAF, non nel repository pubblico, che contiene solo binari e installer. L'operatore si limita a CRD e a uno scheletro.

bash
helm install toutwaf ./deploy/helm/toutwaf --namespace toutwaf --create-namespace -f my-values.yaml

Verifica i pod e apri la console

bash
kubectl -n toutwaf get pods
kubectl -n toutwaf port-forward svc/toutwaf-cp 9443:9443

Aggiornare (container)

Fai prima un backup. Il pulsante di aggiornamento della console non può funzionare in un container: sostituisci i binari nella cartella bin (o l'immagine, quando ne sarà pubblicata una) e ricostruisci; i volumi, quindi i tuoi dati, vengono conservati.

bash
helm upgrade toutwaf ./deploy/helm/toutwaf --namespace toutwaf -f my-values.yaml

Disinstalla

Il primo blocco rimuove i servizi, i binari e le regole del firewall aggiunte da ToutWAF, e conserva i tuoi dati. Il secondo elimina anche configurazione, dati e log.

bash
helm uninstall toutwaf --namespace toutwaf
purge
kubectl delete namespace toutwaf

What is not verified

We prefer to say it plainly.

  • The Kubernetes operator is a skeleton: the resource definitions (CRDs), the RBAC and a translation library exist, but no controller binary or operator image is published. Use the Helm “standalone” policy source or a control plane.
  • The resource sizes in the sidecar example are example values, not a sizing guarantee.

Other ways to install

Learn more in the documentation