Installer Geocore OnPremise

Avant d’installer Geocore, assurez-vous de respecter les prérequis. Consultez les sections Prérequis logiciels et Recommandations matérielles. Vous devez également avoir accès à un cluster Kubernetes adapté à vos besoins.

Cluster Kubernetes

Cette documentation propose un guide d’installation k0s sur un nœud unique.

Dépôt Helm

Les charts Helm sont hébergés dans https://harbor.centiloc.com et accessibles via le protocole oci. Harbor utilise donc un protocole de registre pour accéder aux charts, comme le permet Helm.

Connectez-vous d’abord à Harbor avec Helm, puis installez directement les charts via l’accès oci :

echo "<password>" | helm registry login oci://harbor.centiloc.com/centiloc/geocore --username <username> --password-stdin
helm install -n my-geocore-release --create-namespace geocore oci://harbor.centiloc.com/centiloc/geocore -f myvalues.yaml

Vérifier le dépôt

Vous pouvez parcourir le dépôt Centiloc Harbor pour consulter les versions disponibles correspondant à la version du chart.

Installer le chart

La première étape de l’installation de Geocore avec Helm consiste à créer un fichier de configuration — par exemple myvalues.yaml — qui contient vos identifiants d’accès au dépôt Centiloc Harbor. Exemple :

global:
  imageCredentials:
    registry: harbor.centiloc.com
    email: <the email of your account>
    password: <your password>
    username: <your username>

Vous pouvez ensuite installer le chart avec le nom de release my-geocore-release, dans l’espace de noms geocore :

helm install -n my-geocore-release --create-namespace geocore oci://harbor.centiloc.com/centiloc/geocore -f myvalues.yaml

Après quelques minutes, vérifiez l’état de l’installation en listant les pods de l’espace de noms geocore :

kubectl get pods -n geocore

Désinstaller le chart

Pour désinstaller le déploiement my-geocore-release, exécutez la commande suivante :

helm delete my-geocore-release -n geocore

Personnaliser le déploiement du chart Helm

Vous pouvez adapter l’installation de Geocore à votre système. Nous recommandons de consulter attentivement la documentation du chart afin de vérifier que le déploiement de Geocore correspond à vos besoins et aux ressources disponibles.

Recommandations d’infrastructure

Selon votre environnement de déploiement et vos contraintes de ressources, vous devrez peut-être déployer des composants d’infrastructure. Le tableau ci-dessous récapitule les recommandations :

Paramètre	Installation sur une machine unique	Cluster à plusieurs nœuds
`global.logLevel`	`INFO`	`INFO`
`global.configuration.persistence`	✅	✅
`global.configuration.redundancy`	❌	✅
`global.configuration.streamTech`	`KAFKA`	`KAFKA`
`global.configuration.autoCreate`	✅	✅
`global.postgresql`	Utiliser PostgreSQL Geocore avec une sauvegarde externe	Utiliser une base de données gérée de manière externe
`global.kafka`	`replicaCount=1` si possible	✅
`global.emqx`	✅ avec `replicaCount=1`	✅
`global.redis`	aucune réplique	ajouter au moins une réplique

Pour une configuration complète sur un nœud unique, consultez l’installation k0s sur un nœud unique.

Planifier l’exposition des services

Avant d’installer le chart, définissez comment les clients accéderont à MQTT, NTP, l’API et Centui. MQTT et NTP sont des services NodePort directs. L’API et Centui doivent passer par le proxy gRPC-Web Contour Envoy, exposé par NodePort, LoadBalancer ou TLS.

Consultez Exposition des services pour le modèle complet, puis suivez le guide k0s ou le guide Ingress selon la configuration retenue.