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 réseau et un paquet Amazon Simple Storage Service (S3) pour votre déploiement s’il n’y a pas encore de paquet. Le paquet S3 est géré par Cloud Builder.
- 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 charger de nouveaux fichiers de licence.
La commande PREP renvoie les informations vers un fichier texte sur votre disque local.
- Téléchargez le programme d’installation pour ArcGIS Enterprise Cloud Builder for Amazon Web Services depuis My Esri, puis placez-le sur votre disque local.
- Double-cliquez sur le fichier Setup.exe pour lancer le processus d’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.
- 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.
- 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.
- 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 AWS à l’aide de la clé d’accès et de la accès clé secrète correspondantes. Les fichiers de licence et un certificat SSL provenant des dossiers locaux spécifiés sont copiés dans le paquet de déploiement S3 qui est 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 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": { "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", "SSLCertificateFile": "C:\\MyCerts\\wildcard_yourdomain_com.pfx", "SSLCertPassword": "changeit" } } - Ouvrez l’invite de commande et changez de dossier (cd) pour celui où vous avez installé l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS et ses 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 dossier ArcGIS Enterprise Cloud Builder CLI for AWS Configuration, saisissez ce qui suit :
cloudbuilder.exe PREP -j Configuration\MyPrepFiles\myallprep.json
- 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": { "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", "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" }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.
Vous avez un commentaire à formuler concernant cette rubrique ?