Когда вы используете 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 | Создает Amazon Virtual Private Cloud (VPC) в заданном регионе AWS. |
uploadlicensefile.json | Загружает лицензии ArcGIS Server и лицензию Portal for ArcGIS. Если вы хотите задать имя бакета Amazon Simple Storage Service (S3), добавьте параметр "DeploymentBucket" в раздел "ArcGISEnterpriseFiles"; иначе будет создан бакет с именем по умолчанию. |
uploadsslcert.json | Загружает сертификат SSL в указанный бакет Amazon S3 и импортирует его в AWS Certificate Manager. |
uploadlicenseandcert.json | Выгружает лицензии ArcGIS Server, лицензию Portal for ArcGIS и сертификат SSL в указанный бакет Amazon S3. Также импортирует сертификат SSL в AWS Certificate Manager. |
allprep.json | Создает VPC и выгружает лицензии ArcGIS Server, файл JSON 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, настроенный как сервер размещения изображений портала. |
baseenterpriseimagehostingrasterstore.json | Развертывает базовый ArcGIS Enterprise, а также интегрированный дополнительный сайт ArcGIS Image Server, настроенный как сервер размещения изображений портала. Можно также использовать этот файл для создания облачного хранилища в S3 и регистрации его в качестве хранилища растровых данных. |
standalonegeoevent.json | Развертывает автономный сайт ArcGIS GeoEvent Server. |
standaloneserver.json | Развертывает автономный сайт ArcGIS GIS Server. |
standaloneimageserver.json | Развертывает автономный сайт дополнительного модуля ArcGIS Image 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, в котором проводится развертывание. Регион должен быть одинаковым для всех компонентов развертывания.
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"AWSAccessKey" | Ключ доступа для учетной записи AWS. | Необходим, если не указан параметр "AWSProfileName". |
"AWSSecretKey" | Секретный ключ для учетной записи AWS. | Необходим, если не указан параметр "AWSProfileName". |
"AWSProfileName" | Имя профиля, настроенного для учетной записи AWS. | Необходим, если не указаны параметры "AWSAccessKey" и "AWSSecretKey". |
"AWSRegion" | Регион AWS, в котором будут созданы все части вашего развертывания. | Обязательный |
В этом примере учетные данные для авторизации - это ключ доступа и секретный ключ для учетной записи AWS. Экземпляры Amazon Elastic Compute Cloud (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 в зонах AWSeu-west-2b и eu-west-2a и назначает ему тег имени MyEnterpriseVPC.
"NetworkStack": {
"StackName": "MyEnterpriseVPC", "AZs": "eu-west-2b,eu-west-2a", "CreateFlag": true
}
В следующей таблице описывается каждый параметр, который можно использовать в разделе "NetworkStack":
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"StackName" | Уникальный тег имени для VPC, помогающий идентифицировать его. | Дополнительный, если не указан, VPC создается с тегом имени arcgis-vpc. |
"AZs" | Указывает две зоны доступности AWS для VPC. Зоны должны находиться в пределах региона, указанного в узле "AWSCredentials". | Параметр "AZs" является необходимым, если вы включили в ваш файл узел "NetworkStack". |
"CreateFlag" | Указывает, создается ли (true) VPC или нет (false). | Параметр "CreateFlag" является необходимым, если вы включили в ваш файл узел "NetworkStack". |
Файлы ArcGIS Enterprise
"ArcGISEnterpriseFiles" содержит информацию о файлах лицензии и SSL, которые необходимы утилите для создания развертывания.
Файлами лицензий ArcGIS Server могут быть файлы .prvc или .ecp. Лицензии Portal for ArcGIS находятся в файлах .json.
Файлы SSL должны быть .pfx.
Это пример раздела "ArcGISEnterpriseFiles" с заданными всеми возможными параметрами:
"ArcGISEnterpriseFiles": {
"DeploymentBucket": "cbtesting", "PortalLicense": "C:\\Licenses\\portal.json", "ServerLicense": "C:\\Licenses\\Server.prvc", "GeoAnalyticsLicense": "C:\\Licenses\\Server_GeoAnalytics.prvc", "ImageServerLicense": "C:\\Licenses\\Server_Image.prvc", "RasterAnalyticsLicense": "C:\\Licenses\\Server_Image.prvc", "ImageHostingLicense": " C:\\Licenses\\Server_Image.prvc ", "GeoEventLicense": " C:\\Licenses\\Server_GeoEvent.prvc.prvc", "SSLCertificateFile": "C:\\SSLCerts\\wildcard_webgistesting_net.pfx", "SSLCertPassword": "abc123"
}
В следующей таблице содержатся описания каждого параметра, который может использоваться в узле "ArcGISEnterpriseFiles":
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"DeploymentBucket" | Имя бакета Amazon S3, в котором хранятся файлы лицензий ArcGIS и файлы сертификатов SSL (.pfx). Инструмент проверяет, существует ли бакет S3 с указанным именем в этом регионе AWS. Если нет, утилита создает бакет в регионе, указанном в узле "AWSCredentials". | Дополнительный, если не задан, бакет Amazon S3 создается. |
"PortalLicense" | Файл лицензии Portal for ArcGIS (.json ). Указывает физический путь к файлу лицензии на локальном диске, чтобы утилита могла загрузить его в бакет S3. | Обязательный, если вы развертываете ArcGIS Enterprise. |
"ServerLicense" | Файл лицензии ArcGIS GIS Server. | Обязательный, если выполняется развертывание ArcGIS Enterprise или интегрированного, или автономного сайта ArcGIS GIS Server. |
"ImageServerLicense" | Файл лицензии расширения ArcGIS Image Server. | Обязательный, если выполняется развертывание интегрированного или автономного расширения ArcGIS Image Server. |
"GeoAnalyticsLicense" | Файл лицензии ArcGIS GeoAnalytics Server. | Требуется, если вы развертываете сайт ArcGIS GeoAnalytics Server. |
"RasterAnalyticsLicense" | Файл лицензии расширения ArcGIS Image Server. | Требуется, если вы развертываете интегрированный модуль ArcGIS Image Server. |
"ImageHostingLicense" | Файл лицензии расширения ArcGIS Image Server. | Требуется, если вы развертываете интегрированный модуль ArcGIS Image Server. |
"GeoEventLicense" | Файл лицензии ArcGIS GeoEvent Server. | Обязательный, если если выполняется развертывание интегрированного или автономного ArcGIS GeoEvent Server. |
"SSLCertificateFile" | Файл сертификата SSL, выданный домену сайта. Указывает физический путь к сертификату SSL на локальном диске, так что утилита может загрузить его в бакет S3. | Необходим для загрузки сертификата SSL. |
"SSLCertPassword" | Пароль для сертификата SSL. | Необходим для загрузки сертификата SSL. |
Параметры, используемые в файлах для создания развертывания
Для создания развертывания вы должны предоставить информацию о программном и техническом обеспечении, которое будет включено в развертывание. Параметры сгруппированы в узлах, описываемых в следующих разделах.
Подробная информация о развертывании
Вверху файла укажите имя, которое будет использоваться для каждого экземпляра (машины) Amazon Elastic Compute Cloud в развертывании, версию ПО ArcGIS, которую хотите развернуть (10.6 или новее), и операционную систему (Microsoft Windows или Ubuntu Server), используемую для экземпляров развертывания EC2. Все эти параметры являются обязательными.
"DeploymentDetails": {
"DeploymentName": "<name_to_append_to_machines_in_aws_deployment">,
"ArcGISVersion": "<10.6 | 10.6.1 | 10.7 | 10.7.1>",
"OperatingSystem": "<Windows | Ubuntu>"
}
"DeploymentName" должно начинаться с буквенного символа, может содержать только буквенные символы, его длина должна составлять не меньше 3 символов.
В этом примере имена всех машин в развертывании будут начинаться с testservers. 10.7.1 Esri Ubuntu AMI будут использоваться при развертывании. "DeploymentDetails": {
"DeploymentName": "testservers", "ArcGISVersion": "10.7.1", "OperatingSystem": "Ubuntu"
}
Параметры CloudFormation
Параметры, которые требуются для шаблонов CloudFormation, организованы под следующими узлами:
- "Default" – параметры, заданные здесь, применяются ко всем частям развертывания. Параметры, заданные по умолчанию, могут не учитываться в других узлах.
- "BaseEnterprise" – параметры, заданные в этом разделе, применяются только к базовому развертыванию ArcGIS Enterprise.
- "GeoAnalytics" – параметры, заданные в этом разделе, применяются только к интегрированному сайту ArcGIS GeoAnalytics Server.
- "RasterAnalytics" – параметры, заданные в этом разделе, применяются только к интегрированным или автономным сайтам расширения ArcGIS Image Server.
- "ImageHosting" - параметры, заданные в этом разделе, применимы только к интегрированным дополнительным сайтам ArcGIS Image Server, которые используются как серверы размещения изображений портала.
- "Server" – параметры, заданные в этом разделе, применяются только к к интегрированным или автономным сайтам ArcGIS GIS Server.
- "ImageServer" – параметры, заданные в этом разделе, применяются только к интегрированным или автономным сайтам расширения ArcGIS Image 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 из существующего развертывания, созданного при помощи этого инструмента или шаблона Esri CloudFormation, вместо этого можно указать имя развертывания в параметре "NetworkStackName". Ниже приводится описание этих параметров:
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"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"), бакет S3, имя пользователя и пароль администратора, пароль для сервисов ПО ("RunAsUserPassword") применяются ко всем частям этого развертывания. Поскольку все сайты ArcGIS Server в развертывании будут интегрированы на портале, "Federate": true также включен в узел "Default".
"CloudFormationParameters":{ "Default" :{
"VPCId": "vpc-b33fecd5", "Subnet1": "subnet-7a709d1c", "Subnet2": "subnet-26f0f76f", "DriveSizeRoot": "300",
"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 GIS Server, дополнительного модуля ArcGIS Image Server и сайтов ArcGIS GeoEvent Server, развертываемых с использованием файла JSON.
Параметры для базового ArcGIS Enterprise
Значения параметров, указанные в узле "BaseEnterprise", применяются только к стеку ArcGIS Enterprise, созданному с Esri шаблонами CloudFormation, развертывающими ArcGIS Enterprise. Для базовой части развертывания ArcGIS Enterprise можно использовать только следующие параметры:
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"DeploymentBucket" | Имя бакета Amazon S3, куда вы помещаете файлы лицензий ArcGIS и файлы сертификатов SSL (.pfx). | Обязательный, если он не задан в узле "Default". |
"DriveSizeRoot" | Размер (вГб) диска C: или корневого машин ArcGIS Enterprise. | Обязательный, если он не задан в узле "Default". |
"InstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для машины ArcGIS Enterprise. | Обязательный, если выполняется базовое развертывание ArcGIS Enterprise на отдельной машине. (Задайте параметр "Type" как "AllInOne".) |
"FSInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для файлового сервера. | Обязательный, если создается отказоустойчивое развертывание ArcGIS Enterprise. (Задайте параметр "Type" как "HA".) |
"ASInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для хост-сервера. | Обязательный, если создается отказоустойчивое развертывание ArcGIS Enterprise. (Задайте параметр "Type" как "HA".) |
"BDSInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для машин хранилища больших пространственно-временных данных. | Обязательный, если он не задан в узле "Default". Даже если вы изначально не развернули хранилище больших пространственно-временных данных, необходимо указать тип экземпляра, чтобы в стеке было настроено автоматическое масштабирование. |
"BDSInstances" | Число экземпляров EC2 для создания хранилища больших пространственно-временных данных. Можно указать "0", если вы не хотите в данный момент включать в развертывание хранилище больших пространственно-временных данных. В противном случае, укажите количество экземпляров по желанию. | Обязательный, если он не задан в узле "Default". |
"KeyName" | Пара ключей Amazon Elastic Compute Cloud, обеспечивающая доступ к экземплярам EC2. | Обязательный, если он не задан в узле "Default". |
"StoreType" | Тип местоположения хранилища конфигурации ArcGIS Server и ресурсной директории Portal for ArcGIS. Для использования машины EC2, задайте этот параметр как "FileSystem". Для использования бакета S3 для ресурсной директории портала, бакета S3 и таблицы Amazon DynamoDB ресурсной директории портала, задайте этот параметр как "CloudStore". | Обязательный, если он не задан в узле "Default". |
"ServerLicenseFile" | Имя файла лицензии ArcGIS GIS Server для хост-сервера. Этот файл должен быть загружен в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
"UserLicenseTypeID" | В файле лицензии Portal for ArcGIS, полученном от Esri, существуют идентификаторы (ID) для типов пользователей, лицензированных для работы на портале. Их поднабор доступен для использования первичным администратором. Идентификаторы в вашем файле могут быть разными, но обычные ID включают, в частности, creatorUT, GISProfessionalStdUT и editorUT. Эти ID чувствительны к регистру, поэтому убедитесь в том, что вы вводите их так, как это показано в вашем файле лицензии Portal for ArcGIS .json. | Необязательно. Если "UserLicenseTypeID" не указан, а файл лицензии портала содержит один совместимый тип пользователя, этот тип будет присвоен учетной записи первичного администратора. Если в файле лицензии содержится несколько совместимых типов пользователей, будет использован временный тип пользователя, а начальный администратор должен выбрать тип пользователя после входа на портал. |
"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" | Пароль учетной записи, примененной при запуске ArcGIS Server, Portal for ArcGIS, ArcGIS Data Store и сервисов Windows. Именем учетной записи всегда будет 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 AWS CloudFormation) или IP-адреса Elastic (используя AWS Management Console). | Обязательный, если он не задан в узле "Default". |
"PostInstallationScript" | Имя файла архива zip, содержащего пользовательский пост-инсталляционный скрипт, или, если такого скрипта нет, задает этот параметр как "NONE". Если вы применяете собственный пост-инсталляционный скрипт, необходимо загрузить файл zip в бакет Amazon S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
"TemplateURL" | Если для развертывания вы хотите использовать собственный шаблон CloudFormation вместо шаблонов, предоставляемых Esri, вы должны задать его. Предоставьте корректный HTTPS URL. | Это необязательно, но если этот параметр указывать, он должен быть задан в узле "BaseEnterprise", а не в узле "Default". |
"Type" | Для развертывания всех частей на одной машине допустимым значением является "AllInOne", для создания отказоустойчивого развертывания – "HA". | Обязательно. Этот параметр необходимо задать под узлом "BaseEnterprise", а не "Default". |
"ELBName" | Укажите имя существующего Elastic Load Balancer, который был создан с помощью шаблона CloudFormation Esri AWS, или укажите этот параметр как "NEW_ELB" для создания и использования нового Elastic Load Balancer. Если задать "ELBName" как "NEW_ELB", AWS назначит имя создаваемому балансировщику нагрузки. Вы должны напечатать "NEW_ELB" как показано, все заглавными буквами. | Обязательный, если создается отказоустойчивое развертывание ArcGIS Enterprise (задайте параметр "Type" как "HA"). |
Параметры ArcGIS GeoAnalytics Server, модуля ArcGIS Image Server и сайтов ArcGIS GIS Server и хост-серверов изображений и анализа растров.
Значение параметров, заданные вами под узлами "GeoAnalytics", "RasterAnalytics", "ImageHosting", "ImageServer" и "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", "ImageServer" и "Server".
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"ServerLicenseFile" | Файл .prvc или .epc для лицензирования сайта ArcGIS GeoAnalytics Server, ArcGIS Image Server или ArcGIS GIS Server. | Обязательный |
"CloudStoreS3BucketPath" | Путь к бакеты в формате <bucket_name>/<folder_name>. При использовании в узлах "RasterAnalytics" и "ImageHosting" утилита регистрирует это местоположение в качестве хранилища растров сайта. При использование в других узлах, утилита регистрирует определенное местоположение как хранилище в облаке. Необходимо указать местоположение в формате: <bucket_name>/<folder_name>. Проверьте, что бакет S3 существует и доступен, при помощи учетных данных AWS, предоставленных вами в узле "AWSCredentials". Если указанный вами <folder_name> не существует в бакете, утилита его создаст. | Необходим для сайта расширения ArcGIS Image Server, используемого как сервер растрового анализа на портале. Этот параметр необязателен, если вы создали автономный или интегрированный сайт модуля ArcGIS Image Server или ArcGIS GIS Server. Примечание:Если ваше развертывание включает узлы "RasterAnalytics" и "ImageHosting", и вы хотите использовать для них одно и то же хранилище, используйте одно и то же значение для параметра "CloudStoreS3BucketPath" в обоих узлах. |
"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". |
"FSInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для файлового сервера. | Обязательный, если он не задан в узле "Default". |
"ASInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для ArcGIS GeoAnalytics Server, дополнительного модуля ArcGIS Image Server или машин ArcGIS GIS Server. | Обязательный, если он не задан в узле "Default". |
"ASInstances" | Количество экземпляров Amazon Elastic Compute Cloud, запущенных AutoScaling. Это число должно быть равным общему число машин, которые составляют сайт ArcGIS Server. | Обязательный, если он не задан в узле "Default". |
"KeyName" | Пара ключей Amazon Elastic Compute Cloud, обеспечивающая доступ к экземплярам EC2. | Обязательный, если он не задан в узле "Default". |
"StoreType" | Тип размещения хранилища для хранилища конфигураций сайта ArcGIS Server. Для использования машины EC2, задайте этот параметр как "FileSystem". Для использования бакета S3 для ресурсной директории портала, бакета S3 и таблицы Amazon DynamoDB ресурсной директории портала, задайте этот параметр как "CloudStore". | Обязательный, если он не задан в узле "Default". |
"SiteAdmin" | Имя пользователя ArcGIS Server основного администратора сайта. | Обязательный, если он не задан в узле "Default". |
"SiteAdminPassword" | Пароль для учетной записи администратора сайта. | Обязательный, если он не задан в узле "Default". |
"RunAsUserPassword" | Пароль учетной записи, примененной при запуске служб ArcGIS Server Windows. Именем учетной записи всегда будет ArcGIS. | Обязательный, если выполняется развертывание на машинах Windows (задайте параметр "OperatingSystem" в "DeploymentDetails" как "Windows"), и вы не указали этот параметр в узле "Default". |
"ELBName" | Укажите имя существующего Elastic Load Balancer, который был создан с помощью шаблона CloudFormation Esri AWS, или укажите этот параметр как "NEW_ELB" для создания и использования нового Elastic Load Balancer. Если задать "ELBName" как "NEW_ELB", AWS назначит имя создаваемому балансировщику нагрузки. Вы должны напечатать "NEW_ELB" как показано, все заглавными буквами. | Обязательный, если он не задан в узле "Default". |
"SSLCertificateARN" | Amazon Resource Name (ARN) сертификата SSL, выданного домену сайта. | Необходим, только если вы не используете существующий Elastic Load Balancer. |
"SiteDomain" | Имя домена для развертывания. Если для управления серверами доменных имен (DNS) используется AWS Route 53 и, следовательно, параметр "AWSR53ZoneId" задан в настройках DNS, можно указать имя субдомена. Если не указано имя субдомена, будет использоваться имя домена, созданное на базе соглашения об именовании по умолчанию. | Необходимо, если вы используете сервер DNS для управления именем домена, вместо использования AWS Route 53. |
"DBEngine" | Если вы разворачиваете экземпляры Windows Amazon Elastic Compute Cloud, для этого параметра можно задать одно из следующего:
Если вы разворачиваете экземпляры Ubuntu Amazon Elastic Compute Cloud, для этого параметра можно задать "none", "aurora-postgresql" или "postgres". | Обязательный, если он не задан в узле "Default". |
"DBInstanceClass" | Класс экземпляра сервиса реляционной базы данных Amazon. | Обязательный, если этот параметр не указан в узле "Default", и вы задали "DBEngine" как "sqlserver-se", "postgres" или "aurora-postgresql". |
"DBAllocatedStorage" | Выделенный размер хранилища (в Гб) экземпляра сервиса реляционной базы данных Amazon. | Обязательный, если этот параметр не указан в узле "Default", и вы задали "DBEngine" как "sqlserver-se" или "postgres". |
"PostInstallationScript" | Имя файла архива zip, содержащего пользовательский пост-инсталляционный скрипт, или, если такого скрипта нет, задает этот параметр как "NONE". Если вы применяете собственный пост-инсталляционный скрипт, необходимо загрузить файл zip в бакет Amazon S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
"TemplateURL" | Если для развертывания вы хотите использовать собственный шаблон CloudFormation вместо шаблонов, предоставляемых Esri, вы должны задать его. Предоставьте корректный HTTPS URL. | Необязательный. Если этот параметр задается, он должен находиться в узле определенного сервера - "GeoAnalytics", "RasterAnalytics", "ImageHosting", "ImageHosting" или "Server", а не в узле "Default". |
Параметры для сайта ArcGIS GeoEvent Server
Значения параметров, указываемые в узле "GeoEvent", используют шаблонCloudFormation Esri ArcGIS GeoEvent Server.
В следующей таблице перечислены все возможные параметры, которые можно задать в узле "GeoEvent".
Параметр | Описание | Обязательный или дополнительный? |
---|---|---|
"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". |
"ASInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для машин ArcGIS GeoEvent Server. | Обязательный, если он не задан в узле "Default". |
"FSInstanceType" | Тип экземпляра Amazon Elastic Compute Cloud, используемого для файлового сервера. | Обязательный, если он не задан в узле "Default". |
"ELBName" | Укажите имя существующего Elastic Load Balancer, который был создан с помощью шаблона Esri AWS CloudFormation, или укажите этот параметр как "NEW_ELB" для создания и использования нового Elastic Load Balancer. Если задать "ELBName" как "NEW_ELB", AWS назначит имя создаваемому балансировщику нагрузки. Вы должны напечатать "NEW_ELB" как показано, все заглавными буквами. | Обязательный, если он не задан в узле "Default". |
"KeyName" | Пара ключей Amazon Elastic Compute Cloud, обеспечивающая доступ к экземплярам EC2. | Обязательный, если он не задан в узле "Default". |
"SiteAdmin" | Имя пользователя ArcGIS Server основного администратора сайта. | Обязательный, если он не задан в узле "Default". |
"SiteAdminPassword" | Пароль для учетной записи администратора сайта. | Обязательный, если он не задан в узле "Default". |
"RunAsUserPassword" | Пароль учетной записи, примененной при запуске служб ArcGIS Server Windows. Именем учетной записи всегда будет ArcGIS. | Обязательный, если выполняется развертывание на машинах Windows (задайте параметр "OperatingSystem" в "DeploymentDetails" как "Windows"), и вы не указали этот параметр в узле "Default". |
"SSLCertificateFile" | Файл сертификата SSL, выданный домену сайта. Это должен быть файл .pfx, который загружен в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
"SSLCertPassword" | Пароль для сертификата SSL. | Обязательный, если он не задан в узле "Default". |
"SiteDomain" | Имя домена для развертывания. Если для управления серверами доменных имен (DNS) используется AWS Route 53 и, следовательно, параметр "AWSR53ZoneId" задан в настройках DNS, можно указать имя субдомена. Если не указано имя субдомена, будет использоваться имя домена, созданное на базе соглашения об именовании по умолчанию. | Необходимо, если вы используете сервер DNS для управления именем домена, вместо использования AWS Route 53. |
"PostInstallationScript" | Имя файла архива zip, содержащего пользовательский пост-инсталляционный скрипт, или, если такого скрипта нет, задает этот параметр как "NONE". Если вы применяете собственный пост-инсталляционный скрипт, необходимо загрузить файл zip в бакет S3, указанный для "DeploymentBucket". | Обязательный, если он не задан в узле "Default". |
"TemplateURL" | Если для развертывания вы хотите использовать собственный шаблон CloudFormation вместо шаблонов, предоставляемых Esri, вы должны задать его. Предоставьте корректный HTTPS URL. | Необязательный. Этот параметр необходимо задать в узле "GeoEvent", а не "Default". |
Параметры 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"
}