Skip to main content

Déployer dans un environnement déconnecté

Lorsque l’accès à Internet est interdit ou n’est pas disponible pour votre organisation, vous pouvez déployer ArcGIS Enterprise on Kubernetes dans un environnement déconnecté. Pour cela, vous devez créer le registre de conteneur de votre organisation, utiliser les outils de registre pour renseigner les images de votre conteneur et configurer l’organisation afin d’utiliser des ressources locales.

Préparer le déploiement

Avant de déployer ArcGIS Enterprise on Kubernetes en vue d’une utilisation déconnectée, consultez la configuration système requise et les étapes du plan de déploiement, puis préparez le registre de conteneurs de votre organisation. Pour préparer votre registre, vous devez avoir accès à chacun des éléments suivants :

  • Accès Internet pour obtenir les images du conteneur

  • Identifiants de connexion au référentiel Esri Docker Hub

  • Identifiants de connexion pour l’accès en lecture et en écriture au registre de conteneur de votre organisation

  • Docker Engine

  • Un périphérique de stockage avec 200 Go d’espace disque libre pour stocker des images téléchargées

Remarque :

Pour utiliser la mise à l’échelle automatique horizontale de pod, assurez-vous que votre registre possède les images appropriées.

Déployer

Après avoir chargé les images sur votre registre de conteneur, exécutez le script de déploiement afin de déployer ArcGIS Enterprise on Kubernetes. Le script de déploiement est interactif et vous invite à spécifier plusieurs paramètres.

Remarque :

Lors de la spécification de l’hôte du registre, vous devez renseigner les détails de votre registre de conteneur.

Configurer l’organisation

Après avoir exécuté le script de déploiement, suivez les étapes pour créer une organisation. Ces étapes sont identiques pour les organisations avec ou sans accès Internet.

Télécharger et importer le manifeste

Par défaut, ArcGIS Enterprise Administrator API utilise une URL connue pour détecter quand des mises à jour des images de conteneur sont disponibles. Lorsque le cluster Kubernetes n’est pas connecté à Internet, vous devez télécharger ce fichier et l’importer dans votre organisation.

Utilisez le script create-offline-manifest.sh pour télécharger d’abord le fichier manifeste publié par Esri et l’importer dans votre organisation. Un accès Internet est nécessaire pour télécharger le fichier manifeste.

  1. Sur votre machine cliente Kubernetes, ouvrez un terminal.

  2. Modifiez les répertoires pour désigner le répertoire setup/tools/registry-tools.

  3. Sur le terminal, exécutez le script create-offline-manifest.sh sous le format de commande suivant :

    ./create-offline-manifest.sh -d /path/to/download/directory

  4. Une fois le téléchargement terminé, exécutez de nouveau le script create-offline-manifest.sh sous le format de commande suivant pour importer la version du fichier manifeste dans votre organisation :

    ./create-offline-manifest.sh -i </path/to/download/directory/manifest.dat> -u <username> -p <password> -a https://organization.example.com/context

    1. Si vous avez créé une organisation à l’aide du script configure.sh, exécutez la commande suivante :

      ./create-offline-manifest.sh -i </path/to/download/directory/manifest.dat> -f ../configure/configure.properties

Lorsque la version du manifeste est importée, vous avez terminé les étapes du déploiement. Vous allez ensuite configurer l’organisation pour utiliser les ressources locales, le cas échéant.

Remarque :

Pour vérifier que la version du manifeste a été importée, vous pouvez exécuter la commande suivante :

kubectl get secret arcgis-version-manifest -n <namespace>

Configurer les ressources locales

Lorsque l’organisation est déconnectée d’Internet, configurez l’organisation pour utiliser les services et ressources locaux en cas de nécessité.

Configurer les fonds de carte personnalisés

L’organisation est préconfigurée avec une collection de fonds de carte issus d’ArcGIS Online. L’utilisation de ces fonds de carte n’est pas prise en charge dans un environnement déconnecté. À la place, créez vos propres fonds de carte personnalisés et configurez l’organisation de manière à proposer ces fonds de carte dans la bibliothèque de fonds de carte.

