Indiquer un environnement Python pour tous les services de géotraitement

Pour déployer des paquetages Python tiers avec ArcGIS Server, suivez les étapes ci-après sur chaque machine de votre site :

1. Connectez-vous à votre machine ArcGIS Server avec le compte ArcGIS Server, et ouvrez l’invite de commande en tant qu’administrateur.
2. Définissez le répertoire sur <install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\Scripts.
3. Clonez l’environnement Python par défaut du serveur avec un nouveau nom d’environnement, par exemple newenvname, dans le répertoire de l’environnement Python de l’installation ArcGIS Server avec la commande conda create --clone arcgispro-py3 --prefix "<install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\newenvname". Remplacez le préfixe avec votre répertoire d’installation et le nouveau nom de l’environnement.
4. Pour activer l’environnement cloné, exécutez proswap newenvname.
5. Installez les paquetages Python tiers en exécutant conda install. Utilisez uniquement pip install si conda install n’est pas disponible.
6. Redémarrez le service ArcGIS Server sur l’onglet Services (Services) du gestionnaire de tâches Windows ou les services Windows. Il faudra quelques minutes avant que tous les services ne soient de nouveau en ligne.
7. Répétez les étapes 1 à 6 sur chaque machine de votre site ArcGIS Server, le cas échéant.

Pour ajouter des paquetages supplémentaires à l’environnement conda existant, procédez comme suit :

1. Connectez-vous à votre machine ArcGIS Server.
2. Depuis le menu Démarrer, ouvrez l’invite de commande Python 3. Elle peut se trouver dans le dossier ArcGIS Server, selon votre système d’exploitation.
3. Exécutez conda install pour les paquetages qui doivent être déployés. Utilisez uniquement pip install si conda install n’est pas disponible.
4. Relancez le services de géotraitement dans ArcGIS Server Manager.
5. Vous pouvez aussi redémarrer le service ArcGIS Server sur l’onglet Services du gestionnaire de tâches Windows. Tous les services seront de nouveau en ligne en quelques minutes.
6. Répétez les étapes 1 à 5 sur chaque machine de votre site ArcGIS Server, le cas échéant.

Indiquer un environnement Python pour un seul service de géotraitement

Clonez l’environnement Python par défaut du serveur, installez les paquetages Python tiers et modifiez les propriétés de votre service de géotraitement en suivant les étapes ci-après :

1. Connectez-vous à votre machine ArcGIS Server avec le compte ArcGIS Server, et ouvrez l’invite de commande en tant qu’administrateur.
2. Définissez le répertoire sur <install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\Scripts.
3. Clonez l’environnement Python par défaut du serveur avec un nouveau nom d’environnement, par exemple newenvname, dans le répertoire de l’environnement Python de l’installation ArcGIS Server avec la commande conda create --clone arcgispro-py3 --prefix "<install>\ArcGIS\Server\framework\runtime\ArcGIS\bin\Python\envs\newenvname". Remplacez le préfixe avec votre répertoire d’installation et le nouveau nom de l’environnement.
4. Activez le nouvel environnement dans la fenêtre d’invite de commande avec activate newenvname.
5. Installez vos paquetages Python avec conda install packagename=version. Une bonne pratique (facultative) consiste à aligner la version de paquetage que vous avez utilisée dans ArcGIS Pro pendant le processus de publication sur la version de paquetage installée sur le serveur.
6. Une fois tous les paquetages installés, accédez au répertoire administrateur ArcGIS Server. Dans Resources (Ressources) en bas de la page, accédez à services.
7. Sélectionnez le service de géotraitement pour lequel vous souhaitez indiquer un environnement Python.
8. Dans Supported Operations (Opérations prises en charge) en bas de la page, cliquez sur edit (modifier).
9. Dans le fichier JSON du service, ajoutez la paire clé-valeur "condaEnvironmentPath": "<install>\\ArcGIS\\Server\\framework\\runtime\\ArcGIS\\bin\\Python\\envs\\newenvname" aux propriétés. Un fichier JSON simplifié des propriétés du service contient la nouvelle propriété condaEnvironmentPath en tant que

   Service Properties

   {
    "serviceName": "gvonly",
    "type": "GPServer",
    "description": "",
    "allowedUploadFileTypes": "",
    "properties": {
     "toolbox": "C:\\arcgisserver\\directories\\arcgissystem\\arcgisinput\\gvonly.GPServer\\extracted\\p20\\gvonly.tbx",
     "condaEnvironmentPath": "C:\\Program Files\\ArcGIS\\Server\\framework\\runtime\\ArcGIS\\bin\\Python\\envs\\flaskonly"
    },
    "portalProperties": {
     "isHosted": false,
     "portalItems": [{
      "itemID": "4921223df97744a593d0b776666b9da9",
      "type": "GPServer"
     }]
    },
    "extensions": [{
     "typeName": "WPSServer",
     "properties": {
      "serviceType": "",
      "name": ""
     }
    }],
    "frameworkProperties": {},
    "datasets": []
   }

10. Cliquez sur le bouton Save Edits (Enregistrer les mises à jour) pour enregistrer vos modifications.
11. Votre service est automatiquement redémarré.