Skip To Content

Créer des déploiements à l’aide de la commande CREATE de ArcGIS Enterprise Cloud Builder CLI for AWS

La commande CREATE de l’utilitaire ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) crée un déploiement de base ArcGIS Enterprise avec la possibilité de créer une machine fédérée supplémentaire pour chaque rôle de licence ArcGIS Server. Cet utilitaire crée également des sites ArcGIS Server autonomes avec la possibilité d’enregistrer une géodatabase d’entreprise.

Remarque :

Avant d’exécuter la commande CREATE, vérifiez que votre organisation AWS a suffisamment de ressources disponibles pour le déploiement pour créer de nouvelles machines. La commande échoue si le nouveau déploiement dépasse la limite de votre organisation.

Vous pouvez ouvrir une copie de l’un des exemples de fichier JSON de Esri depuis le dossier CreateSamples et le modifier pour inclure vos paramètres. Par exemple, pour créer un déploiement optimisé pour les analyses raster, choisissez le fichier baseenterpriseallinonewithra.json.

Vous pouvez également utiliser un fichier JSON récapitulatif, que vous avez téléchargé depuis l’application ArcGIS Enterprise Cloud Builder for AWS, comme modèle pour de nouveaux déploiements. Vous ne pouvez cependant pas utiliser ArcGIS Enterprise Cloud Builder CLI for AWS pour ajouter les déploiements créés à l’aide de l’application ArcGIS Enterprise Cloud Builder for AWS.

