Lorsque vous utilisez ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) pour préparer et déployer ArcGIS Enterprise et les sites ArcGIS Server, vous fournissez des informations concernant le type de déploiement que vous désirez en indiquant l’emplacement et le nom du fichier JSON contenant les paramètres dont vous avez besoin.
Plusieurs fichiers d’exemple JSON sont inclus dans le fichier ArcGIS Enterprise Cloud Builder CLI for AWS que vous téléchargez depuis My Esri. Les exemples JSON représentent des déploiements courants. Il existe des fichiers distincts pour les étapes préparatoires — ceux que vous pouvez utiliser lorsque vous exécutez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS avec la commande PREP — et les fichiers que vous pouvez utiliser pour créer un déploiement lorsque vous exécutez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS avec la commande CREATE.
Les deux tables suivantes décrivent les fichiers d’exemple fournis avec l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS.
| Fichier d’exemple de préparation | Description |
|---|---|
| createnetworkvpc.json | Crée un Virtual Private Cloud (VPC) dans la région AWS que vous spécifiez. |
| uploadlicensefile.json | Télécharge des licences ArcGIS Server et une licence Portal for ArcGIS. Si vous souhaitez spécifier un nom pour le paquet Amazon Simple Storage Service (S3), ajoutez le paramètre "DeploymentBucket" dans la section "ArcGISEnterpriseFiles" ; faute de quoi, un paquet avec un nom par défaut est créé. |
| uploadsslcert.json | Télécharge un certificat SSL dans le paquet Amazon S3 que vous spécifiez et importe le certificat SSL dans le gestionnaire de certificats AWS. |
| uploadlicenseandcert.json | Télécharge des licences ArcGIS Server, une licence Portal for ArcGIS, et un certificat SSL dans le paquet Amazon S3 que vous spécifiez. Le certificat SSL est également importé dans le gestionnaire de certificats AWS. |
| allprep.json | Crée un VPC et télécharge des licences ArcGIS Server, une licence Portal for ArcGIS, et un certificat SSL dans le paquet Amazon S3 que vous spécifiez. Le certificat SSL est également importé dans le gestionnaire de certificats AWS. |
| Fichier d’exemple de création | Description |
|---|---|
| baseenterpriseallinone.json | Déploie une instance ArcGIS Enterprise de base sur une seule machine. |
| baseenterpriseha.json | Déploie une instance ArcGIS Enterprise de base sur deux machines ; une machine principale et une machine de secours. |
| baseenterpriseallinonewithra.json | Déploie une instance ArcGIS Enterprise de base plus un site ArcGIS Image Server fédéré configuré en tant que serveur d’analyse raster du portail. |
| baseenterprisehawithga.json | Déploie une instance ArcGIS Enterprise de base sur deux machines plus un site ArcGIS GeoAnalytics Server fédéré configuré en tant que serveur GeoAnalytics du portail. |
| baseenterpriseimagehosting.json | Déploie une instance ArcGIS Enterprise de base plus un site ArcGIS Image Server fédéré configuré en tant que serveur d’hébergement d’images du portail. Cette option est une nouveauté de la version 10.6.1. |
| baseenterpriseimagehostingrasterstore.json | Déploie une instance ArcGIS Enterprise de base plus un site ArcGIS Image Server fédéré configuré en tant que serveur d’hébergement d’images du portail. Vous pouvez également utiliser ce fichier pour créer un répertoire cloud dans S3 et l’inscrire en tant que stockage raster. Cette option est une nouveauté de la version 10.6.1. |
| standalonegeoevent.json | Déploie un site ArcGIS GeoEvent Server autonome. |
| standaloneserver.json | Déploie un site ArcGIS GIS Server autonome. |
| standaloneserverwithexistingelb.json | Déploie un site ArcGIS GIS Server autonome avec un équilibreur de charges élastiques que vous avez déjà créé. |
| completeArcGISenterprise.json | Vous permet de déployer une instance ArcGIS Enterprise de base tout-en-un ou hautement disponible et tous les sites ArcGIS Server fédérés possibles. |
Vous pouvez copier et modifier ces fichiers à l’aide d’un éditeur de texte ou créer vos propres fichiers JSON. Si vous utilisez les exemples, modifiez les paramètres des exemples pour utiliser des valeurs spécifiques à votre déploiement. Vous pouvez également choisir quels paramètres conserver dans les fichiers d’exemple.
Les paramètres du fichier JSON sont regroupés dans des en-têtes de section (nœud). Ces paramètres et leurs regroupements sont décrits dans les sections suivantes de cette rubrique.
Informations de connexion et région AWS
Pour établir la connexion à Amazon Web Services, la commande nécessite vos informations de connexion AWS. Les informations de connexion peuvent être la clé d'accès et la clé secrète pour votre compte AWS, ou le nom de profil AWS pour votre compte. Ces informations de connexion sont requises pour exécuter l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS, et sont regroupées dans la section "AWSCredentials".
Vous devez également spécifier la région AWS dans laquelle vous souhaiter effectuer le déploiement. Cette région doit être la même pour tous les composants de votre déploiement.
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "AWSAccessKey" | La clé d'accès de votre compte AWS. | Requise si vous ne spécifiez pas le paramètre "AWSProfileName". |
| "AWSSecretKey" | La clé secrète de votre compte AWS. | Requise si vous ne spécifiez pas le paramètre "AWSProfileName". |
| "AWSProfileName" | Le nom du profil que vous avez configuré pour votre compte AWS. | Requis si vous ne spécifiez pas les paramètres "AWSAccessKey" et "AWSSecretKey". |
| "AWSRegion" | La région AWS où seront créées toutes les parties de votre déploiement. | Obligatoire |
Dans cet exemple, les informations de connexion requises pour l’autorisation sont la clé d’accès et la clé secrète du compte AWS. Les instances EC2 seront lancées dans la région AWS eu-west-2."AWSCredentials": {
"AWSAccessKey": "AKIAINKWSK6MI4YCPA123",
"AWSSecretKey": "ABCD1E2fghIJkLmNOPQzZuXHlWHOPhMqrTmPEpV",
"AWSRegion": "eu-west-2"
}
Dans cet exemple, l’information de connexion requise pour l’authentification est le nom du profil configuré pour le compte AWS. Les instances EC2 seront lancées dans la région AWS eu-west-1."AWSCredentials": {
"AWSProfileName": "betavpc", "AWSRegion": "us-west-1"
}
Paramètres à utiliser dans les fichiers pour préparer le déploiement
Avant de créer un déploiement, vous devez créer un VPC et un paquet de déploiement S3 et télécharger votre certificat SSL et vos licences logicielles ArcGIS dans le paquet S3. Vous pouvez définir des paramètres dans un fichier de préparation .json pour effectuer ces étapes.
Pile réseau
La section "NetworkStack" est une section facultative du fichier de préparation qui vous permet de créer un VPC.
Dans cet exemple, l’utilitaire va créer un VPC dans les zones AWS eu-west-2b et eu-west-2a et lui assigner la balise de nom MyEnterpriseVPC.
"NetworkStack": {
"StackName": "MyEnterpriseVPC", "AZs": "eu-west-2b,eu-west-2a", "CreateFlag":true
}
Le tableau suivant décrit chacun des paramètres que vous pouvez utiliser dans la section "NetworkStack" :
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "StackName" | Une balise de nom unique pour votre VPC pour vous permettre de l’identifier facilement. | Facultatif ; si elle n’est pas spécifiée, un VPC est créé avec la balise de nom arcgis-vpc. |
| "AZs" | Spécifier deux zones de disponibilité AWS pour le VPC. Les zones doivent se trouver dans la région que vous avez spécifiée dans le nœud "AWSCredentials". | Le paramètre "AZs" est requis si vous incluez le nœud "NetworkStack" dans votre fichier. |
| "CreateFlag" | Indique s’il faut créer (true) un VPC ou non (false). | Le paramètre "CreateFlag" est requis si vous incluez le nœud "NetworkStack" dans votre fichier. |
Fichiers ArcGIS Enterprise
"ArcGISEnterpriseFiles" contient des informations concernant la gestion des licences et les fichiers SSL dont l’utilitaire a besoin pour créer votre déploiement.
Ce qui suit est un exemple de section "ArcGISEnterpriseFiles" dans lequel tous les paramètres possibles sont spécifiés :
"ArcGISEnterpriseFiles": {
"DeploymentBucket": "clitesting", "PortalLicense": "E:\\AWS\\Testing\\Version10.6\\portal_2000_1000.prvc", "ServerLicense": "E:\\AWS\\Testing\\Version10.6\\Server_Ent_Adv_AllExt.prvc", "GeoAnalyticsLicense": "E:\\AWS\\Testing\\Version10.6\\Server_GeoAnalytics.prvc", "RasterAnalyticsLicense": "E:\\AWS\\Testing\\Version10.6\\Server_Image.prvc", "ImageHostingLicense": "E:\\AWS\\Testing\\Version10.6\\Server_Image.prvc", "GeoEventLicense": "E:\\AWS\\Testing\\Version10.6\\Server_GeoEvent.prvc", "SSLCertificateFile": "E:\\AWS\\Testing\\wildcard_webgistesting_net.pfx", "SSLCertPassword": "abc123"
}
Le tableau suivant contient une description de chaque paramètre pouvant être utilisé dans le nœud "ArcGISEnterpriseFiles" :
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "DeploymentBucket" | Le nom d’un paquet Amazon S3 dans lequel stocker les fichiers de licence ArcGIS (.prvc ou .epc) et les fichiers de certificats SSL (.pfx). L’outil vérifie s’il existe déjà un paquet S3 portant le nom spécifié dans cette région AWS. Si ce n’est pas le cas, l’utilitaire crée un paquet dans la région que vous avez spécifiée dans le nœud "AWSCredentials". | Facultatif ; si ce n’est pas spécifié, un paquet Amazon S3 est créé pour vous. |
| "PortalLicense" | Votre fichier de licence Portal for ArcGIS (.prvc ou .epc). Spécifie le chemin d’accès physique menant au fichier de licence sur votre disque local de façon à ce que l’utilitaire puisse le télécharger dans le paquet S3. | Requis si vous déployez ArcGIS Enterprise. |
| "ServerLicense" | Votre fichier de licence ArcGIS GIS Server (.prvc ou .epc) | Requis si vous déployez ArcGIS Enterprise ou un site ArcGIS GIS Server fédéré ou autonome. |
| "GeoAnalyticsLicense" | Votre fichier de licence ArcGIS GeoAnalytics Server (.prvc ou .epc) | Requis si vous déployez une instance ArcGIS GeoAnalytics Server. |
| "RasterAnalyticsLicense" | Votre fichier de licence ArcGIS Image Server (.prvc ou .epc) | Requis si vous déployez une instance ArcGIS Image Server fédérée ou autonome. |
| "ImageHostingLicense" | Votre fichier de licence ArcGIS Image Server (.prvc ou .epc) | Requis si vous déployez une instance ArcGIS Image Server fédérée ou autonome. |
| "GeoEventLicense" | Votre fichier de licence ArcGIS GeoEvent Server (.prvc ou .epc) | Requis si vous déployez une instance ArcGIS GeoEvent Server fédérée ou autonome. |
| "SSLCertificateFile" | Le fichier de certificat SSL émis pour le domaine de votre site. Spécifie le chemin d’accès physique menant au certificat SSL sur votre disque local de façon à ce que l’utilitaire puisse le télécharger dans le paquet S3. | Requis pour télécharger le certificat SSL. |
| "SSLCertPassword" | Le mot de passe du certificat SSL. | Requis pour télécharger le certificat SSL. |
Paramètres à utiliser dans les fichiers pour créer le déploiement
Pour créer un déploiement, vous devez fournir des informations concernant le logiciel et le matériel que vous souhaitez inclure dans le déploiement. Les paramètres sont regroupés dans les nœuds décrits dans les sections suivantes.
Informations concernant le déploiement
En haut du fichier, spécifiez le nom qui sera utilisé pour chacune des instances (machines) Amazon Elastic Cloud Compute (EC2) de votre déploiement, la version logicielle ArcGIS que vous souhaitez déployer (version 10.5 ou plus récente) et le système d'exploitation (Windows ou Ubuntu) à utiliser pour les instances EC2 que vous déployez. Tous ces paramètres sont requis.
"DeploymentDetails": {
"DeploymentName": "<name_to_append_to_machines_in_aws_deployment">,
"ArcGISVersion": "<10.6>",
"OperatingSystem": "<Windows | Ubuntu>"
}
Le "DeploymentName" doit commencer par un caractère alphanumérique, être composé uniquement de caractères alphanumériques et contenir au moins trois caractères.
Dans cet exemple, les noms de toutes les machines du déploiement commenceront par testservers. Les images virtuelles AMI Esri Ubuntu 10.6 seront utilisées pour le déploiement. "DeploymentDetails": {
"DeploymentName": "testservers", "ArcGISVersion": "10.6", "OperatingSystem": "Ubuntu"
}
Paramètres CloudFormation
Les paramètres requis par les modèles CloudFormation sont organisés sous les nœuds suivants :
- "Default" — Les paramètres définis ici s’appliquent à toutes les parties du déploiement. Les paramètres par défaut peuvent être omis pour les autres nœuds.
- "BaseEnterprise" — Les paramètres définis dans cette section s’appliquent uniquement au déploiement ArcGIS Enterprise de base.
- "GeoAnalytics" — Les paramètres définis dans cette section s’appliquent uniquement à un site ArcGIS GeoAnalytics Server fédéré.
- "RasterAnalytics" — Les paramètres définis dans cette section s’appliquent uniquement à des sites ArcGIS Image Server fédérés ou autonomes.
- "ImageHosting" : les paramètres définis dans cette section s’appliquent uniquement aux sites ArcGIS Image Server fédérés à utiliser comme serveur d’hébergement d’images du portail. Nouveautés de la version 10.6.1
- "Server" — Les paramètres définis dans cette section s’appliquent uniquement à des sites ArcGIS GIS Server fédérés ou autonomes.
- "GeoEvent" — Les paramètres définis dans cette section s’appliquent uniquement à un site ArcGIS GeoEvent Server fédéré ou autonome.
Remarque :
Vous devez inclure un nœud pour chaque partie du déploiement que vous souhaitez créer. Par exemple, si vous souhaitez créer un déploiement ArcGIS Enterprise de base, un site ArcGIS GeoAnalytics Server fédéré, et un site ArcGIS GIS Server fédéré, vous devez inclure les nœuds "BaseEnterprise", "GeoAnalytics", et "Server" dans votre fichier de configuration, et ces nœuds doivent contenir au moins un paramètre. Par exemple, même si vous définissez les paramètres "Federate" et "ServerLicenseFile" sous le nœud "Default", vous devez inclure au moins l’un des deux sous le nœud "Server" ; si vous ne le faites pas, l’utilitaire ne créera pas de site ArcGIS GIS Server fédéré.
Les paramètres VPC doivent être définis sous le nœud "Default". Vous pouvez utiliser les paramètres "VPCId", "Subnet1" et "Subnet2" pour définir votre VPC ou, si vous souhaitez réutiliser un VPC d’un déploiement existant créé avec cet outil ou un modèle Esri CloudFormation, vous pouvez à la place spécifier le nom du déploiement sous le paramètre "NetworkStackName". Vous trouverez ci-dessous les descriptions de ces paramètres :
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "VPCId" | Lorsque vous avez créé votre VPC, AWS lui a assigné un ID au format vpc-xxxxxxxx. Indiquez ici l’ID de votre VPC. Si vous utilisez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS pour préparer votre déploiement, cet ID est répertorié dans le fichier en sortie créé lorsque vous exécutez l’utilitaire à l’aide de la commande PREP. | Requise si vous ne spécifiez pas le paramètre "NetworkStackName". |
| "Subnet1" | L’ID de l’un des sous-réseaux de votre VPC. Si vous utilisez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS pour préparer votre déploiement, cet ID est répertorié dans le fichier en sortie créé lorsque vous exécutez l’utilitaire à l’aide de la commande PREP. | Requise si vous ne spécifiez pas le paramètre "NetworkStackName". |
| "Subnet2" | L’ID du second sous-réseau de votre VPC. Si vous utilisez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS pour préparer votre déploiement, cet ID est répertorié dans le fichier en sortie créé lorsque vous exécutez l’utilitaire à l’aide de la commande PREP. | Requise si vous ne spécifiez pas le paramètre "NetworkStackName". |
| "NetworkStackName" | La balise de nom assignée à un VPC existant. | Requise si vous ne spécifiez pas les paramètres "VPCId", "Subnet1", et "Subnet2". |
D’autres valeurs de paramètre définies sous le nœud "Default" s’appliquent à certains ou à tous les autres nœuds du fichier JSON. Esri vous recommande d’utiliser le nœud Default pour définir les paramètres et valeurs communs à plusieurs nœuds du déploiement. Ceci réduit la taille du fichier de configuration et évite la répétition de paramètres et de valeurs. Par exemple, si vous déployez une instance ArcGIS Enterprise de base et un site ArcGIS GeoEvent Server fédéré, spécifiez le paramètre "DeploymentBucket" sous le nœud "Default", puisque toutes les machines utiliseront le même paquet. De même, si vous utilisez un certificat SSL de caractère générique, spécifiez les paramètres "SSLCertificateFile" et "SSLCertPassword" sous le nœud "Default" pour les sites à utiliser.
Comme cela est indiqué dans l’exemple suivant, les paramètres "VPCId", "Subnet1", et "Subnet2" sont utilisés pour définir le VPC. La taille du lecteur de données et du lecteur racine ("DriveSizeRoot" et "DriveSizeData"), le paquet S3, le nom d'utilisateur et le mot de passe de l'administrateur, ainsi aue le mot de passe pour les services logiciels ("RunAsUserPassword") s'appliquent à l’ensemble des parties de ce déploiement. Puisque tous les sites ArcGIS Server du déploiement seront fédérés avec le portail, "Federate":true est également inclus sous le nœud "Default".
"CloudFormationParameters":{ "Default" :{
"VPCId": "vpc-b33fecd5", "Subnet1": "subnet-7a709d1c", "Subnet2": "subnet-26f0f76f", "DriveSizeRoot": "300",
"DriveSizeData": "400", "KeyName": "StackTest_Mine", "DBEngine": "none",
"DBInstanceClass": "db.m4.large", "DBAllocatedStorage": "200", "DeploymentBucket": "mydeployments", "SiteAdmin": "admin", "SiteAdminPassword": "changeit", "RunAsUserPassword": "Change@1234",
"PostInstallationScript": "none", "Federate":true }
}
Si vous définissez les valeurs de paramètres dans un nœud de déploiement spécifique, la valeur spécifiée dans ce nœud est celle qui sera utilisée pour cette partie du déploiement. Par exemple, si vous définissez le paramètre "InstanceType" pour les nœuds "BaseEnterprise" et "Default", la valeur "InstanceType" définie dans le nœud "BaseEnterprise" est utilisée pour les machines du déploiement ArcGIS Enterprise de base, mais la valeur "InstanceType" définie pour le nœud "Default" est utilisée pour les sites ArcGIS GeoAnalytics Server ArcGIS Server, ArcGIS Image Server, et ArcGIS GeoEvent Server que vous déployez en utilisant ce fichier JSON.
Paramètres pour instance ArcGIS Enterprise de base
Les valeurs de paramètre que vous spécifiez sous le nœud "BaseEnterprise" s’appliquent uniquement aux piles ArcGIS Enterprise créées à l’aide des modèles CloudFormation Esri qui déploient ArcGIS Enterprise. Vous pouvez utiliser l’un des paramètres suivants pour la portion ArcGIS Enterprise de base d’un déploiement :
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "DeploymentBucket" | Le nom d’un paquet Amazon S3 dans lequel vous avez placé vos fichiers de licence ArcGIS et les fichiers de certificats SSL (.pfx). | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DriveSizeRoot" | La taille (en Go) du lecteur C: ou du lecteur racine des machines ArcGIS Enterprise. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DriveSizeData" | La taille (en Go) du lecteur D: ou du lecteur de données des machines ArcGIS Enterprise. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "InstanceType" | Le type d’instance Amazon EC2 à utiliser pour la machine ArcGIS Enterprise. | Requis si vous déployez l’instance ArcGIS Enterprise de base sur une seule machine. (Définissez le paramètre "Type" sur "AllInOne".) |
| "FSInstanceType" | Le type d’instance Amazon EC2 à utiliser pour le serveur de fichiers. | Requis si vous créez un déploiement ArcGIS Enterprise haute disponibilité. (Définissez le paramètre "Type" sur "HA".) |
| "ASInstanceType" | Le type d’instance Amazon EC2 à utiliser pour le serveur d’hébergement. | Requis si vous créez un déploiement ArcGIS Enterprise haute disponibilité. (Définissez le paramètre "Type" sur "HA".) |
| "BDSInstanceType" | Le type d’instance Amazon EC2 à utiliser pour les machines de big data store spatio-temporel. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". Même si vous ne déployez pas au départ un big data store spatio-temporel, vous devez spécifier un type d’instance de façon à ce que la mise à l’échelle automatique soit configurée dans la pile. |
| "BDSInstances" | Le nombre d’instances EC2 à créer pour un big data store spatio-temporel. Vous pouvez indiquer "0" si vous ne souhaitez pas inclure un big data store spatio-temporel dans votre déploiement à ce stade. Autrement, indiquez le nombre d’instances souhaité. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "KeyName" | La paire de clés Amazon EC2 pour permettre l’accès à distance aux instances EC2. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "StoreType" | Le type d’emplacement de stockage pour le stockage de la configuration ArcGIS Server et le répertoire de contenu Portal for ArcGIS. Pour utiliser une machine EC2, définissez ce paramètre sur "FileSystem". Pour utiliser un paquet S3 pour le répertoire de contenu du portail et un paquet S3 et une table DynamoDB pour le répertoire de contenu du portail, définissez ce paramètre sur "CloudStore". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "ServerLicenseFile" | Le nom du fichier de licence ArcGIS GIS Server pour le serveur d'hébergement. Ce fichier doit être téléchargé dans le paquet S3 que vous avez spécifié pour le "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "PortalLicenseFile" | Le nom du fichier de licence Portal for ArcGIS. Ce fichier doit être téléchargé dans le paquet S3 que vous avez spécifié pour le "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteAdmin" | Le nom d’utilisateur du compte d’administrateur de site principal ArcGIS Server et du compte d’administrateur initial Portal for ArcGIS. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteAdminPassword" | Le mot de passe du compte d'administrateur de site. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteEIPAllocationID" | L’ID d’allocation de l’adresse IP élastique du VPC que vous avez spécifiée sous les paramètres CloudFormation "Default". | Requis si vous déployez l’instance ArcGIS Enterprise de base sur une seule machine. (Définissez le paramètre "Type" sur "AllInOne".) |
| "RunAsUserPassword" | Le mot de passe du compte utilisé pour exécuter les services Windows ArcGIS Server, Portal for ArcGIS et ArcGIS Data Store. Le nom de connexion est toujours ArcGIS. | Requis si vous déployez sur des machines Windows (définissez le paramètre "OperatingSystem" sous "DeploymentDetails" sur "Windows"), et que vous n’avez spécifié ce paramètre sous le nœud "Default". |
| "SSLCertificateFile" | Le fichier de certificat SSL émis pour le domaine de site. Il doit s’agir d’un fichier .pfx que vous avez téléchargé dans le paquet S3 que vous avez spécifié pour le "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SSLCertPassword" | Le mot de passe du certificat SSL. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteDomain" | Le nom de domaine de votre déploiement. Si vous utilisez AWS Route 53 pour gérer vos serveurs de nom de domaine et que par conséquent vous avez défini le paramètre "AWSR53ZoneId" sous les valeurs des paramètres DNS, vous pouvez spécifier un nom de sous-domaine. Si vous ne spécifiez pas de nom de sous-domaine, un nom de domaine basé sur la convention d’affectation de nom par défaut est utilisé. Si vous n’utilisez pas AWS Route 53 pour gérer vos serveurs de nom de domaine et n’avez pas défini le paramètre "AWSR53ZoneId", vous devez spécifier un nom de domaine complet pour le paramètre "SiteDomain". Si vous utilisez votre propre serveur DNS pour gérer votre nom de domaine au lieu d’utiliser AWS Route 53, vérifiez que le nom de domaine ("SiteDomain") est apparié à l’équilibreur de charges élastiques (Elastic Load Balancer) ou à l’adresse IP élastique dans votre DNS avant d’exécuter ArcGIS Enterprise Cloud Builder CLI for AWS, de façon à ce que le nom de domaine soit valide au moment de la fédération. Vous pouvez créer des équilibreurs de charges élastiques (à l'aide de la console de gestion AWS ou des modèles CloudFormation AWS Esri) ou des adresses IP élastiques (en utilisant la console de gestion AWS). | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "PostInstallationScript" | Le nom d’un fichier d’archive zip contenant un script de post-installation personnalisé ou si vous ne disposez pas de script personnalisé, définissez ce paramètre sur "NONE". Si vous utilisez un script de post-installation personnalisé, vous devez télécharger le fichier zip dans le paquet Amazon S3 que vous avez spécifié pour "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "TemplateURL" | Si vous souhaitez utiliser votre propre modèle CloudFormation pour ce déploiement à la place des modèles fournis par Esri, vous pouvez définir votre modèle. Fournissez une adresse URL HTTPS valide. | Facultatif |
| "Type" | Les valeurs possibles sont "AllInOne" pour déployer toutes les parties d’un déploiement sur une seule machine ou "HA" pour créer un déploiement haute disponibilité. | Obligatoire |
| "ELBName" | Spécifiez le nom d’un équilibreur de charges élastiques existant créé à l'aide des modèles CloudFormation AWS Esri, ou définissez ce paramètre sur "NEW_ELB" pour créer un nouvel équilibreur de charges élastiques et l’utiliser. Lorsque vous définissez "ELBName" sur "NEW_ELB", AWS attribue un nom à l‘équilibreur de charges qu’il crée. Vous devez saisir "NEW_ELB" en lettres majuscules, comme indiqué. | Requis si vous créez un déploiement ArcGIS Enterprise haute disponibilité (définissez le paramètre "Type" sur "HA"). |
Paramètres des sites ArcGIS GeoAnalytics Server, ArcGIS Image Server et ArcGIS GIS Server
Les valeurs des paramètres que vous spécifiez sous les nœuds "GeoAnalytics", "RasterAnalytics", "ImageHosting" et "Server" utilisent les modèles CloudFormation Esri qui lancent des sites ArcGIS Server fédérés ou autonomes. Notez que les sites ArcGIS GeoAnalytics Server doivent toujours être fédérés avec un portail ArcGIS Enterprise et que pour utiliser un site ArcGIS Image Server en tant que serveur d’analyse raster ou de serveur d’hébergement d’images, le site doit être fédéré avec un portail.
Lorsque vous créez des sites ArcGIS GeoAnalytics Server et ArcGIS Image Server fédérés, l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS configure ces sites comme étant vos serveurs GeoAnalytics d’analyse raster et d’hébergement d’images respectivement ; il n’est pas nécessaire de les configurer manuellement.
La table suivante répertorie tous les paramètres possibles que vous pouvez définir sous les nœuds "GeoAnalytics", "RasterAnalytics", "ImageHosting" et "Server".
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "ServerLicenseFile" | Le fichier .prvc ou .epc pour attribuer une licence à votre site ArcGIS GeoAnalytics Server, ArcGIS Image Server ou ArcGIS GIS Server. | Obligatoire |
| "CloudStoreS3BucketPath" | Le chemin du paquet est au format suivant <bucket_name>/<folder_name>. Lorsqu’il est utilisé sous le nœud "RasterAnalytics", l’utilitaire enregistre cet emplacement en tant que stockage raster du site. Lorsqu’il est utilisé sous d’autres nœuds, l’utilitaire enregistre l’emplacement spécifié en tant que stockage cloud. Vous devez spécifier l’emplacement dans le format indiqué : <bucket_name>/<folder_name>. Vérifiez que le paquet S3 existe et qu’il est accessible en utilisant les informations de connexion AWS que vous avez fournies sous le nœud "AWSCredentials". Si le <folder_name> que vous spécifiez n’existe pas dans le paquet, l’utilitaire le crée. | Requis pour le site ArcGIS Image Server que vous utilisez en tant que serveur d'analyse raster du portail. Ce paramètre est facultatif si vous créez un site ArcGIS Image Server autonome, un site ArcGIS GIS Server autonome, ou un site ArcGIS GIS Server fédéré. |
| "Federate" | Spécifie si le site sera fédéré (true) à votre déploiement ArcGIS Enterprise de base ou à un site autonome (false). Vous devez définir "Federate" sur true lors de la création d’un site ArcGIS GeoAnalytics Server. Si ce paramètre n’est pas spécifié dans le fichier de configuration du déploiement, la valeur par défaut est false. | Obligatoire |
| "DeploymentBucket" | Le nom du paquet S3 dans lequel vous placez vos fichiers de licence ArcGIS et les fichiers de certificats SSL (.pfx). | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DriveSizeRoot" | La taille (en Go) du lecteur C: ou du lecteur racine des machines ArcGIS GeoAnalytics Server, ArcGIS Image Server ou ArcGIS GIS Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DriveSizeData" | La taille (en Go) du lecteur D: ou du lecteur de données des machines ArcGIS GeoAnalytics Server, ArcGIS Image Server ou ArcGIS GIS Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "FSInstanceType" | Le type d’instance Amazon EC2 à utiliser pour le serveur de fichiers. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "ASInstanceType" | Le type d’instance Amazon EC2 à utiliser pour les machines ArcGIS GeoAnalytics Server, ArcGIS Image Server ou ArcGIS GIS Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SecondaryInstances" | Le nombre d’instances Amazon EC2 lancées par mise à l’échelle automatique. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". Remarque :Ce paramètre est requis pour les sites 10.6 uniquement. Il ne s’applique pas à la version 10.6.1. |
| "ASInstances" | Le nombre d’instances Amazon EC2 lancées par la mise à l’échelle automatique. Ce nombre doit être égal au nombre total de machines qui composent un site ArcGIS Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". Remarque :Ce paramètre s’applique aux sites 10.6.1 uniquement. |
| "KeyName" | La paire de clés Amazon EC2 pour permettre l’accès à distance aux instances EC2. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "StoreType" | Le type d’emplacement du stockage de la configuration du site ArcGIS Server. Pour utiliser une machine EC2, définissez ce paramètre sur "FileSystem". Pour utiliser un paquet S3 pour le répertoire de contenu du portail et un paquet S3 et une table DynamoDB pour le répertoire de contenu du portail, définissez ce paramètre sur "CloudStore". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteAdmin" | Le nom d’utilisateur de l’administrateur de site principal ArcGIS Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteAdminPassword" | Le mot de passe du compte d'administrateur de site. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "RunAsUserPassword" | Le mot de passe du compte utilisé pour exécuter le service Windows ArcGIS Server. Le nom de connexion est toujours ArcGIS. | Requis si vous déployez sur des machines Windows (définissez le paramètre "OperatingSystem" sous "DeploymentDetails" sur "Windows"), et que vous n'avez pas spécifié ce paramètre sous le nœud "Default". |
| "ELBName" | Spécifiez le nom d’un équilibreur de charges élastiques existant créé à l'aide des modèles CloudFormation AWS Esri, ou définissez ce paramètre sur "NEW_ELB" pour créer un nouvel équilibreur de charges élastiques et l’utiliser. Lorsque vous définissez "ELBName" sur "NEW_ELB", AWS attribue un nom à l‘équilibreur de charges qu’il crée. Vous devez saisir "NEW_ELB" en lettres majuscules, comme indiqué. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SSLCertificateARN" | L’Amazon Resource Name (ARN) du certificat SSL émis pour le domaine de site. | Requis que si vous n’utilisez pas un équilibreur de charges élastiques existant. |
| "SiteDomain" | Le nom de domaine de votre déploiement. Si vous utilisez AWS Route 53 pour gérer vos serveurs de nom de domaine et que par conséquent vous avez défini le paramètre "AWSR53ZoneId" sous les valeurs des paramètres DNS, vous pouvez spécifier un nom de sous-domaine. Si vous ne spécifiez pas de nom de sous-domaine, un nom de domaine basé sur la convention d’affectation de nom par défaut est utilisé. | Requis si vous utilisez votre propre serveur DNS pour gérer votre nom de domaine au lieu d’utiliser AWS Route 53. |
| "DBEngine" | Si vous déployez des instances Windows Amazon EC2, vous pouvez définir ce paramètre sur un des éléments suivants :
Si vous déployez des instances Amazon EC2 sous Ubuntu, vous pouvez définir ce paramètre sur "none" ou "postgres". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DBInstanceClass" | La classe d'instance d’une instance Amazon RDS. | Requis si vous n’avez pas spécifié ce paramètre sous le nœud "Default" et que vous définissez "DBEngine" sur "sqlserver-se" ou "postgres". |
| "DBAllocatedStorage" | La taille de l'espace de stockage alloué (in Go) d’une instance Amazon RDS. | Requis si vous n’avez pas spécifié ce paramètre sous le nœud "Default" et que vous définissez "DBEngine" sur "sqlserver-se" ou "postgres". |
| "PostInstallationScript" | Le nom d’un fichier d’archive zip contenant un script de post-installation personnalisé ou si vous ne disposez pas de script personnalisé, définissez ce paramètre sur "NONE". Si vous utilisez un script de post-installation personnalisé, vous devez télécharger le fichier zip dans le paquet Amazon S3 que vous avez spécifié pour "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "TemplateURL" | Si vous souhaitez utiliser votre propre modèle CloudFormation pour ce déploiement à la place des modèles fournis par Esri, vous pouvez définir votre modèle. Fournissez une adresse URL HTTPS valide. | Facultatif |
Paramètres du site ArcGIS GeoEvent Server
Les valeurs de paramètre que vous spécifiez sous le nœud "GeoEvent" utilisent le modèle CloudFormation ArcGIS GeoEvent Server Esri.
Le tableau suivant répertorie tous les paramètres possibles pouvant être définis sous le nœud "GeoEvent".
| Paramètre | Description | Requis ou facultatif ? |
|---|---|---|
| "ServerLicenseFile" | Le fichier .prvc ou .ecp pour attribuer une licence à votre site ArcGIS GeoEvent Server. | Obligatoire |
| "Federate" | Spécifie si le site sera fédéré (true) à votre déploiement ArcGIS Enterprise de base ou à un site autonome (false). Si ce paramètre n’est pas spécifié dans le fichier de configuration du déploiement, la valeur par défaut est false. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DeploymentBucket" | Le nom du paquet S3 dans lequel vous placez vos fichiers de licence ArcGIS et les fichiers de certificats SSL (.pfx). | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DriveSizeRoot" | La taille (en Go) du lecteur C: ou du lecteur racine des machines ArcGIS GeoEvent Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "DriveSizeData" | La taille (en Go) du lecteur D: ou du lecteur de données des machines ArcGIS GeoEvent Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "ASInstanceType" | Le type d’instance Amazon EC2 à utiliser pour les machines ArcGIS GeoEvent Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "FSInstanceType" | Le type d’instance Amazon EC2 à utiliser pour le serveur de fichiers. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". Remarque :Ce paramètre s’applique aux sites 10.6.1 uniquement. |
| "ELBName" | Spécifiez le nom d’un équilibreur de charges élastiques existant créé à l’aide du modèle CloudFormation AWS Esri ou définissez ce paramètre sur "NEW_ELB" pour créer et utiliser un nouvel équilibreur de charges élastiques. Lorsque vous définissez "ELBName" sur "NEW_ELB", AWS attribue un nom à l‘équilibreur de charges qu’il crée. Vous devez saisir "NEW_ELB" en lettres majuscules, comme indiqué. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". Remarque :Ce paramètre s’applique aux sites 10.6.1 uniquement. |
| "KeyName" | La paire de clés Amazon EC2 pour permettre l’accès à distance aux instances EC2. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteAdmin" | Le nom d’utilisateur de l’administrateur de site principal ArcGIS Server. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteAdminPassword" | Le mot de passe du compte d'administrateur de site. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "RunAsUserPassword" | Le mot de passe du compte utilisé pour exécuter le service Windows ArcGIS Server. Le nom de connexion est toujours ArcGIS. | Requis si vous déployez sur des machines Windows (définissez le paramètre "OperatingSystem" sous "DeploymentDetails" sur "Windows") et que vous n'avez pas spécifié ce paramètre sous le nœud "Default". |
| "SiteEIPAllocationID | L’ID d’allocation de l’adresse IP élastique de votre VPC au format eipalloc-<uniqueID>. | Requis pour les sites 10.6. Remarque :Ce paramètre est requis pour les sites 10.6 uniquement. Il ne s’applique pas à la version 10.6.1. |
| "SSLCertificateFile" | Le fichier de certificat SSL émis pour le domaine de site. Il doit s’agir d’un fichier .pfx que vous avez téléchargé dans le paquet S3 que vous avez spécifié pour le "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SSLCertPassword" | Le mot de passe du certificat SSL. | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "SiteDomain" | Le nom de domaine de votre déploiement. Si vous utilisez AWS Route 53 pour gérer vos serveurs de nom de domaine et que par conséquent vous avez défini le paramètre "AWSR53ZoneId" sous les valeurs des paramètres DNS, vous pouvez spécifier un nom de sous-domaine. Si vous ne spécifiez pas de nom de sous-domaine, un nom de domaine basé sur la convention d’affectation de nom par défaut est utilisé. | Requis si vous utilisez votre propre serveur DNS pour gérer votre nom de domaine au lieu d’utiliser AWS Route 53. |
| "PostInstallationScript" | Le nom d’un fichier d’archive zip contenant un script de post-installation personnalisé ou si vous ne disposez pas de script personnalisé, définissez ce paramètre sur "NONE". Si vous utilisez un script de post-installation personnalisé, vous devez télécharger le fichier zip dans le paquet S3 que vous avez spécifié pour "DeploymentBucket". | Requis si vous ne l'avez pas spécifié sous le nœud "Default". |
| "TemplateURL" | Si vous souhaitez utiliser votre propre modèle CloudFormation pour ce déploiement à la place des modèles fournis par Esri, vous pouvez définir votre modèle. Fournissez une adresse URL HTTPS valide. | Facultatif |
Paramètres DNS
Si vous utilisez AWS Route 53 pour gérer vos serveurs de noms de domaine (DNS), vous devez définir un ID de zone AWS Route 53 sous le nœud "DNSParameters". Lorsque vous utilisez l’utilitaire ArcGIS Enterprise Cloud Builder CLI for AWS, celui-ci met à jour le DNS pour apparier chaque nom de domaine ("SiteDomain") à l’équilibreur de charges élastiques (Elastic Load Balancer) ou à l’adresse IP élastique (Elastic IP address) appropriée.
Le paramètre est requis si vous utilisez AWS Route 53. Si vous n’utilisez pas AWS Route 53, vous pouvez laisser ce paramètre vide.
Dans cet exemple, la zone AWS Route 53 ZUJQ3S2DAL123 sera appariée à l’adresse IP élastique que vous avez spécifiée pour le paramètre "SiteDomain" du déploiement de base."DNSParameters":{ "AWSR53ZoneId": "ZUJQ3S2DAL123"
}
Vous avez un commentaire à formuler concernant cette rubrique ?