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

Введение

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

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

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

После запуска инстанса ONLYOFFICE Docs Developer Edition вы можете интегрировать ONLYOFFICE Docs с собственным SaaS- или серверным решением. Лицензия также позволяет предоставлять онлайн-редакторы конечным пользователям в составе вашего решения под вашим брендом.

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

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

Найдите решение ONLYOFFICE Docs Developer Edition и выберите нужный тип инстанса — на 250, 500 или 1000 подключений. Количество подключений — это количество вкладок браузера с документами, которые можно одновременно открыть для редактирования. Обратите внимание, что один документ, открытый двумя пользователями, означает два одновременных подключения, так как он открыт в двух вкладках. По достижении максимального значения каждый следующий документ будет открываться в режиме только для чтения.

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

Перейдите на вкладку Pricing, чтобы оценить стоимость, которая зависит от некоторых параметров инстанса:

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

• В меню Fulfillment option доступна только опция 64-разрядного (x86) образа Amazon Machine Image (AMI).

• В разделе Software Pricing Details доступна почасовая подписка.

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

  примечание

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

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

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

Тип инстанса EC2 t3.medium используется для решения ONLYOFFICE Docs Developer Edition (250 connections). Параметры инстанса:

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

Тип инстанса EC2 t3.xlarge используется для решения ONLYOFFICE Docs Developer Edition (500 connections). Параметры инстанса:

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

Тип инстанса EC2 t3.2xlarge используется для решения ONLYOFFICE Docs Developer Edition (1000 connections). Параметры инстанса:

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

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

• В разделе Fulfillment Options указаны характеристики AMI. ONLYOFFICE AMI имеет 64-разрядную (x86) архитектуру.
• В разделе Template components указаны сервисы AWS, используемые для данного продукта.
  • Сервис EC2 предоставляет среду для развертывания виртуального сервера под управлением CentOS и установки на нем решения ONLYOFFICE.
• В разделе Usage Instructions приведены краткие рекомендации по первоначальной настройке ONLYOFFICE после запуска инстанса.
• В разделе End User License Agreement указаны условия, на которых предоставляется решение ONLYOFFICE Docs Developer 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 Developer 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 DNS (IPv4) или IPv4 Public IP на вкладке 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 Developer Edition через веб-браузер

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

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

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

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

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

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

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