Skip To Content

Развертывание сайта ArcGIS GeoEvent Server на одном компьютере с помощью CloudFormation

Шаблон Esri arcgis-geoevent-server-singlemachine.template.json Amazon Web Services (AWS) CloudFormation создает сайт ArcGIS GeoEvent Server на одном экземпляре Amazon Elastic Compute Cloud (EC2).

Этот шаблон создает следующую архитектуру в Amazon Web Services.

Сайт ArcGIS GeoEvent Server на одном экземпляре EC2 с дополнительным эластичным IP-адресом и веб-адаптером

Лицензия:

Определенные значки в схеме используются с разрешения 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).

  • Файл сертификата SSL (в формате .pfx) и соответствующий пароль

    Сертификат должен быть выдан центром сертификации.

  • Amazon Virtual Private Cloud (VPC) и подсети.

    Если вы создаете автономный сайт, вы можете использовать один из следующих шаблонов CloudFormation для создания VPC: VPC с двумя общедоступными подсетями или VPC или двумя общедоступными и частными подсетями с NAT Gateway.

    Если вы планируете интегрировать этот сайт с порталом ArcGIS Enterprise, убедитесь, что все компоненты в том же развертывании ArcGIS Enterprise запущены в той же VPC.

  • Файл лицензии ArcGIS GeoEvent Server (.ecp или .prvc).
  • Если вы создаете развертывание на экземплярах Ubuntu EC2 в AWS GovCloud, вам нужен AMI ID. Если вы хотите использовать базовые канонические Ubuntu AMI, следуйте инструкциям в шаблонах Esri Amazon Web Services CloudFormation для идентификации ID.
  • Шаблон arcgis-geoevent-server-singlemachine.template.json CloudFormation.

Обязательные задачи

Перед запуском этого шаблона вам необходимо выполнить следующие задачи:

  • Подготовьте бакет развертывания Amazon Simple Storage Service (S3) в учетной записи AWS. Укажите имя бакета в шаблоне при запуске стека.
    1. Создайте бакет или используйте существующий бакет S3. Вы должны быть владельцем бакета.
    2. Загрузите файл авторизации ArcGIS GeoEvent Server в бакет.
    3. Загрузите файл сертификата SSL в бакет развертывания.
  • Настройте доменное имя системы (DNS).

    У вас должно быть полное доменное имя для сайта ArcGIS GeoEvent Server. Это доменное имя должно существовать до запуска этого стека, также оно должно быть разрешаемым. Обратитесь к своему ИТ-департаменту, если не знаете, как получить полное доменное имя и настроить DNS.

  • Создайте Elastic IP (EIP).

    Используйте AWS Management Console, чтобы создать адрес Elastic IP.

  • Настройте пароли в 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.

Подсказка:

По умолчанию CloudFormation удаляет частично созданные ресурсы в случае неудачного создания стека. Это удобно, потому что он удаляет неиспользуемые развертывания из вашей учетной записи, но это может затруднить выявление проблем. Чтобы получить стек в состоянии неудачи, отключите опцию создания стека Rollback on failure CloudFormation перед его запуском. Подробнее см. Настройка опций AWS CloudFormation в справке AWS.

Параметры

В следующих таблицах описываются параметры, используемые в этом шаблоне CloudFormation. Таблицы сгруппированы по типу параметра.

Amazon EC2 Configuration

Имя параметраОбязательный?Описание параметра

Platform Type

Обязательный

Выберите платформу операционной системы. Поддерживаются следующие типы:

  • Windows
  • Linux

Информацию о конкретных версиях операционной системы см. в разделе Операционные системы, поддерживаемые при использовании CloudFormation для развертывания ArcGIS в AWS.

EC2 Instance AMI ID

Дополнительный

Вы можете оставить значение этого параметра пустым. Если вы это сделаете, в шаблонах CloudFormation будет использоваться последний идентификатор Amazon Machine Image (AMI) для Microsoft Windows Server 2019 или Ubuntu Server 18.04 LTS в зависимости от типа выбранной вами платформы.

