Развертывание ONLYOFFICE Docs Enterprise Edition из образа AMI

Введение

Теперь вы можете запустить инстанс ONLYOFFICE Docs Enterprise Edition в облаке Amazon Web Services из образа ONLYOFFICE Amazon Machine Image, который доступен на торговой площадке AWS Marketplace.

Amazon Machine Image (AMI) — это предварительно настроенный шаблон, позволяющий запустить инстанс, т.е. виртуальный сервер, в личном облаке AWS.

Образ ONLYOFFICE Docs Enterprise Edition AMI включает в себя все необходимые компоненты — операционную систему, программное обеспечение и том хранилища, — с помощью которых можно развернуть онлайн-офис на виртуальном сервере под Linux (CentOS).

После запуска инстанса ONLYOFFICE Docs Enterprise Edition вы можете интегрировать ONLYOFFICE Docs с одной из платформ синхронизации и обмена файлами, например, Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub и т.д.

Шаг 1. Выбор необходимого образа ONLYOFFICE AMI и подписка на решение

Войдите в свою учетную запись AWS или зарегистрируйте новую и перейдите на торговую площадку AWS Marketplace.

Найдите решение ONLYOFFICE Docs Enterprise Edition и выберите нужный тип инстанса — на 50, 100, 200 или 400 подключений. Количество подключений отвечает за количество вкладок браузера с документами, которые можно открыть для редактирования в одно и то же время. Обратите внимание, что один документ, открытый двумя пользователями, означает два одновременных подключения, так как он открыт в двух вкладках. По достижении максимально допустимого значения последующие документы будут открываться в режиме только для чтения.

Описание функций программного обеспечения доступно на странице Product Overview.

Для уточнения цены перейдите на вкладку Pricing. Цена зависит от некоторых параметров инстанса:

• При необходимости измените регион запуска инстанса (Region). Рекомендуется выбирать ближайший регион из доступных. По умолчанию выбран регион US East (N. Virginia).

• В меню Fulfillment option единственная доступная опция — 64-разрядный (x86) образ Amazon Machine Image (AMI).

• В разделе Software Pricing Details выберите почасовую (Hourly) или годовую (Annual) подписку.

  Итоговая цена включает расходы на использование программного обеспечения ONLYOFFICE и инфраструктурных сервисов AWS, на базе которых развертывается решение.

  примечание

  Более подробная информация о подписке на платные образы AMI и о цене в целом доступна в документации AWS.

При нажатии на тип инстанса в колонке EC2 Instance type таблицы (например, t3.large) вы можете посмотреть детали инстанса. От типа инстанса EC2 зависит аппаратное обеспечение виртуального сервера для развертывания решения ONLYOFFICE.

Доступные типы инстансов зависят от выбранного варианта решения ONLYOFFICE Docs Enterprise Edition, т.е. от количества доступных подключений.

Тип инстанса EC2 t3.small используется для решения ONLYOFFICE Docs Enterprise Edition (50 подключений). Параметры инстанса:

• Оперативная память: 2 ГБ
• Процессор: 2 виртуальных ядра
• Хранилище: только EBS
• Сеть: Ethernet до 5 Гбит/с

Тип инстанса EC2 t3.medium используется для решения ONLYOFFICE Docs Enterprise Edition (100 подключений). Параметры инстанса:

• Оперативная память: 4 ГБ
• Процессор: 2 виртуальных ядра
• Хранилище: только EBS
• Сеть: Ethernet до 5 Гбит/с

Тип инстанса EC2 t3.xlarge используется для решения ONLYOFFICE Docs Enterprise Edition (200 подключений). Параметры инстанса:

• Оперативная память: 16 ГБ
• Процессор: 4 виртуальных ядра
• Хранилище: только EBS
• Сеть: Ethernet до 5 Гбит/с

Тип инстанса EC2 t3.2xlarge используется для решения ONLYOFFICE Docs Enterprise Edition (400 подключений). Параметры инстанса:

• Оперативная память: 32 ГБ
• Процессор: 8 виртуальных ядер
• Хранилище: только EBS
• Сеть: Ethernet до 5 Гбит/с

Перейдите на вкладку Usage, где доступна следующая информация:

• В разделе Fulfillment Options указаны характеристики AMI. ONLYOFFICE AMI имеет 64-разрядную (x86) архитектуру.
• В разделе Template components указаны сервисы AWS, используемые для данного продукта.
  • Сервис EC2 предоставляет среду для развертывания виртуального сервера под CentOS и установки на него решения ONLYOFFICE.
• В разделе Usage Instructions приведены краткие рекомендации по первоначальной настройке ONLYOFFICE после запуска инстанса.
• В разделе End User License Agreement указаны условия, на которых предоставляется решение ONLYOFFICE Docs Enterprise Edition.

Нажмите кнопку Continue to Subscribe в правом верхнем углу. Откроется страница Subscribe to this software:

Прочтите AWS Customer Agreement (Пользовательское соглашение AWS) и нажмите кнопку Accept Terms. Дождитесь завершения обработки подписки.

Когда в поле Effective date вместо надписи 'Pending' появится текущая дата, нажмите кнопку Continue to Configuration в правом верхнем углу.

Шаг 2. Запуск инстанса ONLYOFFICE в облаке AWS

На странице Configure this software нажмите кнопку Continue to Launch в правом верхнем углу.

Откроется страница Launch this software. На этой странице можно еще раз проверить значения в разделе Configuration Details.

В разделе Choose Action можно выбрать метод запуска инстанса. По умолчанию выбран метод Launch from Website. Оставьте его без изменений, чтобы развернуть инстанс при помощи мастера Launch Instance Wizard на этой веб-странице.

примечание

Вы также можете запустить инстанс через консоль Amazon EC2 console. Для этого выберите в меню опцию Launch through EC2 и нажмите кнопку Launch. Вы будете перенаправлены в мастер Launch Instance Wizard в консоли AWS Management Console, где можно выбрать тип инстанса, настроить детали инстанса, добавить хранилище и теги, а также настроить группу безопасности. В данном руководстве такой метод запуска инстанса не рассматривается.

В разделе EC2 Instance Type доступна единственная опция (она зависит от ранее выбранного типа инстанса ONLYOFFICE Docs Enterprise Edition с определенным количеством подключений).

В разделах VPC Settings и Subnet Settings оставьте настройки по умолчанию.

Теперь нужно создать новую группу безопасности (Security group) и сгенерировать пару ключей (Key pair).

Создание новой группы безопасности

Группа безопасности позволяет ограничить доступ к инстансу, чтобы к нему можно было подключиться только с известных IP-адресов.

В разделе Security Group Settings нажмите кнопку Create New Based on Seller Settings.

Введите название группы безопасности (например, ONLYOFFICE) и добавьте ее описание.

В списке Source (IP or Group) задайте необходимые правила. Можно указать один IP-адрес или диапазон IP-адресов, например, 10.040.196.230/32.

Правила задаются для следующих портов:

• SSH — порт 22 используется для доступа к серверу через SSH-клиент по протоколу SSH.
• HTTP — порт 80 используется для доступа к онлайн-офису через веб-браузер по протоколу HTTP.
• HTTPS — порт 443 используется для доступа к онлайн-офису через веб-браузер по защищенному протоколу HTTPS.

По завершении нажмите кнопку Save.

Генерирование пары ключей

Пара ключей нужна для защищенного подключения к инстансу по протоколу SSH через SSH-клиент, например, PuTTY или OpenSSH.

В разделе Key Pair Settings перейдите по ссылке Create a key pair in EC2.

В новой вкладке браузера откроется консоль AWS Management Console.

примечание

Проверьте, что регион AWS Region, указанный на верхней панели инструментов, совпадает с регионом, в котором вы хотите запустить инстанс.

Нажмите кнопку Create key pair в правом верхнем углу. Введите имя пары ключей (например, ONLYOFFICE) в соответствующее поле и выберите формат файла в зависимости от программного обеспечения, которое вы хотите использовать для удаленного подключения к инстансу:

• pem используется для OpenSSH
• ppk используется для PuTTY

Нажмите кнопку Create key pair внизу.

Ваш открытый ключ будет храниться в AWS EC2. Файл .pem/.ppk, который содержит ваш закрытый ключ, будет скачан на локальный компьютер и сохранен в папке Загрузки по умолчанию. Скопируйте его и сохраните в надежном месте.

