Шаблон Esri arcgis-notebook-server-singlemachine-upgrade.template.json Amazon Web Services (AWS) CloudFormation обновляет сайт ArcGIS Notebook Server 10.9, который вы создали с помощью шаблона, описанного в Развертывание сайта ArcGIS Notebook Server на одном компьютере с помощью CloudFormation.
Шаблон arcgis-notebook-server-singlemachine-upgrade.template.json обновляет следующее программное обеспечение на одном экземпляре Linux Amazon Elastic Compute Cloud (EC2):
- ArcGIS Notebook Server
- ArcGIS Web Adaptor
Предварительные условия
Предварительные требования можно сгруппировать по элементам - таким как файлы и учетные записи, которые вы должны получить, а также по задачам, которые вы должны выполнить перед запуском шаблона CloudFormation.
Обязательные элементы
Перед запуском этого шаблона вам необходимо следующее:
- Учетная запись Amazon Web Services с доступом к обновляемому развертыванию.
- Файл лицензии ArcGIS Notebook Server (.ecp или .prvc).
- Файл сертификата или сертификаты SSL (в формате .pfx) и соответствующий пароль. Сертификаты должны быть выданы центром сертификации.
- Существующий сайт ArcGIS Notebook Server с одним компьютером, который вы создали с помощью шаблона Esri Amazon Web Services CloudFormation arcgis-notebook-server-singlemachine.template.json.
- Шаблон обновления CloudFormation, arcgis-notebook-server-singlemachine-upgrade.template.json.
Примечание:
Для обновления развертывания, запустите этот шаблон обновления CloudFormation, который создаст новый стек CloudFormation. Не обновляйте имеющийся стек развертывания CloudFormation, используя этот шаблон.
Обязательные задачи
Перед запуском этого шаблона вам необходимо выполнить следующие задачи:
- Подготовьте бакет развертывания Amazon Simple Storage Service (S3) в своей учетной записи AWS. Вы укажите имя бакета в шаблоне при запуске стека.
- Создайте бакет или используйте существующий бакет S3. Вы должны быть владельцем бакета.
- Загрузите свои файлы авторизации ПО ArcGIS в бакет.
- Загрузите свой файл сертификата SSL в бакет развертывания.
- Настройте пароли в 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.
Параметры
В следующей таблице содержатся параметры, используемые в этом шаблоне, и описание каждого параметра.
ArcGIS Notebook Server Configuration
| Имя параметра | Обязательный? | Описание параметра |
|---|---|---|
ID экземпляра ArcGIS Notebook Server EC2 | Обязательный | Выберите ID экземпляра EC2 на вашем существующем сайте ArcGIS Notebook Server. Если вы создали сайт с помощью шаблона Esri CloudFormation или Cloud Builder, вы можете найти ID экземпляра в разделе Ресурсы существующего стека CloudFormation в AWS Management Console. Логический ID ресурса - ArcGISNotebookServerEC2Instance. |
Deployment Bucket Name | Обязательный | Укажите имя бакета Amazon S3, в котором находятся файлы лицензий на программное обеспечение и сертификаты SSL. Этот бакет должен уже существовать и содержать файл лицензии и сертификат SSL для вашего развертывания. Вы должны быть владельцем бакета, и она должна располагаться в той же учетной записи AWS, что и ваше развертывание. |
License File Name | Обязательный | Укажите имя ключа объекта файла авторизации ArcGIS Notebook Server. Перед запуском этого стека необходимо загрузить файл лицензии (файл .ecp или .prvc) в бакет развертывания. Вы можете получить имя ключа объекта файла, перейдя к файлу в бакете развертывания в консоли Amazon S3. Например, notebook.prvc или resources/licenses/server/notebook.prvc. Имена файлов лицензии чувствительны к регистру. Убедитесь, что вы корректно ввели имя в правильном регистре. |
License Level | Обязательный | Выберите уровень лицензии ArcGIS Notebook Server. Можно выбрать следующие опции:
|
Site Administrator User Name | Обязательный | Укажите имя пользователя для основного администратора сайта вашего существующего сайта ArcGIS Notebook Server. |
Site Administrator User Password | Обязательный | Укажите пароль для основного администратора сайта вашего существующего сайта ArcGIS Notebook Server. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager. |
Site Domain Name | Обязательный | Укажите полное доменное имя существующего сайта ArcGIS Notebook Server. |
Web Adaptor Name | Обязательный | Укажите имя Notebook Server Web Adaptor для существующего сайта ArcGIS Notebook Server. |
SSL Certificate File Name | Обязательный | Предоставьте сертификат SSL от центра сертификации (файл .pfx). Используйте тот же (или обновленный) сертификат SSL, который использовался при создании существующего развертывания. Перед запуском этого стека необходимо загрузить сертификат в бакет развертывания. Вы можете получить имя ключа объекта файла, перейдя к файлу в бакете развертывания в консоли AWS S3, например, domainname.pfx или resources/sslcerts/domainname.pfx. |
Пароль сертификата SSL | Обязательный | Введите пароль для сертификата SSL. Вы можете ввести либо обычный текстовый пароль, либо ARN вашего секретного ID из AWS Secrets Manager. Более подробную информацию о создании Amazon Resource Name для паролей см. в разделе AWS CloudFormation и ArcGIS. |
Выходные данные
Когда ваш стек будет успешно создан, вы можете увидеть следующие выходные параметры на вкладке Outputs стека CloudFormation в AWS Management Console.
| Выходное имя | Выходное описание |
|---|---|
ServerAdminDirURL | |
ServerServicesURL | |
DeploymentLogsURL | Это URL-адрес журналов Amazon CloudWatch, где хранятся все журналы развертывания. Вы можете обратиться к этим журналам для устранения неполадок в случае сбоя развертывания. |
Рекомендации
Следующие моменты являются важными после создания стека CloudFormation, который содержит развертывания ArcGIS:
- Если стек создан успешно (другими словами, статус стека - CREATE_COMPLETE), это означает, что ваш сайт ArcGIS Notebook Server успешно обновлен. Вы можете проверить это, войдя в Admin Directory ArcGIS Notebook Server.
- Если не удалось создать стек CloudFormation (другими словами, состояние стека - CREATE_FAILED), вы можете устранить ошибку, как указано на странице, на которую имеется ссылка в разделе Устранение неполадок ниже. Выявив основную причину ошибки и предприняв необходимые действия, вы можете удалить отказавший стек и создать новый для обновления существующего сайта ArcGIS Notebook Server.
Решение проблем
Если вы столкнулись с проблемами при создании этого стека CloudFormation, см. Решение проблем, возникающих при развертывании ArcGIS на AWS.