Шаблон Esri arcgis-datastore-cluster.template.json Amazon Web Services (AWS) CloudFormation создает хранилище пространственно-временных больших данных ArcGIS Data Store на нескольких экземплярах Amazon Elastic Compute Cloud (EC2). Использование кластера экземпляров позволяет масштабировать хранилище данных в соответствии с требованиями к хранилищу.
Этот шаблон выполняет настройку экземпляров ArcGIS Data Store в группе AWS Auto Scaling (Автомасштабирование), у которой есть такие преимущества, как планирование емкости на основе конкретных критериев, лучшая отказоустойчивость, доступность и оптимизированное управление затратами.
Когда вы создаете кластер хранилища больших пространственно-временных данных с помощью этого шаблона, всем компьютерам назначаются роли данных и координатора. Чтобы развернуть кластер, содержащий отдельные компьютеры для ролей данных и координатора, см. раздел Развертывание кластера хранилища больших пространственно-временных данных ArcGIS Data Store с отдельными ролями с помощью CloudFormation.
Подсказка:
Используйте этот шаблон как часть создания развертывания ArcGIS Enterprise, как это описано в статьте Развертывание компонентов ArcGIS Enterprise на отдельных машинах с помощью CloudFormation.При использовании этого шаблона у вас есть следующие опции хранения резервных копий:
- Хранить файлы резервных копий в Amazon Simple Storage Service (S3).
- Хранить файлы резервных копий на отдельном файловом сервере (экземпляр EC2).
На следующей схеме архитектуры представлен пример ресурсов, которые создаются при использовании этого шаблона для создания хранилища пространственно-временных больших данных в AWS:
На рисунке выше показаны резервные копии в бакете S3. Автоматические резервные копии могут быть созданы в бакете S3 или на файловом сервере EC2.
Лицензия:
Определенные значки в схеме используются с разрешения Amazon Web Services.
Предварительные условия
Предварительные требования можно сгруппировать по элементам - таким как файлы и учетные записи, которые вы должны получить, а также по задачам, которые вы должны выполнить перед запуском шаблона CloudFormation.
Обязательные элементы
Перед запуском этого шаблона у вас должно быть следующее:
- Учетная запись Amazon Web Services.
У учетной записи должен быть доступ к базовым сервисам AWS, таким как CloudFormation, Amazon Elastic Compute Cloud (EC2), Amazon Virtual Private Cloud (VPC), Amazon Simple Storage Service (S3), Systems Manager, Amazon CloudWatch, Lambda, AWS Identity and Access Management (IAM), Amazon DynamoDB, Secrets Manager, AWS Certificate Manager и Amazon Relational Database Service (RDS).
- Если вы создаете развертывание на экземплярах Ubuntu EC2 в AWS GovCloud, вам нужен AMI ID. Если вы хотите использовать базовые канонические Ubuntu AMI, следуйте инструкциям в шаблонах Esri Amazon Web Services CloudFormation для идентификации ID.
- Amazon Virtual Private Cloud (VPC) и подсети.
Вы можете использовать один из следующих шаблонов CloudFormation для создания VPC: VPC с двумя общедоступными подсетями или VPC или двумя общедоступными и частными подсетями с NAT Gateway.
- Шаблон arcgis-datastore-cluster.template.json CloudFormation.
Обязательные задачи
Перед запуском этого шаблона вам необходимо выполнить следующие задачи:
- У вас должен быть сайт ArcGIS GIS Server, который будет использоваться в качестве хост-сервера для портала ArcGIS Enterprise. Убедитесь, что у сайта еще нет такого же типа ArcGIS Data Store, зарегистрированного на нем, как тот, который вы будете создавать с этим шаблоном.
Вы можете использовать шаблон сайта ArcGIS Server на одном компьютере или шаблон сайта ArcGIS Server на нескольких компьютерах для создания этого сайта.
- Настройте пароли в AWS Secrets Manager (не обязательно, но рекомендуется).
Вы можете настроить пароли для учетных записей, таких как имя пользователя администратора сайта и пароль пользователя Windows arcgis в AWS Secrets Manager. При этом вам будет предоставлено секретное Amazon Resource Name (ARN). Используйте ARN вместо пароля в параметрах шаблона при запуске стека. Если вы не используете AWS Secrets Manager для хранения паролей, вы должны ввести пароли в виде простого текста в параметр шаблона при запуске стека.
Примечание:
При создании секретного ARN в AWS Secrets Manager для пароля, который будет использоваться в шаблонах Esri CloudFormation, вы должны использовать секретный тип Другие типы секретов и опцию Простой текст. Более подробно о создании Amazon Resource Name для паролей см. AWS CloudFormation и ArcGIS.
- Если вы собираетесь использовать общий файловый сервер для нескольких системных каталогов в рамках развертывания, запустите шаблон для создания экземпляра EC2 перед запуском этого стека.
Подсказка:
По умолчанию CloudFormation удаляет частично созданные ресурсы в случае неудачного создания стека. Это удобно, потому что он удаляет неиспользуемые развертывания из вашей учетной записи, но это может затруднить выявление проблем. Чтобы получить стек в состоянии неудачи, отключите опцию создания стека Rollback on failure CloudFormation перед его запуском. Подробнее см. Настройка опций AWS CloudFormation в справке AWS.
Параметры
В следующих таблицах описываются параметры, используемые в этом шаблоне CloudFormation. Таблицы сгруппированы по типу параметра.
Amazon EC2 Configuration
| Имя параметра | Обязательно или нет | Описание параметра |
|---|---|---|
Platform Type | Обязательный | Выберите платформу операционной системы. Поддерживаются следующие типы:
Информацию о конкретных версиях операционной системы см. в разделе Операционные системы, поддерживаемые при использовании CloudFormation для развертывания ArcGIS в AWS. |
EC2 Instance AMI ID | Дополнительный | Вы можете оставить значение этого параметра пустым. Если вы это сделаете, в шаблонах CloudFormation будет использоваться последний ID Amazon Machine Image (AMI) для Microsoft Windows Server 2022 или Ubuntu Server 22.04 LTS, в зависимости от типа выбранной вами платформы. Примечание:Вы не можете оставить этот параметр пустым, если вы выполняете развертывание в AWS GovCloud на платформе Linux. См. шаблоны Esri Amazon Web Services CloudFormation для получения инструкции по поиску ID для базы Ubuntu AMI из Canonical. Если вы выполняете развертывание в поддерживаемой операционной системе Linux, отличной от Ubuntu, вы можете найти ID AMI с помощью AWS Management Console. Чтобы использовать пользовательский AMI, введите идентификатор AMI одним из следующих способов:
Если вы применяете пользовательский AMI, убедитесь, что он соответствует следующим требованиям:
|
EC2 Instance Keypair Name | Обязательный | Выберите имя пары ключей EC2, чтобы разрешить удаленный доступ к экземплярам EC2. |
Elastic IP Address Allocation ID | Дополнительный | Введите ID размещения адресов Elastic IP (в формате eipalloc-XXXXXXXX. Вам понадобится эластичный IP-адрес, чтобы сопоставить доменное имя сайта с эластичным IP-адресом и получить доступ к экземпляру EC2 через RDP/SSH из-за пределов среды AWS. Оставьте этот параметр пустым, если вы не хотите назначать экземпляру EC2 эластичный IP-адрес. |
Amazon VPC Configuration
| Имя параметра | Обязательно или нет | Описание параметра |
|---|---|---|
VPC ID | Обязательный | Выберите идентификатор VPC. Примечание:Это должен быть тот же VPC, что и для сайта ArcGIS GIS Server, на котором вы добавляете это хранилище данных. |
Subnet ID 1 | Обязательный | Выберите идентификатор подсети. Выбранный идентификатор подсети должен находиться в VPC, выбранном ранее. Если вы использовали шаблон Esri CloudFormation для создания VPC, вы можете получить идентификатор подсети из выходных параметров этого шаблона. |
Subnet ID 2 | Обязательный | Выберите идентификатор второй подсети. Это должен быть идентификатор подсети, отличный от используемого для параметра Subnet ID 1. Выбранный идентификатор подсети должен находиться в VPC, указанном для этого развертывания. Если вы использовали шаблон Esri CloudFormation для создания VPC, вы можете получить идентификатор подсети из выходных параметров этого шаблона. |
ArcGIS Server Configuration
| Имя параметра | Обязательно или нет | Описание параметра |
|---|---|---|
Site Administrator User Name | Обязательный | Укажите имя пользователя основного администратора сайта ArcGIS Server сайта ArcGIS GIS Server, который будет использоваться в качестве хост-сервера портала. |
Site Administrator User Password | Обязательный | Укажите пароль основного администратора сайта ArcGIS Server. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager. Более подробно о создании Amazon Resource Name для паролей см. AWS CloudFormation и ArcGIS. Предоставленный вами пароль или секретный идентификатор должен совпадать с паролем или секретным идентификатором существующего основного администратора сайта. |
ArcGIS Server EC2 Instance ID | Обязательный | Выберите идентификатор экземпляра EC2, где настроен ваш сайт ArcGIS Server. Примечание:Если вы регистрируете базу данных на многомашинном сайте ArcGIS Server, вы можете выбрать любой идентификатор экземпляра EC2 сайта ArcGIS Server. Не выбирайте файловый сервер EC2. |
ArcGIS Data Store Configuration
| Имя параметра | Обязательно или нет | Описание параметра |
|---|---|---|
Type | Обязательный | Этот шаблон создает хранилище пространственно-временных больших данных ArcGIS Data Store в режиме кластера. Корректное входное значение - spatiotemporal. Подсказка:Чтобы создать реляционное хранилище данных или хранилище графов, используйте шаблон хранилища данных, состоящего из одного компьютера или хранилища данных в режиме первичного ожидания. |
Number of EC2 instances | Обязательный | Выберите количество экземпляров EC2 для включения в кластер хранилища данных. Значение по умолчанию равно 3. Допустимыми значениями являются 1, 3 и 5. Примечание:Если вам нужно больше экземпляров EC2, используйте AWS Management Console, чтобы изменить AWS группу Auto Scaling таким образом, чтобы она включала необходимое количество экземпляров. У вас должно быть нечетное количество экземпляров в хранилище пространственно-временных больших данных. |
EC2 Instance Type | Обязательный | Выберите тип экземпляра EC2, который будет использоваться для экземпляров ArcGIS Data Store. По умолчанию это m5.2xlarge. Экземпляры настраиваются в группе AWS Auto Scaling. |
EC2 Instance Root Drive Disk Space | Обязательный | Укажите размер корневого диска в ГБ. Значение по умолчанию - 500 ГБ. Минимум 200 ГБ. Максимум 4096 ГБ. |
Windows arcgis user password | Условные | Введите пароль для пользователя arcgis. Пользователь arcgis - это локальный логин Windows, используемый для запуска программных сервисов ArcGIS; поэтому этот пароль требуется только при развертывании на Windows. Все пользователи arcgis в одном развертывании, например, все компьютеры Windows (включая файловые серверы) в развертывании ArcGIS Enterprise или в одиночном сайте ArcGIS Server, должны иметь одинаковый пароль. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager. Лучше всего управлять своими паролями в AWS Secrets Manager. Более подробную информацию о создании Amazon Resource Name для паролей см. в разделе AWS CloudFormation и ArcGIS. |
Backup Store Type | Обязательный | Выберите тип хранилища резервных копий ArcGIS Data Store. Тип по умолчанию - CloudStore.
|
ID экземпляра файлового сервера ArcGIS | Условные | Если вы использовали шаблон файлового сервера CloudFormation для создания общедоступного файлового сервера в этом развертывании, предоставьте ID этого экземпляра EC2. Если ID экземпляра EC2 предоставлен, резервные копии ArcGIS Data Store будут храниться на этом экземпляре. |
Backup Store Instance Type | Условные | Выберите тип экземпляра EC2 для компьютера резерной копии ArcGIS Data Store. По умолчанию тип экземпляра m5.2xlarge. Примечание:Этот параметр является обязательным, если выбран FileSystem в качестве хранилища резервных копий, но не указывайте ID для параметра ArcGIS File Server Instance ID. |
Backup Store Instance Root Drive Disk Space | Условные | Укажите размер корневого диска в ГБ. Значение по умолчанию - 500 ГБ. Минимум 200 ГБ. Максимум 4096 ГБ. Примечание:Этот параметр является обязательным, если выбран FileSystem в качестве хранилища резервных копий, но не указывайте ID для параметра ArcGIS File Server Instance ID. |
Выходные данные
Когда ваш стек будет успешно создан, вы можете увидеть следующие выходные параметры на вкладке Outputs стека CloudFormation в AWS Management Console.
| Выходное имя | Выходное описание |
|---|---|
DeploymentLogsURL | Это URL-адрес журналов Amazon CloudWatch, где хранятся все журналы развертывания. Вы можете обратиться к этим журналам для устранения неполадок в случае сбоя развертывания. |
StopStackFunctionName | Это URL функции Stop Stack Lambda. Вы можете использовать эту лямбда-функцию, чтобы остановить все экземпляры EC2 в стеке. |
StartStackFunctionName | Это URL функции Start Stack Lambda. Вы можете использовать эту лямбда-функцию для запуска всех экземпляров EC2 в стеке, которые вы ранее остановили. |
Рекомендации
При создании стека CloudFormation, содержащего развертывания ArcGIS, учитывайте следующее:
- При развертывании ArcGIS Data Store на AWS с помощью этого шаблона экземпляры EC2 настраиваются в группе Auto Scaling AWS. После создания стека можно добавить дополнительные компьютеры (экземпляры EC2) в кластер ArcGIS Data Store путем настройки размера группы Автомасштабирование AWS. Воспользуйтесь AWS Management Console для увеличения или уменьшения емкости группы Автомасштабирование. Обратитесь к документации AWS для изучения инструкций об изменении ограничений емкости группы Автомасштабирование, чтобы добавить или удалить компьютеры из кластера ArcGIS Data Store.
Внимание:
При изменении емкости кластера пространственно-временных хранилищ больших данных изменяйте емкость только для одной машины за раз.
Чтобы найти группу AWS Auto Scaling, созданную для стека CloudFormation, изучите вкладку Ресурсы связанного стека CloudFormation. Логический ID ресурса - AutoScalingGroup.
Хотя технически возможно изменить размер группы AWS Auto Scaling на ноль, оставьте хотя бы один экземпляр работающим в группе Auto Scaling, иначе ArcGIS Data Store не будет работать.
- Не удаляйте никакие ресурсы AWS, созданные этим шаблоном CloudFormation. Чтобы узнать, какие ресурсы AWS были созданы этим шаблоном, обратитесь к вкладке Ресурсы стека в AWS Management Console. У каждого ресурса, созданного шаблоном Esri CloudFormation, также есть теги метаданных. Однако некоторые из этих ресурсов не показывают теги в AWS Management Console.
- Можно использовать функции AWS Lambda, которые появляются в выходных данных стека (перечислены в разделе Выходные данные на этой странице), чтобы остановить экземпляры EC2 в стеке, когда они не используются, и запустить их заново, когда это требуется. Эти функции применяются для управления затратами.
Когда вы запускаете функцию Lambda для остановки экземпляров EC2 в развертывании, то функция возвращает сообщение, что экземпляры остановлены. Однако если экземпляры участвуют в группе Auto Scaling, функция также должна отделять экземпляры от группы. На выполнение этого может уйти до 10 минут, поэтому подождите хотя бы 10 минут перед тем, как запустить функцию запуска Lambda для перезапуска развертывания.
- Если вы используете AWS Secrets Manager для паролей, таких как пароль пользователя администратора сайта или пароль Windows пользователя arcgis, а позже (после создания развертывания) вы меняете эти пароли, обновите соответствующий AWS Secrets Manager ARN новыми паролями.
Решение проблем
Если вы столкнулись с проблемами при создании этого стека CloudFormation, см. Решение проблем, возникающих при развертывании ArcGIS на AWS.