Примечание:

Вы не можете оставить этот параметр пустым, если вы выполняете развертывание в AWS GovCloud на платформе Linux. В разделе Шаблоны Esri Amazon Web Services CloudFormation см. инструкции по поиску ID для базового Ubuntu AMI из Canonical. Если вы выполняете развертывание в поддерживаемой операционной системе Linux отличной от Ubuntu, вы можете найти идентификатор AMI с помощью AWS Management Console или в AWS Marketplace.

При первом использовании одного из AMI по умолчанию для определенного релиза необходимо принять правила MarketplaceAWS.

Если вы хотите использовать пользовательский AMI, вы можете ввести идентификатор AMI одним из следующих способов:

  • Введите идентификатор AMI в формате 'ami-xxxxx'.
  • Если вы сохранили идентификатор AMI в хранилище параметров SSM AWS, укажите имя параметра SSM в формате AWS'{{resolve:ssm:[a-zA-Z0-9_.- /]+:\d+}}'.

Если вы применяете пользовательский AMI, убедитесь, что он соответствует следующим требованиям:

  • Сервис метаданных экземпляра EC2 (с версией V2 или V1) должен быть активирован.
  • Должна быть установлена последняя версия AWS Systems Manager Agent (SSM).
  • Если пользовательский AMI имеет операционную систему Windows, необходимо установить AWS Tools для PowerShell.

EC2 Instance Keypair Name

Обязательный

Выберите имя пары ключей EC2, чтобы разрешить удаленный доступ к экземплярам EC2.

Elastic IP Address Allocation ID

Обязательный