Vous devez réaliser plusieurs étapes dans AWS Management Console avant d’exécuter la commande CREATE. Vous utiliserez les résultats de ces étapes comme valeurs des paramètres dans votre fichier JSON.

  1. Connectez-vous à AWS Management Console avec le compte que vous avez indiqué lors de la préparation du déploiement. Assurez-vous de vous trouver dans la même région que celle spécifiée avec le paramètre "AWSRegion" dans la section précédente.
  2. Pour les déploiements ArcGIS Enterprise de base sur une seule machine et la machine ArcGIS GeoEvent Server, attribuez une nouvelle adresse IP élastique dans AWS pour un Amazon Virtual Private Cloud (VPC). Copiez l’Allocation ID correspondant qui sera au format eipalloc-xxxxxxxx. Dans votre fichier JSON, collez l’ID en tant que valeur du paramètre EIPAllocationID sous BaseEnterprise.

    Si vous créez un seul déploiement ArcGIS Enterprise de base pour une seule machine, passez à l’étape 5.

  3. ArcGIS Server et les déploiements ArcGIS Enterprise haute disponibilité requièrent chacun un équilibreur de charge. Vous pouvez les créer en procédant comme suit ou utiliser des équilibreurs de charges existants. Pour utiliser des équilibreurs de charges existants, passez à l’étape 4.

    Créez l’équilibreur de charge en utilisant un exemple de modèle Esri AWS CloudFormation (option recommandée) ou créez-en un dans AWS Management Console. Si vous avez acheté un nom de domaine en dehors de AWS, vous devez apparier le domaine à l’équilibreur de charge avant de créer votre déploiement à l’aide de l’utilitaire. Si vous créez un équilibreur de charge à l’aide de AWS Management Console, veillez à utiliser le même VPC que votre déploiement et à configurer l’équilibreur de charge avec un module d’écoute HTTPS.

    L’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS peut utiliser l’équilibreur de charge que vous avez créé à l’aide du modèle CloudFormation ou dans AWS Management Console.

    Une fois les équilibreurs de charge créés, notez les noms DNS, qui se terminent en *.elb.amazonaws.com. Vous aurez besoin de ces informations pour la prochaine étape.

  4. Appariez les noms DNS de vos équilibreurs de charges à votre domaine. Si vous utilisez le service AWS Route 53, accédez à cette page ; enregistrez un domaine si vous ne l’avez pas encore fait et créez un ensemble d’enregistrements avec le nom de domaine de site de votre choix. Si vous utilisez un service différent pour l’appariement DNS, accédez à ce site. Dans les deux cas, définissez le type de nom du site du déploiement de base sur CNAME et collez le nom DNS que vous avez obtenu à l’étape 2 en tant que valeur. Répétez cette procédure pour apparier le nom DNS de chaque équilibreur de charge à chaque site ArcGIS Server.

    Par exemple, si vous créez un déploiement optimisé pour l’analyse raster, vous devez apparier le nom DNS de l’équilibreur de charge que vous avez créé pour votre serveur d’analyse raster à votre site ArcGIS Image Server.

  5. Ajoutez les noms de domaine des sites (par exemple, base.domain.com et raster.domain.com) au fichier JSON en tant que valeurs du paramètre "SiteDomain" dans la section appropriée du fichier, puis ajoutez le nom DNS de l’équilibreur de charge au fichier JSON en tant que valeur de ELBDNSName dans la section RasterAnalytics.

    Par exemple, lorsque vous modifiez l’exemple de fichier baseenterpriseallinonewithra.json, la valeur d’ID du VPC est définie dans la section "Default". Les autres valeurs sont définies dans les sections "BaseEnterprise" et "RasterAnalytics" comme suit :

    "Default" :{
          "NetworkStackName": "arcgis-vpc",
          "KeypairName": "Your_Keypair_Name",
          "InstanceType": "m5.2xlarge",
          "InstanceDriveSize": "100",
          "FileserverInstanceType": "m5.2xlarge",
          "FileserverInstanceDriveSize": "200",
          "ServerInstances": "2",
          "ConfigStoreType": "CloudStore",
          "SiteadminUserName": "admin",
          "SiteadminUserPassword": "changeit",
          "arcgisUserPassword": "changeit",
          "SSLCertificateFileKeyName": "resources/sslcerts/wildcard_yourdomain_com.pfx",
          "SSLCertificatePassword": "changeit"
        },
        "BaseEnterprise":{
          "Type": "AllInOne",
          "EIPAllocationID": "eipalloc-12345bc89",
          "SiteDomain": "baseenterprise.yourdomain.com",
          "ServerLicenseFileKeyName": "resources/licenses/112/server/Your_Server_License.prvc",
          "PortalLicenseFileKeyName": "resources/licenses/112/portal/Your_Portal_License.json",
          "UserLicenseTypeID": "creatorUT",
          "PortalWebadaptorName": "portal",
          "ServerWebadaptorName": "server"
        },
        "RasterAnalytics":{
          "ServerLicenseFileKeyName": "resources/licenses/112/rasteranalytics/Your_RasterAnalytics_Server_License.prvc",
          "SiteDomain": "ra.yourdomain.com",
          "ELBDNSName": "your_ELB_DNS_name",
          "ServerWebadaptorName": "rasteranalytics",
          "Federate":true,
          "CloudStoreS3BucketPath": "your_s3_bucket_name/racloudstore"
        }
  6. Créez une paire de clés dans AWS. Ajoutez le nom de la paire de clés à votre fichier JSON en tant que valeur du paramètre "KeypairName".
  7. Dans votre fichier JSON, modifiez les paramètres restants en fonction de vos besoins. Reportez-vous à la liste complète de paramètres de ArcGIS Enterprise Cloud Builder CLI for AWS pour obtenir des descriptions.
  8. Enregistrez votre fichier JSON modifié. Revenez dans la fenêtre de l’invite de commandes et exécutez la commande CREATE : cloudbuilder.exe CREATE -j <createfilename.json>

    L’utilitaire crée un fichier en sortie dans le dossier Output de ArcGIS Enterprise Cloud Builder CLI for AWS, dans un sous-dossier nommé selon votre paramètre DeploymentName. À chaque fois que vous exécutez la commande CREATE pour le même déploiement de ArcGIS Enterprise, les fichiers en sortie sont placés dans le sous-dossier du déploiement correspondant. Les fichiers sont nommés <DeploymentName>_<batchID>.json, où la chaîne batchID contient un horodatage de création de fichier. L’utilitaire ne supprime jamais les anciens fichiers en sortie.

    Les fichiers journaux sont créés dans un dossier Logs, dans le répertoire dans lequel vous avez extrait ArcGIS Enterprise Cloud Builder for Amazon Web Services.

    L’exemple suivant montre le contenu d’un fichier en sortie généré lorsque vous exécutez la commande CREATE pour créer un déploiement de base, et ArcGIS GeoAnalytics Server, le serveur d’analyse raster, les sites ArcGIS GIS Server, et ArcGIS GeoEvent Server :

    "BaseEnterprise":{
               "PortalURL": "http://enterprise.yourdomain.com/portal/home",
               "ServerURL": "http://enterprise.yourdomain.com/server/manager"	 
       },
       "GeoAnalytics":{
                "ServerURL": "http://geoanalytics.yourdomain.com/geoanalytics/manager"	
       },
       "RasterAnalytics":{
                "ServerURL": "http://rasteranalytics.yourdomain.com/rasteranalytics/manager"
       },
       "Server":{     
           "ServerURL": "http://server.yourdomain.com/gisserver/manager"
       },
       "GeoEvent":{
               "ServerURL": "http://geoevent.yourdomain.com/geoevent/manager",
               "GeoEventServerURL": "http://geoevent.yourdomain.com:6143/geoevent/manager"
       }

    Notez que le contenu du fichier en sortie varie en fonction des informations fournies dans le fichier de configuration JSON.