Pour plus de détails sur la création et la configuration de fonds de carte personnalisés dans votre organisation, reportez-vous à la rubrique Personnaliser des fonds de carte.

Configurer des services utilitaires

Par défaut, les services utilitaires sont configurés pour utiliser ceux d’ArcGIS Online. Pour savoir comment mettre à jour les services utilitaires pour qu’ils pointent vers des services locaux, reportez-vous à la rubrique Configurer des services utilitaires.

Contenu d’ArcGIS Living Atlas of the World

ArcGIS Living Atlas of the World est un ensemble de contenu géographique et prêt à l’emploi disponible dans ArcGIS Online. Elle n’est pas prise en charge dans les environnements déconnectés. Pour désactiver le contenu ArcGIS Living Atlas of the World, consultez les étapes visant à désactiver ou ajuster d’autres ressources ArcGIS Online.

Configurer la propriété jsapiCDN pour les services de notebook

Pour configurer la propriété jsapiCDN, procédez comme suit :

  1. Connectez-vous à ArcGIS Enterprise Administrator API en tant qu’administrateur.

    L’URL est au format suivant : https://organization.example.com/context/admin.

  2. Cliquez sur Notebooks > Configuration > Update Configuration (Mettre à jour la configuration).

  3. Ajoutez la propriété suivante à la fin de la liste existante des propriétés :

    "jsapiCDN": "https://[organization.example.com]/[context]/jsapi/jsapi"

  4. Cliquez sur Update Notebook Configuration (Mettre à jour la configuration du notebook) pour enregistrer les modifications.

Désactiver le contenu externe

Parce qu’un certain contenu Esri nécessite un accès externe à Internet, vous devez désactiver ce contenu pour empêcher les requêtes à des ressources ArcGIS Online. Pour plus d’informations, reportez-vous à la rubrique Désactiver le contenu externe.

Une fois le contenu externe désactivé, les éléments incluant des URL renvoyant à des sites externes ne sont plus détectables ou renvoyés dans les résultats de recherche.

Désactiver ou ajuster d’autres sources ArcGIS Online

Certaines fonctions dans l’organisation ont été préconfigurées pour utiliser des services ou du contenu ArcGIS Online : Lorsque vous travaillez dans des environnements déconnectés, vous pouvez désactiver ces types de services et de contenu en ajustant les propriétés de l’organisation. Ces propriétés sont, par exemple, les suivantes :

  • extentService: "<URL to local map service>", - Le service d’étendue permet de mettre à jour ou de définir l’étendue d’un élément de carte Web dans la boîte de dialogue Set Extent (Définir l’étendue) de l’organisation. Par défaut, le service d’étendue provient d’ArcGIS Online. Dans un environnement déconnecté, vous devez configurer votre organisation avec un service de carte tuilé GIS Server. Le service doit utiliser le système de coordonnées géographiques WGS84 avec l’ID connu (WKID) 4326.

  • portalAGOConfigEnabled: true, - Contrôle l’affichage de l’onglet ArcGIS Online dans la page Settings (Paramètres) de l’organisation. Dans un environnement déconnecté, définissez cette propriété sur false.

  • portalLivingAtlasConfigEnabled: true, - Avec la propriété portalAGOConfigEnabled, cette propriété contrôle l’affichage de la section Configure Living Atlas Content (Configurer le contenu Living Atlas) sur l’onglet ArcGIS Online de la page Settings (Paramètres) de l’organisation. Dans un environnement déconnecté, définissez cette propriété sur false.

  • searchArcGISOnlineEnabled: true, - Cette propriété permet de désactiver l’option dans Map Viewer Classic afin de rechercher des couches dans ArcGIS Online. La valeur par défaut est true. Si cette propriété est désactivée, l’option de recherche des couches dans ArcGIS Online est masquée dans la boîte de dialogue Search for Layers (Rechercher des couches) dans Map Viewer Classic. Dans un environnement déconnecté, définissez cette propriété sur false.

Pour en savoir plus sur les propriétés modifiables, reportez-vous à la documentation des API de partage et procédez selon les étapes pour définir les options avancées du portail.

Mettre à jour et mettre à niveau

Lorsqu’une mise à jour ou une mise à niveau de logiciel est disponible, vous devez procéder comme suit :