Вернитесь на торговую площадку AWS Marketplace, обновите поле пары ключей с помощью значка справа от него и выберите из списка созданную пару ключей.

После этого станет доступна кнопка Launch. Нажмите кнопку Launch и дождитесь завершения развертывания инстанса. По завершении появится сообщение об успешном развертывании.

Перейдите по ссылке EC2 Console в этом сообщении, чтобы открыть детали инстанса в консоли AWS Management Console.

Для полноценного функционирования инстанса после запуска может потребоваться некоторое время. Убедитесь, что статус инстанса в колонке Instance State сменился с 'pending' на 'running', и проверьте, что инстанс прошел все проверки статуса. Эта информация отображается в колонке Status Checks.

Теперь вы можете подключиться к инстансу через SSH, чтобы включить тестовые примеры, и проверить работу решения в веб-браузере.

Шаг 3. Подключение к серверу через SSH

Когда инстанс запущен, вы можете подключиться к нему через SSH, используя имя пользователя centos и ваш закрытый SSH-ключ.

Для подключения к виртуальному серверу через SSH вам также потребуется Public DNS или IP-адрес инстанса.

Их можно найти в консоли AWS Management Console. Перейдите в раздел Instances в левом меню, выберите ваш регион (по умолчанию US East (N. Virginia)) и выберите в списке инстанс ONLYOFFICE, чтобы открыть его детали.

Нажмите на значок слева от значения Public IPv4 DNS или Public IPv4 address на вкладке Description, чтобы скопировать нужное значение в буфер обмена.

В Windows можно воспользоваться утилитой PuTTY.

Для аутентификации вместо пароля используется файл с закрытым ключом AWS, сгенерированный при развертывании инстанса.

Запустите PuTTY. На левой панели навигации откройте раздел Connection -> SSH -> Auth. Перейдите в раздел Authentication parameters -> Private key file for authentication, нажмите кнопку Browse и укажите путь к файлу .ppk, сохраненному на локальном компьютере.

Вернитесь в раздел Session на левой панели навигации. Введите Public DNS или IP-адрес инстанса в поле Host Name or IP address, убедитесь, что указан порт 22 и выбран тип подключения SSH, и нажмите кнопку Open.

Затем нажмите Yes в окне PuTTY Security Alert. Введите имя пользователя centos и нажмите клавишу Enter.

В Linux можно воспользоваться SSH-клиентом, например, OpenSSH.

Потребуется указать путь к файлу .pem с закрытым ключом, сохраненному на локальном компьютере, имя пользователя centos и IP-адрес или Public DNS инстанса.

Введите в терминале следующую команду, указав фактический путь к файлу .pem и IP-адрес:

ssh -i /path/onlyoffice.pem centos@your_instance_ip

Введите yes, чтобы продолжить подключение к серверу. Подробнее смотрите в документации AWS.

Чтобы изучить функциональность решения, включите наш тестовый пример, который позволит загружать локальные файлы для тестирования. Для этого выполните следующую команду:

sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example

Добавьте пример в автозапуск:

sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

Шаг 4. Доступ к Docs Enterprise Edition через веб-браузер

После запуска примера введите в адресную строку веб-браузера адрес http://<public IP address>/example/, заменив <public IP address> на общедоступный IP-адрес или общедоступный DNS, предоставленный Amazon.

Откроется страница примера ONLYOFFICE Docs Enterprise Edition. Здесь вы можете:

1. Загрузить файл, сохраненный на компьютере, с помощью опции Upload file.
2. Создать новый пустой текстовый документ, электронную таблицу, презентацию или шаблон формы с помощью опций Create new -> Document, Spreadsheet, Presentation или Form template. Если вы хотите создать файл с тестовым содержимым, сначала установите флажок With sample content.

Загруженный или созданный файл откроется в новой вкладке браузера в соответствующем онлайн-редакторе ONLYOFFICE, где вы сможете протестировать возможности редактирования.

Файл также появится в списке Your documents на странице примера ONLYOFFICE Docs Enterprise Edition.

Если вы хотите проверить возможности совместного редактирования, выберите другого тестового пользователя из списка Username, а затем нажмите на тот же документ в списке Your documents, чтобы открыть его в новой вкладке браузера.

Чтобы интегрировать ONLYOFFICE Docs в ваше собственное веб-приложение, обратитесь к документации API.