Skip To Content

Préparer les ressources de déploiement à l’aide de la commande PREP de ArcGIS Enterprise Cloud Builder CLI for AWS

La commande PREP de ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services automatise plusieurs tâches préalables essentielles pour un déploiement de ArcGIS Enterprise sur Amazon Web Services (AWS). Après avoir préparé un fichier JSON spécifiant les paramètres, exécutez la commande PREP pour effectuer les opérations suivantes :

  • Créez une pile réseau et un compartiment Amazon Simple Storage Service (S3) pour le déploiement s’il n’existe pas déjà de compartiment. Le compartiment S3 est géré par Cloud Builder.
  • Créez un Amazon Virtual Private Cloud (VPC) pour le déploiement.
  • Téléchargez tous les fichiers d’autorisation et les certificats SSL nécessaires pour le compartiment S3.
  • Importez le certificat SSL dans AWSAWS Certificate Manager.

La commande PREP ne doit être à nouveau exécutée que dans les circonstances suivantes :

  • Vous souhaitez créer un autre déploiement dans une autre région ou sur un réseau distinct.
  • Vous possédez plusieurs comptes AWS et vous souhaitez créer des déploiements pour différents comptes.
  • Vous devez mettre à jour le certificat SSL pour votre déploiement.
  • Vos licences ArcGIS ont expiré, et vous devez charger de nouveaux fichiers de licence.

