При использовании ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) для подготовки и развертывания сайтов ArcGIS Enterprise и ArcGIS Server, вы предоставляете информацию о типе развертывания, указывая местоположение и имя файла JSON, содержащего необходимые настройки.
Несколько примеров файлов JSON входят в файл ArcGIS Enterprise Cloud Builder CLI for AWS, скачанный вами с My Esri. Примеры JSON представляют обычные развертывания. Здесь есть несколько файлов для подготовительных шагов, которые вы можете использовать при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS с командой PREP, и файлы, которые можно использовать при создании развертывания при помощи запуска утилиты ArcGIS Enterprise Cloud Builder CLI for AWS с командой CREATE.
В следующих двух таблицах описаны файлы примеров, предоставляемых с утилитой ArcGIS Enterprise Cloud Builder CLI for AWS.
| Файл примера подготовки | Описание |
|---|---|
| createnetworkvpc.json | Создает Virtual Private Cloud (VPC) в указанном вами регионе AWS. |
| uploadlicensefile.json | Загружает лицензии ArcGIS Server и лицензию Portal for ArcGIS. Если вы хотите указать имя для бакета Amazon Simple Storage Service (S3), добавьте параметр "DeploymentBucket" под разделом "ArcGISEnterpriseFiles"; в противном случае будет создан бакет с именем по умолчанию. |
| uploadsslcert.json | Загружает указанный вами сертификат SSL в бакет Amazon S3 и импортирует сертификат в SSL AWS Certificate Manager. |
| uploadlicenseandcert.json | Загружает лицензии ArcGIS Server, лицензию Portal for ArcGIS и сертификат SSL в указанный вами бакет Amazon S3. При этом сертификат SSL также импортируется в AWS Certificate Manager. |
| allprep.json | Создает VPC и загружает лицензии ArcGIS Server, лицензию Portal for ArcGIS и сертификат SSL в указанный вами бакет Amazon S3. При этом сертификат SSL также импортируется в AWS Certificate Manager. |
| Файл примера создания | Описание |
|---|---|
| baseenterpriseallinone.json | Развертывает базовый ArcGIS Enterprise на отдельной машине. |
| baseenterpriseha.json | Развертывает базовый ArcGIS Enterprise на двух машинах: основной и резервной. |
| baseenterpriseallinonewithra.json | Развертывает базовый ArcGIS Enterprise и интегрированный сайт расширения ArcGIS Image Server, настроенный как сервер растрового анализа на портале. |
| baseenterprisehawithga.json | Развертывает базовый ArcGIS Enterprise на двух машинах, а также интегрированный сайт ArcGIS GeoAnalytics Server, настроенный как сервер портала GeoAnalytics. |
| baseenterpriseimagehosting.json | Развертывает базовый ArcGIS Enterprise, а также дополнительный интегрированный сайт ArcGIS Image Server, настроенный как сервер размещения изображений портала. Эта опция появилась в 10.6.1. |
| baseenterpriseimagehostingrasterstore.json | Развертывает базовый ArcGIS Enterprise, а также интегрированный дополнительный сайт ArcGIS Image Server, настроенный как сервер размещения изображений портала. Можно также использовать этот файл для создания облачного хранилища в S3 и регистрации его в качестве хранилища растровых данных. Эта опция появилась в 10.6.1. |
| standalonegeoevent.json | Развертывает автономный сайт ArcGIS GeoEvent Server. |
| standaloneserver.json | Развертывает автономный сайт ArcGIS GIS Server. |
| standaloneserverwithexistingelb.json | Развертывает отдельный сайт ArcGIS GIS Server с помощью уже созданного Elastic Load Balancer. |
| completeArcGISenterprise.json | Позволяет развернуть базовый ArcGIS Enterprise высокой доступности и все возможные интегрированные сайты ArcGIS Server. |
Вы можете копировать и изменять эти файлы при помощи текстового редактора или создавать собственные файлы JSON. Если вы используете примеры, замените настройки примера значениями, свойственными вашему развертыванию. Также можно изменить то, какие параметры будут иметься в файлах примеров.
Параметры в файле JSON сгруппированы под заголовками разделов (узлов). Эти параметры и их группировка описаны далее в этой статье.
Учетные данные и регион AWS
Для подключения к Amazon Web Services команде необходимы ваши учетные данные AWS. Это могут быть Ключ доступа и Секретный ключ для вашей учетной записи AWS или имя профиля AWS для вашей учетной записи. Эти учетные данные необходимы всегда при запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS, они сгруппированы под разделом "AWSCredentials".
Также необходимо указать регион AWS, в котором вы будете выполнять развертывание. Регион должен быть одинаковым для всех компонентов развертывания.
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "AWSAccessKey" | Ключ доступа для вашей учетной записи AWS. | Необходим, если не указан параметр "AWSProfileName". |
| "AWSSecretKey" | Секретный ключ для учетной записи AWS. | Необходим, если не указан параметр "AWSProfileName". |
| "AWSProfileName" | Имя профиля, настроенное для вашей учетной записи AWS. | Необходим, если не указаны параметры "AWSAccessKey" и "AWSSecretKey". |
| "AWSRegion" | Регион AWS, где будут созданы все части развертывания. | Обязательное |
В этом примере учетными данными для авторизации являются ключ доступа и секрктный ключ для учетной записи AWS. Экземпляры EC2 будут запущены в регионе AWS eu-west-2."AWSCredentials": {
"AWSAccessKey": "AKIAINKWSK6MI4YCPA123",
"AWSSecretKey": "ABCD1E2fghIJkLmNOPQzZuXHlWHOPhMqrTmPEpV",
"AWSRegion": "eu-west-2"
}
В этом примере учетными данными для авторизации является имя профиля, настроенное для учетной записи AWS. Экземпляры EC2 будут запущены в регионе AWS us-west-1."AWSCredentials": {
"AWSProfileName": "betavpc", "AWSRegion": "us-west-1"
}
Параметры, используемые в файлах для подготовки развертывания
Перед созданием развертывания необходимо создать VPC и бакет развертывания S3 и загрузить сертификат SSL и лицензии ПО ArcGIS в бакет S3. Для выполнения этих шагов можно задать параметры в подготовительном файле .json.
Сетевой стек
Раздел "NetworkStack" является дополнительным в подготовительном файле, позволяющем создать VPC.
В этом примере утилита создаст VPC в зонах AWS eu-west-2b и eu-west-2a и назначает ему тег имени MyEnterpriseVPC.
"NetworkStack": {
"StackName": "MyEnterpriseVPC", "AZs": "eu-west-2b,eu-west-2a", "CreateFlag":true
}
В следующей таблице описывается каждый параметр, который можно использовать в разделе "NetworkStack":
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "StackName" | Уникальный тег имени для VPC, помогающий идентифицировать его. | Дополнительный, если не указан, VPC создается с тегом имени arcgis-vpc. |
| "AZs" | Указывает две зоны доступности AWS для VPC. Зоны должны находиться в пределах региона, указанного в узле "AWSCredentials". | Параметр "AZs" является необходимым, если вы включили в ваш файл узел "NetworkStack". |
| "CreateFlag" | Указывает, создается (true) VPC или нет (false). | Параметр "CreateFlag" является необходимым, если вы включили в ваш файл узел "NetworkStack". |
Файлы ArcGIS Enterprise
"ArcGISEnterpriseFiles" содержит информацию о файлах лицензии и SSL, которые необходимы утилите для создания развертывания.
Это пример раздела "ArcGISEnterpriseFiles" с заданными всеми возможными параметрами:
"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"
}
В следующей таблице содержатся описания каждого параметра, который может использоваться в узле "ArcGISEnterpriseFiles":
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "DeploymentBucket" | Имя бакета Amazon S3, в котором хранятся файлы лицензий ArcGIS (.prvc или .epc) файлы сертификатов SSL (.pfx). Инструмент проверяет, существует ли бакет S3 с указанным именем в этом регионе AWS. Если нет, утилита создает бакет в регионе, указанном в узле "AWSCredentials". | Дополнительный, если не задан, бакет Amazon S3 создается для вас. |
| "PortalLicense" | Файл лицензии Portal for ArcGIS (.prvc или .epc). Указывает физический путь к файлу лицензии на локальном диске, чтобы утилита могла загрузить его в бакет S3. | Обязательный, если вы развертываете ArcGIS Enterprise. |
| "ServerLicense" | Файл лицензии ArcGIS GIS Server (.prvc или .epc) | Обязательный, если выполняется развертывание ArcGIS Enterprise или интегрированного, или автономного сайта ArcGIS GIS Server. |
| "GeoAnalyticsLicense" | Файл лицензии ArcGIS GeoAnalytics Server (.prvc или .epc) | Обязательный, если выполняется развертывание ArcGIS GeoAnalytics Server. |
| "RasterAnalyticsLicense" | Файл лицензии расширения ArcGIS Image Server (.prvc или .epc) | Обязательный, если выполняется развертывание интегрированного или автономного расширения ArcGIS Image Server. |
| "ImageHostingLicense" | Файл лицензии расширения ArcGIS Image Server (.prvc или .epc) | Обязательный, если выполняется развертывание интегрированного или автономного расширения ArcGIS Image Server. |
| "GeoEventLicense" | Файл лицензии ArcGIS GeoEvent Server (.prvc или .epc) | Обязательный, если если выполняется развертывание интегрированного или автономного ArcGIS GeoEvent Server. |
| "SSLCertificateFile" | Файл сертификата SSL, выданный домену сайта. Указывает физический путь к сертификату SSL на локальном диске, так что утилита может загрузить его в бакет S3. | Необходим для загрузки сертификата SSL. |
| "SSLCertPassword" | Пароль для сертификата SSL. | Необходим для загрузки сертификата SSL. |
Параметры, используемые в файлах для создания развертывания
Для создания развертывания вы должны предоставить информацию о программном и техническом обеспечении, которое будет включено в развертывание. Параметры сгруппированы в узлах, описываемых в следующих разделах.
Подробная информация о развертывании
Вверху файла укажите имя, которое будет использоваться для каждого экземпляра (машины) Amazon Elastic Cloud Compute (EC2) в развертывании, версию ПО ArcGIS, которую хотите развернуть (10.5 или новее), и операционную систему (Windows или Ubuntu), используемую для экземпляров EC2 развертывания. Все эти параметры являются обязательными.
"DeploymentDetails": {
"DeploymentName": "<name_to_append_to_machines_in_aws_deployment">,
"ArcGISVersion": "<10.6>",
"OperatingSystem": "<Windows | Ubuntu>"
}
"DeploymentName" должно начинаться с буквенного символа, может содержать только буквенные символы, его длина должна составлять не меньше 3 символов.
В этом примере имена всех машин в развертывании будут начинаться с testservers. Для этого развертывания будет использоваться 10.6 Esri Ubuntu AMIs. "DeploymentDetails": {
"DeploymentName": "testservers", "ArcGISVersion": "10.6", "OperatingSystem": "Ubuntu"
}
Параметры CloudFormation
Параметры, необходимые для шаблонов CloudFormation, организованы в следующие узлы:
- "Default" – параметры, заданные здесь, применяются ко всем частям развертывания. Параметры, заданные по умолчанию, могут не учитываться в других узлах.
- "BaseEnterprise" – параметры, заданные в этом разделе, применяются только к базовому развертыванию ArcGIS Enterprise.
- "GeoAnalytics" – параметры, заданные в этом разделе, применяются только к интегрированному сайту ArcGIS GeoAnalytics Server.
- "RasterAnalytics" – параметры, заданные в этом разделе, применяются только к интегрированным или автономным сайтам расширения ArcGIS Image Server.
- "ImageHosting" - параметры, заданные в этом разделе, применимы только к интегрированным дополнительным сайтам ArcGIS Image Server, которые используются как серверы размещения изображений портала. Новое в 10.6.1.
- "Server" – параметры, заданные в этом разделе, применяются только к к интегрированным или автономным сайтам ArcGIS GIS Server.
- "GeoEvent" – параметры, заданные в этом разделе, применяются только к к интегрированному или автономному сайту ArcGIS GeoEvent Server.
Примечание:
Вы должны включить узел в каждую часть развертывания, которое хотите создать. Например, если вы хотите создать базовое развертывание ArcGIS Enterprise, интегрированный сайт ArcGIS GeoAnalytics Server и интегрированный сайт ArcGIS GIS Server, в файле конфигурации должны быть узлы "BaseEnterprise", "GeoAnalytics" и "Server", и они должны содержать хотя бы один параметр. Например, даже если вы задали параметры "Federate" и "ServerLicenseFile" в узле "Default", необходимо включить хотя бы один из них в узел "Server", если этого не сделать, утилита не создаст интегрированный сайт ArcGIS GIS Server.
Настройки VPC должны быть заданы в узле "Default". Для определения VPC можно использовать параметры "VPCId", "Subnet1" и "Subnet2" или, если вы хотите повторно использовать VPC из существующего развертывания, созданного при помощи этого инструмента или шаблона CloudFormation Esri, вместо этого можно указать имя развертывания в параметре "NetworkStackName". Ниже приводится описание этих параметров:
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "VPCId" | При создании VPC, AWS назначает ему ID в формате vpc-xxxxxxxx. Предоставляет здесь ID для VPC. Если вы используете утилиту ArcGIS Enterprise Cloud Builder CLI for AWS для подготовки развертывания, этот ID указан в выходном файле, созданном при запуске утилиты с командой PREP. | Необходим, если не указан параметр "NetworkStackName". |
| "Subnet1" | ID для одной из подсетей в VPC. Если вы используете утилиту ArcGIS Enterprise Cloud Builder CLI for AWS для подготовки развертывания, этот ID указан в выходном файле, созданном при запуске утилиты с командой PREP. | Необходим, если не указан параметр "NetworkStackName". |
| "Subnet2" | ID для второй подсети в VPC. Если вы используете утилиту ArcGIS Enterprise Cloud Builder CLI for AWS для подготовки развертывания, этот ID указан в выходном файле, созданном при запуске утилиты с командой PREP. | Необходим, если не указан параметр "NetworkStackName". |
| "NetworkStackName" | Тег имени, назначенный существующему VPC. | Обязательный, если не указаны параметры "VPCId", "Subnet1" и "Subnet2". |
Другие значения параметров, заданные в узле "Default", применимы к некоторым или ко всем оставшимся узлам в файле JSON. Esri рекомендует использовать узел Default для определения параметров и значений, являющихся общими для нескольких узлов в развертывании. Это сократит файл конфигурации и поможет избежать повторений параметров и значений. Например, при развертывании базового ArcGIS Enterprise и интегрированного ArcGIS GeoEvent Server, задайте параметр "DeploymentBucket" в узле "Default", чтобы все машины использовали одинаковый бакет. Аналогично, при наличии сертификата SSL шаблона, укажите параметры "SSLCertificateFile" и "SSLCertPassword" в узле "Default" для использования сайтами.
Как показано в следующем примере, параметры "VPCId", "Subnet1" и "Subnet2" используются для определения VPC. Размеры корневого диска и диска данных ("DriveSizeRoot" и "DriveSizeData"), бакет S3, имя пользователя и пароль администратора, пароль для сервисов ПО ("RunAsUserPassword") применяются ко всем частям этого развертывания. Поскольку все сайты ArcGIS Server в развертывании будут интегрированы на портале, "Federate":true также включен в узел "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 }
}
Если задать значения параметров в определенном узле развертывания, указанные здесь значения будут использоваться для этой части развертывания. Например, если задать параметр "InstanceType" в обоих узлах "BaseEnterprise" и "Default", значение "InstanceType", заданное в узле "BaseEnterprise" будет применено для машин базового развертывания ArcGIS Enterprise, а значение "InstanceType", заданное для узла "Default" будет применено для сайтов ArcGIS GeoAnalytics Server ArcGIS Server, ArcGIS Image Server и ArcGIS GeoEvent Server, развертываемых с использованием файла JSON.
Параметры для базового ArcGIS Enterprise
Значения параметров, указанные в узле "BaseEnterprise", применяются только к стеку ArcGIS Enterprise, созданному с Esri шаблонами CloudFormation, развертывающими ArcGIS Enterprise. Для базовой части развертывания ArcGIS Enterprise можно использовать только следующие параметры:
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "DeploymentBucket" | Имя бакета S3 Amazon, в котором размещены файлы лицензий ArcGIS и файлы сертификатов SSL (.pfx). | Обязательный, если он не задан в узле "Default". |
| "DriveSizeRoot" | Размер (вГб) диска C: или корневого машин ArcGIS Enterprise. | Обязательный, если он не задан в узле "Default". |
| "DriveSizeData" | Размер (вГб) диска D: или диска данных машин ArcGIS Enterprise. | Обязательный, если он не задан в узле "Default". |
| "InstanceType" | Тип экземпляра Amazon EC2, используемого для машины ArcGIS Enterprise. | Обязательный, если выполняется базовое развертывание ArcGIS Enterprise на отдельной машине. (Задайте параметр "Type" как "AllInOne".) |
| "FSInstanceType" | Тип экземпляра Amazon EC2, используемого для файлового сервера. | Обязательный, если создается отказоустойчивое развертывание ArcGIS Enterprise. (Задайте параметр "Type" как "HA".) |
| "ASInstanceType" | Тип экземпляра Amazon EC2, используемого для хост-сервера. | Обязательный, если создается отказоустойчивое развертывание ArcGIS Enterprise. (Задайте параметр "Type" как "HA".) |
| "BDSInstanceType" | Тип экземпляра Amazon EC2, используемого для машин хранилища больших пространственно-временных данных. | Обязательный, если он не задан в узле "Default". Даже если вы изначально не развернули хранилище больших пространственно-временных данных, необходимо указать тип экземпляра, чтобы в стеке было настроено автоматическое масштабирование. |
| "BDSInstances" | Число экземпляров EC2 для создания хранилища больших пространственно-временных данных. Можно указать "0", если вы не хотите в данный момент включать в развертывание хранилище больших пространственно-временных данных. В противном случае, укажите количество экземпляров по желанию. | Обязательный, если он не задан в узле "Default". |
| "KeyName" | Пара ключей Amazon EC2, обеспечивающая доступ к экземплярам EC2. | Обязательный, если он не задан в узле "Default". |
| "StoreType" | Тип местоположения хранилища конфигурации ArcGIS Server и ресурсной директории Portal for ArcGIS. Для использования машины EC2, задайте этот параметр как "FileSystem". Для использования бакета S3 для ресурсной директории портала и бакета S3 и таблицы DynamoDB для ресурсной директории портала, задайте этот параметр как "CloudStore". | Обязательный, если он не задан в узле "Default". |
| "ServerLicenseFile" | Имя файла лицензии ArcGIS GIS Server для хост-сервера. Этот файл должен быть загружен в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "PortalLicenseFile" | Имя файла лицензии Portal for ArcGIS. Этот файл должен быть загружен в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "SiteAdmin" | Имя пользователя учетной записи основного администратора сайта ArcGIS Server и первичной учетной записи администратора Portal for ArcGIS. | Обязательный, если он не задан в узле "Default". |
| "SiteAdminPassword" | Пароль для учетной записи администратора сайта. | Обязательный, если он не задан в узле "Default". |
| "SiteEIPAllocationID" | ID размещения адресов Elastic IP для VPC, указанного в узле "Default" параметров CloudFormation. | Обязательный, если выполняется базовое развертывание ArcGIS Enterprise на отдельной машине. (Задайте параметр "Type" как "AllInOne".) |
| "RunAsUserPassword" | Пароль учетной записи, примененной при запуске служб Windows ArcGIS Server, Portal for ArcGIS и ArcGIS Data Store. Именем учетной записи всегда будет ArcGIS. | Обязательный, если выполняется развертывание на машинах Windows (задайте параметр "OperatingSystem" в "DeploymentDetails" как "Windows"), и вы не указали этот параметр в узле "Default". |
| "SSLCertificateFile" | Файл сертификата SSL, выданный домену сайта. Это должен быть файл .pfx, который загружен в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "SSLCertPassword" | Пароль для сертификата SSL. | Обязательный, если он не задан в узле "Default". |
| "SiteDomain" | Имя домена для развертывания. Если для управления серверами доменных имен используется AWS Route 53 и, следовательно, параметр "AWSR53ZoneId" задан в настройках параметра DNS, можно указать имя субдомена. Если не указано имя субдомена, будет использоваться имя домена, созданное на базе соглашения об именовании по умолчанию. Если для управления серверами доменных имен не используется AWS Route 53, и параметр "AWSR53ZoneId" не задан, вы должны указать полное доменное имя для параметра "SiteDomain". Если для управления доменными именами вы используете собственный сервер DNS вместо AWS Route 53, проверьте, что доменное имя ("SiteDomain") сопоставлено в DNS с соответствующим Elastic Load Balancer или адресом Elastic IP до запуска ArcGIS Enterprise Cloud Builder CLI for AWS, чтобы доменное имя было корректным на момент интегрирования. Вы можете создать Elastic Load Balancers (при помощи AWS Management Console или Esri шаблонов CloudFormation AWS) или адреса Elastic IP (при помощи AWS Management Console). | Обязательный, если он не задан в узле "Default". |
| "PostInstallationScript" | Имя файла архива zip, содержащего пользовательский пост-инсталляционный скрипт, или, если такого скрипта нет, задает этот параметр как "NONE". Если вы применяете собственный пост-инсталляционный скрипт, необходимо загрузить файл zip в Amazon бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "TemplateURL" | Если для развертывания вы хотите использовать собственный шаблон CloudFormation вместо шаблонов, предоставляемых Esri, вы должны задать его. Предоставьте корректный HTTPS URL. | Дополнительное |
| "Type" | Для развертывания всех частей на одной машине допустимым значением является "AllInOne", для создания отказоустойчивого развертывания – "HA". | Обязательное |
| "ELBName" | Указывает имя существующего Elastic Load Balancer, который создан при помощи шаблонов CloudFormation AWS от Esri, или задает этот параметр как "NEW_ELB"чтобы создать и применить новый. Если задать "ELBName" как "NEW_ELB", AWS назначит имя создаваемому балансировщику нагрузки. Вы должны напечатать "NEW_ELB" как показано, все заглавными буквами. | Обязательный, если создается отказоустойчивое развертывание ArcGIS Enterprise (задайте параметр "Type" как "HA"). |
Параметры для сайтов ArcGIS GeoAnalytics Server, ArcGIS Image Server и ArcGIS GIS Server
Значения параметров, указанные в узлах "GeoAnalytics", "RasterAnalytics", "ImageHosting" и "Server" используют шаблоны Esri CloudFormation, которые запускают интегрированные или отдельные сайты ArcGIS Server. Обратите внимание, что сайты ArcGIS GeoAnalytics Server должны быть всегда интегрированы с порталом ArcGIS Enterprise и что при использовании дополнительного сайта ArcGIS Image Server в качестве сервера растрового анализа или сервера размещения изображений этот сайт должен быть интегрирован с порталом.
При создании интегрированного ArcGIS GeoAnalytics Server и дополнительного ArcGIS Image Server сайтов утилита ArcGIS Enterprise Cloud Builder CLI for AWS настраивает эти сайты в качестве серверов GeoAnalytics, растрового анализа и сервера размещения изображений соответственно; вам не нужно настраивать это вручную.
В таблице ниже перечислены возможные параметры, которые могут быть настроены в узлах "GeoAnalytics", "RasterAnalytics", "ImageHosting" и "Server".
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "ServerLicenseFile" | Файл .prvc или .epc для лицензирования сайта ArcGIS GeoAnalytics Server, ArcGIS Image Server или ArcGIS GIS Server. | Обязательное |
| "CloudStoreS3BucketPath" | Путь к бакеты в формате <bucket_name>/<folder_name>. При использование в узле "RasterAnalytics", утилита регистрирует это местоположение как хранилище растров сайта. При использование в других узлах, утилита регистрирует определенное местоположение как хранилище в облаке. Необходимо указать местоположение в формате: <bucket_name>/<folder_name>. Проверьте, что бакет S3 существует и доступен, при помощи учетных данных AWS, предоставленных вами в узле "AWSCredentials". Если указанный вами <folder_name> не существует в бакете, утилита его создаст. | Необходим для сайта расширения ArcGIS Image Server, используемого как сервер растрового анализа на портале. Этот параметр является дополнительным, если вы создаете автономный сайт ArcGIS Image Server, автономный сайт ArcGIS GIS Server или интегрированный сайт ArcGIS GIS Server. |
| "Federate" | Указывает, будет ли сайт интегрирован (true) с базовым развертыванием ArcGIS Enterprise или будет автономным сайтом (false). Необходимо задать "Federate" как true при создании сайта ArcGIS GeoAnalytics Server. Если вы не указали этот параметр в файл конфигурации развертывания, значением по умолчанию будет false. | Обязательное |
| "DeploymentBucket" | Имя бакета S3, куда вы помещаете файлы лицензий ArcGIS и файлы сертификатов SSL (.pfx). | Обязательный, если он не указан в узле "Default". |
| "DriveSizeRoot" | Размер (вГб) диска C: или корневого для машин ArcGIS GeoAnalytics Server, ArcGIS Image Server или ArcGIS GIS Server. | Обязательный, если он не задан в узле "Default". |
| "DriveSizeData" | Размер (вГб) диска D: или диска данных для машин ArcGIS GeoAnalytics Server, ArcGIS Image Server или ArcGIS GIS Server. | Обязательный, если он не задан в узле "Default". |
| "FSInstanceType" | Тип экземпляра Amazon EC2, используемого для файлового сервера. | Обязательный, если он не задан в узле "Default". |
| "ASInstanceType" | Тип экземпляра Amazon EC2, используемого для машин ArcGIS GeoAnalytics Server, ArcGIS Image Server или ArcGIS GIS Server. | Обязательный, если он не задан в узле "Default". |
| "SecondaryInstances" | Количество вторичных экземпляров Amazon EC2, вызываемых AutoScaling. | Обязательный, если он не задан в узле "Default". Примечание:Этот параметр является обязательным только для сайтов 10.6. Это неприменимо для 10.6.1. |
| "ASInstances" | Количество экземпляров Amazon EC2, запущенных AutoScaling. Это число должно быть равным общему число машин, которые составляют сайт ArcGIS Server. | Обязательный, если он не задан в узле "Default". Примечание:Этот параметр применим только для сайтов 10.6.1. |
| "KeyName" | Пара ключей Amazon EC2, обеспечивающая доступ к экземплярам EC2. | Обязательный, если он не задан в узле "Default". |
| "StoreType" | Тип размещения хранилища для хранилища конфигураций сайта ArcGIS Server. Для использования машины EC2, задайте этот параметр как "FileSystem". Для использования бакета S3 для ресурсной директории портала и бакета S3 и таблицы DynamoDB для ресурсной директории портала, задайте этот параметр как "CloudStore". | Обязательный, если он не задан в узле "Default". |
| "SiteAdmin" | Имя пользователя ArcGIS Server основного администратора сайта. | Обязательный, если он не задан в узле "Default". |
| "SiteAdminPassword" | Пароль для учетной записи администратора сайта. | Обязательный, если он не задан в узле "Default". |
| "RunAsUserPassword" | Пароль учетной записи, примененной при запуске служб Windows ArcGIS Server. Именем учетной записи всегда будет ArcGIS. | Обязательный, если выполняется развертывание на машинах Windows (задайте параметр "OperatingSystem" в "DeploymentDetails" как "Windows"), и вы не указали этот параметр в узле "Default". |
| "ELBName" | Указывает имя существующего Elastic Load Balancer, который создан при помощи шаблонов CloudFormation AWS от Esri, или задает этот параметр как "NEW_ELB"чтобы создать и применить новый. Если задать "ELBName" как "NEW_ELB", AWS назначит имя создаваемому балансировщику нагрузки. Вы должны напечатать "NEW_ELB" как показано, все заглавными буквами. | Обязательный, если он не задан в узле "Default". |
| "SSLCertificateARN" | Amazon Resource Name (ARN) сертификата SSL, выданного домену сайта. | Необходим, только если вы не используете существующий Elastic Load Balancer. |
| "SiteDomain" | Имя домена для развертывания. Если для управления серверами доменных имен используется AWS Route 53 и, следовательно, параметр "AWSR53ZoneId" задан в настройках параметра DNS, можно указать имя субдомена. Если не указано имя субдомена, будет использоваться имя домена, созданное на базе соглашения об именовании по умолчанию. | Необходимо, если вы используете сервер DNS для управления именем домена, отличным от использования AWS Route 53. |
| "DBEngine" | Если вы разворачиваете экземпляры Windows Amazon EC2, для этого параметра можно задать одно из следующего:
Если выполняется развертывание экземпляров Ubuntu Amazon EC2, можно задать этот параметр как "none" или "postgres". | Обязательный, если он не задан в узле "Default". |
| "DBInstanceClass" | Класс для экземпляра Amazon RDS. | Обязательный, если этот параметр не указан в узле "Default", и вы задали "DBEngine" как "sqlserver-se" или "postgres". |
| "DBAllocatedStorage" | Выделенный размер хранилища (в Гб) экземпляра Amazon RDS. | Обязательный, если этот параметр не указан в узле "Default", и вы задали "DBEngine" как "sqlserver-se" или "postgres". |
| "PostInstallationScript" | Имя файла архива zip, содержащего пользовательский пост-инсталляционный скрипт, или, если такого скрипта нет, задает этот параметр как "NONE". Если вы применяете собственный пост-инсталляционный скрипт, необходимо загрузить файл zip в Amazon бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "TemplateURL" | Если для развертывания вы хотите использовать собственный шаблон CloudFormation вместо шаблонов, предоставляемых Esri, вы должны задать его. Предоставьте корректный HTTPS URL. | Дополнительное |
Параметры для сайта ArcGIS GeoEvent Server
Значения параметров, указываемые в узле "GeoEvent", используют шаблонCloudFormation Esri ArcGIS GeoEvent Server.
В следующей таблице перечислены все возможные параметры, которые можно задать в узле "GeoEvent".
| Parameter | Описание | Обязательный или дополнительный? |
|---|---|---|
| "ServerLicenseFile" | Файл .prvc или .ecp для лицензирования сайта ArcGIS GeoEvent Server. | Обязательное |
| "Federate" | Указывает, будет ли сайт интегрирован (true) с базовым развертыванием ArcGIS Enterprise или будет автономным сайтом (false). Если вы не указали этот параметр в файл конфигурации развертывания, значением по умолчанию будет false. | Обязательный, если он не задан в узле "Default". |
| "DeploymentBucket" | Имя бакета S3, куда вы помещаете файлы лицензий ArcGIS и файлы сертификатов SSL (.pfx). | Обязательный, если он не указан в узле "Default". |
| "DriveSizeRoot" | Размер (вГб) диска C: или корневого машин ArcGIS GeoEvent Server. | Обязательный, если он не задан в узле "Default". |
| "DriveSizeData" | Размер (вГб) диска D: или диска данных машин ArcGIS GeoEvent Server. | Обязательный, если он не задан в узле "Default". |
| "ASInstanceType" | Тип экземпляра Amazon EC2, используемого для машин ArcGIS GeoEvent Server. | Обязательный, если он не задан в узле "Default". |
| "FSInstanceType" | Тип экземпляра Amazon EC2, используемого для файлового сервера. | Обязательный, если он не задан в узле "Default". Примечание:Этот параметр применим только для сайтов 10.6.1. |
| "ELBName" | Укажите имя существующего Elastic Load Balancer, который был создан с помощью шаблона Esri AWS CloudFormation, или укажите этот параметр как "NEW_ELB" для создания и использования нового Elastic Load Balancer. Если задать "ELBName" как "NEW_ELB", AWS назначит имя создаваемому балансировщику нагрузки. Вы должны напечатать "NEW_ELB" как показано, все заглавными буквами. | Обязательный, если он не задан в узле "Default". Примечание:Этот параметр применим только для сайтов 10.6.1. |
| "KeyName" | Пара ключей Amazon EC2, обеспечивающая доступ к экземплярам EC2. | Обязательный, если он не задан в узле "Default". |
| "SiteAdmin" | Имя пользователя ArcGIS Server основного администратора сайта. | Обязательный, если он не задан в узле "Default". |
| "SiteAdminPassword" | Пароль для учетной записи администратора сайта. | Обязательный, если он не задан в узле "Default". |
| "RunAsUserPassword" | Пароль учетной записи, примененной при запуске служб Windows ArcGIS Server. Именем учетной записи всегда будет ArcGIS. | Обязательный, если выполняется развертывание на машинах Windows (задайте параметр "OperatingSystem" в "DeploymentDetails" как "Windows"), и вы не указали этот параметр в узле "Default". |
| "SiteEIPAllocationID | ID размещения адресов Elastic IP для VPC в формате eipalloc-<uniqueID>. | Необходимо для сайтов 10.6. Примечание:Этот параметр является обязательным только для сайтов 10.6. Это неприменимо для 10.6.1. |
| "SSLCertificateFile" | Файл сертификата SSL, выданный домену сайта. Это должен быть файл .pfx, который загружен в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "SSLCertPassword" | Пароль для сертификата SSL. | Обязательный, если он не задан в узле "Default". |
| "SiteDomain" | Имя домена для развертывания. Если для управления серверами доменных имен используется AWS Route 53 и, следовательно, параметр "AWSR53ZoneId" задан в настройках параметра DNS, можно указать имя субдомена. Если не указано имя субдомена, будет использоваться имя домена, созданное на базе соглашения об именовании по умолчанию. | Необходимо, если вы используете сервер DNS для управления именем домена, отличным от использования AWS Route 53. |
| "PostInstallationScript" | Имя файла архива zip, содержащего пользовательский пост-инсталляционный скрипт, или, если такого скрипта нет, задает этот параметр как "NONE". Если вы применяете собственный пост-инсталляционный скрипт, необходимо загрузить файл zip в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
| "TemplateURL" | Если для развертывания вы хотите использовать собственный шаблон CloudFormation вместо шаблонов, предоставляемых Esri, вы должны задать его. Предоставьте корректный HTTPS URL. | Дополнительное |
Параметры DNS
Если для управления серверами доменных имен (DNS) используется AWS Route 53, необходимо задать id зоны AWS Route 53 в узле "DNSParameters". При запуске утилиты ArcGIS Enterprise Cloud Builder CLI for AWS она обновит DNS, чтобы сопоставить каждое доменное имя ("SiteDomain") с соответствующим Elastic Load Balancer (ELB) или адресом Elastic IP (EIP).
Параметр необходим, если вы используете AWS Route 53. Если вы не используете AWS Route 53, можно оставить этот параметр пустым.
В этом примере зона ZUJQ3S2DAL123 AWS Route 53 будет сопоставлена с адресом Elastic IP, указанным для параметра "SiteDomain" базового развертывания."DNSParameters":{ "AWSR53ZoneId": "ZUJQ3S2DAL123"
}