Введите ID размещения адресов Elastic IP (в формате eipalloc-XXXXXXXX.

Вам понадобится эластичный IP-адрес, чтобы сопоставить доменное имя сайта с эластичным IP-адресом и получить доступ к экземпляру EC2 через RDP/SSH из-за пределов среды AWS.

Amazon VPC Configuration

Имя параметраОбязательный?Описание параметра

VPC ID

Обязательный

Выберите идентификатор VPC.

Примечание:

Все компоненты ArcGIS Enterprise, которые являются частью одного развертывания, должны быть развернуты в одном и том же VPC.

Если вам нужно создать VPC, вы можете использовать один из примеров шаблонов VPC: VPC с общедоступными подсетями или VPC с общедоступными и частными подсетями и шлюзом NAT.

Subnet ID 1

Обязательный

Выберите идентификатор подсети. Выбранный идентификатор подсети должен находиться в VPC, выбранном ранее.

Если вы использовали шаблон Esri CloudFormation для создания VPC, вы можете получить идентификатор подсети из выходных параметров этого шаблона.

Domain Name System (DNS) Configuration

Имя параметраОбязательный?Описание параметра

ArcGIS GeoEvent Server Site Domain Name

Обязательный

Укажите полное доменное имя для сайта ArcGIS GeoEvent Server. Доменное имя должно существовать и быть разрешаемым. Если вы не уверены в том, какое доменное имя использовать, обратитесь к своему ИТ-администратору.

ArcGIS GeoEvent Server Configuration

Имя параметраОбязательный?Описание параметра

EC2 Instance Type

Обязательный

Определите тип экземпляра EC2. По умолчанию это m5.2xlarge.

Это тип экземпляра, который будет использован для машины ArcGIS GeoEvent Server.

Экземпляр EC2 будет настроен с функцией AWS Автовосстановление.

EC2 Instance Root Drive Disk Space

Обязательный

Это размер корневого диска для экземпляра ArcGIS GeoEvent Server EC2.

Укажите размер корневого диска в ГБ. По умолчанию 100 ГБ. Минимум 100 ГБ. Максимум 1024 ГБ.

Deployment Bucket Name

Обязательный

Укажите имя бакета Amazon S3, в котором находятся файлы лицензий на программное обеспечение и сертификаты SSL. Этот бакет должен уже существовать и содержать файл лицензии и сертификат SSL для вашего развертывания.

Вы должны быть владельцем бакета, и она должна располагаться в той же учетной записи AWS, что и ваше развертывание.

License File Name

Обязательный

Укажите имя ключа объекта файла авторизации ArcGIS GeoEvent Server. Перед запуском этого стека необходимо загрузить файл лицензии (файл .ecp или .prvc) в бакет развертывания.

Чтобы получить имя ключа объекта файла, перейдите к файлу в корзине развертывания в консоли Amazon S3, например, geoevent.prvc или resources/licenses/server/geoevent.prvc.

Имена файлов лицензии чувствительны к регистру. Убедитесь в корректности написания имени.

Site Administrator User Name

Обязательный

Укажите имя пользователя основного администратора сайта для сайта ArcGIS GeoEvent Server.

Имя должно состоять из 6 или более буквенно-цифровых символов или символов подчеркивания (_) и начинаться с буквы.

Site Administrator User Password

Обязательный

Укажите пароль основного администратора сайта для сайта ArcGIS GeoEvent Server. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager.

Windows arcgis user password

Условные

Введите пароль для пользователя arcgis. Пользователь arcgis - это локальный логин Windows, используемый для запуска программных сервисов ArcGIS; поэтому этот пароль требуется только при развертывании на Windows.

Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager.

Лучше всего управлять своими паролями в AWS Secrets Manager. Более подробную информацию о создании Amazon Resource Name для паролей см. в разделе AWS CloudFormation и ArcGIS.

Web Adaptor Name

Дополнительный

Чтобы использовать ArcGIS Web Adaptor с сайтом ArcGIS GeoEvent Server, введите имя веб-адаптера. Зайдите на сайт ArcGIS GeoEvent Server посредством URL-адреса в формате https://<fully qualified domain name>/<web adaptor name>. Имя должно начинаться с буквы и содержать только буквенно-цифровые символы.

Оставьте значение этого параметра пустым, если вы не хотите использовать ArcGIS Web Adaptor, и URL-адреса для сайта будут в формате https://<fully qualified domain name><PortNumber>/arcgis.

SSL Certificate File Name

Обязательный

Предоставьте сертификат SSL от центра сертификации (файл .pfx). Перед запуском этого стека необходимо загрузить сертификат в бакет развертывания. Вы можете получить имя ключа объекта файла, перейдя к файлу в бакете развертывания в консоли AWS S3, например, domainname.pfx или resources/sslcerts/domainname.pfx.

SSL Certificate Password

Обязательный

Введите пароль для сертификата SSL. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager. Более подробную информацию о создании Amazon Resource Name для паролей см. в разделе AWS CloudFormation и ArcGIS.

Выходные данные

Когда ваш стек будет успешно создан, вы можете увидеть следующие выходные параметры на вкладке Outputs стека CloudFormation в AWS Management Console.

Выходное имяВыходное описание

DeploymentLogsURL

Это URL-адрес журналов Amazon CloudWatch, где хранятся все журналы развертывания. Вы можете обратиться к этим журналам для устранения неполадок в случае сбоя развертывания.

GeoEventManagerURL

Менеджер URL ArcGIS GeoEvent Server

ServerManagerDirURL

URL ArcGIS Server Manager.

ServerRestDirURL

URL ArcGIS Server REST сервисов.

ServerServicesURL

URL сервисов ArcGIS GeoEvent Server.

Этот URL можно использовать в качестве входного параметра в шаблоне интегрированного сервера.

StopStackFunctionName

Это URL функции Stop Stack Lambda. Вы можете использовать эту лямбда-функцию, чтобы остановить все экземпляры EC2 в стеке.

StartStackFunctionName

Это URL функции Start Stack Lambda. Вы можете использовать эту лямбда-функцию для запуска всех экземпляров EC2 в стеке, которые вы ранее остановили.

Рекомендации

Следующие моменты являются важными после создания стека CloudFormation, который содержит развертывания ArcGIS:

  • Не удаляйте никакие ресурсы 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.