La commande PREP renvoie les informations vers un fichier texte sur le disque local.

  1. Téléchargez le programme d’installation de ArcGIS Enterprise Cloud Builder for Amazon Web Services depuis My Esri, puis placez-le sur le disque local.
  2. Double-cliquez sur le fichier Setup.exe pour lancer l’installation. Suivez les instructions écran par écran pour procéder à l’installation.

    L’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS ainsi que les fichiers et exemples qui l’accompagnent sont installés à l’emplacement que vous avez indiqué pendant l’installation.

  3. Déplacez le certificat SSL (.pfx) et les fichiers de licence (.prvc ou .ecp pour ArcGIS Server, et .json pour Portal for ArcGIS) sur la machine sur laquelle vous avez extrait l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS.
  4. Si vous souhaitez modifier et utiliser les fichiers d’exemple .json fournis avec l’utilitaire, effectuez des copies des fichiers dans le dossier Configuration\PrepSamples. Veillez à placer les copies dans un sous-dossier du dossier Configuration.
  5. Avant d’exécuter la commande PREP à l’aide de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS, modifiez l’un des fichiers d’exemple de préparation ou créez votre propre fichier de préparation .json.

    Pour créer un VPC ainsi qu’un compartiment S3 et télécharger le certificat SSL et les fichiers de licence ArcGIS en une seule étape, modifiez la copie du fichier d’exemple allprep.json ou créez votre propre fichier de préparation .json incluant les paramètres indiqués dans l’exemple ci-après. Ouvrez le fichier dans un éditeur de texte, définissez les paramètres correspondant aux informations de votre compte et déploiement, et enregistrez vos modifications. Pour obtenir une description de chaque paramètre, reportez-vous à la rubrique Paramètres de ArcGIS Enterprise Cloud Builder CLI for AWS.

    Dans cet exemple, l’utilitaire se connecte au compte AWS avec la clé d’accès du compte et la clé d’accès secrète. Les fichiers de licence et un certificat SSL sont copiés à partir des dossiers locaux spécifiés, puis placés dans le compartiment de déploiement S3 géré par ArcGIS Enterprise Cloud Builder for AWS. Un VPC est également créé dans les zones de disponibilité ap-northeast-1b et ap-northeast-1a.

    Sachez qu’il est possible que toutes les licences ArcGIS Server se trouvent dans le même fichier.

    {
    	"AWSCredentials": {
    		"AWSAccessKey": "ABCDEFGHIMI4YCPABC",
    	 "AWSSecretKey": "ABCDLZDYIzZuXHlWHOPhMqrTmABCD",
    		"AWSRegion": "ap-northeast-1"
    	},
    	"NetworkStack": {
    		"StackName": "EnterpriseVPC",
    		"AZs": "ap-northeast-1b,ap-northeast-1a",
    		"CreateFlag":true
    	},
    	"ArcGISEnterpriseFiles": {
    	 "PortalLicense": "C:\\ArcGISLicenses\\Your_Portal_License.json",
    		"ServerLicense": "C:\\ArcGISLicenses\\Your_GIS_Server_License.prvc",
    		"GeoAnalyticsLicense": "C:\\ArcGISLicenses\\Your_GeoAnalytics_Server_License.prvc",
      "NotebookServerLicense": "C:\\ArcGISLicenses\\Your_Notebook_Server_License.prvc",
      "MissionServerLicense": "C:\\ArcGISLicenses\\Your_Mission_Server_License.prvc",
      "ImageServerLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc",
    		"RasterAnalyticsLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc",
    		"ImageHostingLicense": "C:\\ArcGISLicenses\\Your_Image_Server_License.prvc",
    		"GeoEventLicense": "C:\\ArcGISLicenses\\Your_GeoEvent_Server_License.prvc",
    	 "WorkflowManagerLicense": "C:\\ArcGISLicenses\\Your_Workflow_Manager_License.prvc",
      "KnowledgeServerLicense": "C:\\ArcGISLicenses\\Your_Knowledge_Server_Licesne.prvc", 
    		"SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx",
    		"SSLCertPassword": "changeit"
    	}
    }

  6. Ouvrez l’invite de commande et accédez au répertoire (cd) dans lequel vous avez installé l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS et les fichiers. Exécutez l’utilitaire à l’aide de la commande PREP : cloudbuilder.exe PREP -j <prepfilename.json>

    Par exemple, pour utiliser un fichier nommé myallprep.json que vous avez placé dans un nouveau sous-dossier du fichier de préparation du répertoire Configuration de ArcGIS Enterprise Cloud Builder CLI for AWS, saisissez ce qui suit :

    cloudbuilder.exe PREP -j Configuration\MyPrepFiles\myallprep.json

  7. Localisez le fichier en sortie de l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS (au format PREP_<date><time>.json) dans le dossier CloudBuilder\AWS\CLI\Output sur le disque local.

    Ce fichier contient les informations dont vous avez besoin pour créer le déploiement.

    En sortie, l’exécution du fichier d’exemple de l’étape 5 inclut un ID et deux ID de sous-réseau pour un nouveau VPC, le nom du compartiment S3 et l’unique ARN (Amazon Resource Name) créé pour le certificat SSL.

    "NetworkStack": {
          "VPCId": "vpc-z9fb11ba",
          "subnet1": "subnet-z319acee",
          "subnet2": "subnet-f4fc658f"
       },
       "DeploymentDetails": {
          "PortalLicense": "resources/licenses/<version>/portal/Your_Portal_License.json",
    	    	"ServerLicense": "resources/licenses/<version>/server/Your_GIS_Server_License.prvc",
    	    	"GeoAnalyticsLicense": "resources/licenses/<version>/geoanalytics/Your_GeoAnalytics_Server_License.prvc",
          "NotebookServerLicense": "resources/licenses/<version>/notebookserver/Your_Notebook_Server_License.prvc",
          "MissionServerLicense": "resources/licenses/<version>/missionserver/Your_Mission_Server_License.prvc",
          "ImageServerLicense": "resources/licenses/<version>/image/Your_Image_Server_License.prvc",
    	    	"RasterAnalyticsLicense": "resources/licenses/<version>//rasteranalytics/Your_Image_Server_License.prvc",
    	    	"ImageHostingLicense": "resources/licenses/<version>//imagehosting/Your_Image_Server_License.prvc",
    	    	"GeoEventLicense": "resources/licenses/<version>/geoevent/Your_GeoEvent_Server_License.prvc",
    	    	"WorkflowManagerLicense": "resources/licenses/<version>/workflow/Your_Workflow_Manager_License.prvc", 
          "KnowledgeServerLicense": "C:\\ArcGISLicenses\\Your_Knowledge_Server_Licesne.prvc",
    	     "SSLCertificateFile": "resources/sslcerts/wildcard_yourdomain_com.pfx",
          "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
          "DeploymentBucket": "esri-aws-1234567890"
       }

    Le contenu du fichier en sortie varie en fonction des informations que vous avez fournies dans le fichier de configuration.

Vous êtes maintenant prêt à créer un déploiement à l’aide de l’interface de ligne de commande.