Pour déployer ArcGIS Enterprise on Kubernetes, vous pouvez exécutez un script Bash ainsi que les manifestes Kubernetes. Le paquetage de déploiement est disponible en téléchargement sur My Esri et est livré sous forme d’un fichier .tar.gz. Avant d’exécuter le script de déploiement, lisez les instructions de prise en main.
Exécuter le script de déploiement en mode interactif
Si vous exécutez le script de déploiement ArcGIS Enterprise on Kubernetes sans spécifier un fichier de paramètres de configuration, il s’ouvre en mode interactif. Le script invite à renseigner chaque paramètre et vérifie immédiatement la validité de chaque valeur. C’est un moyen rapide de vérifier chaque paramètre de configuration dans votre déploiement.
- Sur votre machine cliente Kubernetes, ouvrez un terminal en tant qu’administrateur.
- Remplacez le répertoire par celui sur lequel se trouve votre script de déploiement.
- Sur le terminal, exécutez le script de déploiement sous le format de commande suivant :
./deploy.sh - Le script vous invite à renseigner les paramètres suivants, l’un après l’autre. Si vous fournissez une valeur non valide, le script renvoie immédiatement une erreur et invite à saisir un paramètre valide. Voici un récapitulatif des entrées utilisateur :
Remarque :
Il est inutile d’exécuter ce script en tant qu’utilisateur racine.
- Deployment platform (Plateforme de déploiement) : ArcGIS Enterprise on Kubernetes utilise ingress pour acheminer le trafic entrant vers les services dans le cluster. Si vous procédez au déploiement dans un service Kubernetes géré par un fournisseur d’hébergement sur le Cloud comme Amazon Web Services EKS ou Microsoft Azure AKS, le contrôleur ingress peut être exposé en externe à l’aide d’un équilibreur de charge par le fournisseur Cloud. Dans ce cas, ArcGIS Enterprise on Kubernetes provisionne un équilibreur de charge durant le processus de déploiement.
- Load balancer (Équilibreur de charge) : au cours du déploiement, ArcGIS Enterprise on Kubernetes peut provisionner les équilibreurs de charge Cloud sélectionnés grâce aux options Azure Load Balancer (externe et interne), AWS Network Load Balancer (NLB - externe) et AWS Classic Load Balancer. Chaque option vous invite à spécifier l’adresse IP de l’équilibreur de charge. Dans la présente version, seuls les équilibreur de charge Azure prennent en charge cette option ; AWS EKS ne prend pas en charge l’option de l’adresse IP de l’équilibreur de charge. Si vous utilisez OpenShift, vous pouvez utiliser Routes qui est habituellement renforcé par des équilibreurs de charge basés sur HAProxy ou Big-IP.
- Namespace (Espace de noms) : espace de noms de cluster Kubernetes dans lequel ArcGIS Enterprise on Kubernetes va être déployé.
- Registry Host (Hôte de registre) : nom du domaine complet (FQDN) de l’hôte du registre de conteneur (docker.io, par exemple).
- Image Path (Chemin d’image) : référentiel des images utilisé pour extraire les images de conteneur (esridocker, par exemple).
- Registry Username (Nom d’utilisateur du registre) : nom d’utilisateur d’un compte figurant dans le registre de conteneur spécifié qui stocke les autorisations à extraire du registre.
- Registry Password (Mot de passe du registre) : mot de passe relatif au compte de registre de conteneur spécifié.
- Fully Qualified Domain Name (Nom du domaine complet) : FQDN nécessaire pour accéder à ArcGIS Enterprise on Kubernetes. Il désigne un équilibreur de charge, un proxy inversé, un routeur périphérique ou un autre point front-end Web configuré pour acheminer le trafic vers le contrôleur ingress.
- Context Path Chemin de contexte) : chemin de contexte utilisé dans l’URL pour ArcGIS Enterprise on Kubernetes (par exemple, https://<FQDN>/<context path>) .
- Node Port (Port de nœud) : le contrôleur ingress expose le trafic externe sur un type de service "LoadBalancer" ou "NodePort". Le port peut être spécifié dans la plage 30000-32767. Si aucun port n’est spécifié, Kubernetes alloue automatiquement un port disponible dans cette plage.
- TLS Certificate (Certificat TLS) : un certificat TLS (auto-signé ou signé par une autorité de certification tierce) est requis avec le FQDN et l’autre nom de l’objet. Il s’agira du certificat TLS par défaut pour le contrôleur ingress.
Lorsque vous avez spécifié tous les paramètres valides, un fichier de propriétés est enregistré dans votre répertoire de travail actuel. Utilisez ce fichier de propriétés pour automatiser les déploiements à venir ou annuler le déploiement de ArcGIS Enterprise on Kubernetes.
La dernière étape du déploiement consiste à créer votre organisation ArcGIS Enterprise.
Conseil :
Le script de déploiement utilise les commandes kubectl pour valider les conditions prérequises, tel qu’un espace de noms valide. Si la commande kubectl n’est pas en mesure de communiquer avec le cluster du fait d’un problème lié au réseau ou au pare-feu, le script de déploiement risque de ne pas répondre. Si cela se produit, terminez la commande ./deploy.sh et exécutez kubectl directement sur un terminal afin de lancer la communication avec le cluster.
Exécuter le script de déploiement en mode silencieux
Au lieu d’exécuter le script de déploiement en mode interactif, vous pouvez déployer ArcGIS Enterprise on Kubernetes en mode silencieux. Le script de déploiement est groupé à un fichier deploy.properties qui fournit un jeu de paramètres vous invitant à une entrée unique dans votre déploiement ArcGIS Enterprise on Kubernetes.
- Sur votre machine cliente Kubernetes, ouvrez un terminal en tant qu’administrateur.
- Remplacez le répertoire par celui sur lequel se trouvent votre script de déploiement et le fichier deploy.properties.
- Ouvrez le fichier deploy.properties.
- Reportez-vous aux commentaires de description dans le fichier pour obtenir un résumé des entrées utilisateur et fournir des valeurs pour chaque paramètre figurant dans le fichier. Le fichier contient les sections suivantes :
- Plateforme de déploiement
- Espace de noms
- Registre de conteneur
- Nom du domaine complet
- Certificat TLS
- Enregistrez le fichier. Si vous le souhaitez, vous pouvez renommer le fichier.
- Sur le terminal, exécutez le script de déploiement sous le format de commande suivant :
./deploy.sh -f <user_properties>
Le contenu du fichier <user properties> provient du fichier deploy.properties.
Avant de déployer ArcGIS Enterprise on Kubernetes, le script de déploiement vérifie que votre système répond à la configuration système requise et que vous avez fourni une entrée valide pour chaque paramètre figurant dans le fichier deploy.properties.
La dernière étape du déploiement consiste à créer votre organisation ArcGIS Enterprise.
Vous avez un commentaire à formuler concernant cette rubrique ?