Skip To Content

Exécutez la commande PREP

La commande ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services PREP 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 vos paramètres, exécutez la commande PREP pour effectuer les actions suivantes :

  • Créez une pile de réseau et un paquet Amazon Simple Storage Service (S3) pour votre déploiement.
  • Créez un Amazon Virtual Private Cloud (VPC) pour votre déploiement.
  • Téléchargez tous les fichiers d’autorisation et les certificats SSL nécessaires pour le paquet S3.
  • Importez votre certificat SSL dans le gestionnaire de certificats de AWS.

La commande PREP ne doit être exécutée à nouveau 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 les différents comptes.
  • Vous devez mettre à jour le certificat SSL pour votre déploiement.
  • Vos licences ArcGIS ont expiré et vous devez télécharger de nouveaux fichiers de licence.

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

  1. Téléchargez le fichier ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe depuis My Esri et placez-le sur votre disque local.
  2. Double-cliquez sur le fichier ArcGIS_Enterprise_Cloud_Builder_AWS_CLI_<version>_<#>.exe pour extraire son contenu. Au moment de l’extraction, vous pouvez spécifier un emplacement où extraire les fichiers ou utiliser l’emplacement par défaut, c:\Program Files\ArcGIS\CloudBuilder\AWS\CLI. Vous devez disposer du statut d’administrateur Windows pour extraire les fichiers à l’emplacement par défaut.

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

  3. Déplacez votre 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. 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 et un paquet S3 et télécharger votre certificat SSL et vos fichiers de licence ArcGIS en une seule étape, modifiez votre copie du fichier d’exemple allprep.json, ou créez votre propre fichier .json incluant les paramètres indiqués dans l’exemple suivant. 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 d’ArcGIS Enterprise Cloud Builder CLI for AWS

    Dans cet exemple, l’utilitaire se connecte au compte à l’aide de la clé d’accès et de la clé secrète du compte AWS. Un paquet Amazon S3 nommé EnterpriseFiles est créé dans la région ap-northeast-1, et des fichiers de licence ainsi qu’un certificat SSL sont copiés depuis les dossiers locaux spécifiés et placés dans le paquet S3. Un VPC est également créé dans les zones de disponibilité ap-northeast-1b et ap-northeast-1a.

    Sachez qu’il est possible que toutes vos 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": {
    	 "DeploymentBucket": "enterprisefiles",
    		"PortalLicense": "C:\\ArcGISLicenses\\Your_Portal_License.json",
    		"ServerLicense": "C:\\ArcGISLicenses\\Your_GIS_Server_License.prvc",
    		"GeoAnalyticsLicense": "C:\\ArcGISLicenses\\Your_GeoAnalytics_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",
    		"SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx",
    		"SSLCertPassword": "changeit"
    	}
    }
  6. Ouvrez l’invite de commandes et changez de dossier (cd) pour celui où vous avez extrait l’utilitaire et les fichiers ArcGIS Enterprise Cloud Builder CLI for AWS. 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 dossier ArcGIS Enterprise Cloud Builder CLI for AWS Configuration, 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 votre 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 paquet S3, et l’unique Amazon Resource Name (ARN) créé pour votre certificat SSL.

    "NetworkStack": {
          "VPCId": "vpc-z9fb11ba",
          "subnet1": "subnet-z319acee",
          "subnet2": "subnet-f4fc658f"
       },
       "DeploymentDetails": {
          "DeploymentBucket": "enterprisefiles",
          "SSLCertificateARN": "arn:aws:acm:ap-northeast-1:123456789123:certificate/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
       }

    Notez que le contenu du fichier en sortie varie en fonction des informations 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.