ELMA365 On-Premises > ELMA365 On-Premises Enterprise > Установка дополнений для приложения ELMA365 / Установка сервера документов Р7-Офис

Установка сервера документов Р7-Офис

Сервер документов Р7-Офис используется для онлайн-работы. Он включает в себя просмотрщики и редакторы текстовых документов, электронных таблиц и презентаций. Сервер документов Р7‑Офис полностью совместим с форматами: .docx, .xlsx, .pptx и позволяет редактировать документы в режиме реального времени.

Начало внимание

Для исключения передачи конфиденциальных данных (документов) в открытом виде настройте использование протокола HTTPS на стороне сервера документов Р7‑Офис.

Конец внимание

Установка состоит из четырёх этапов:

Шаг 1: Подготовка secret с сертификатом для работы по HTTPS

1. Создайте namespace с наименованием r7office, выполнив команду:

kubectl create namespace r7office

2. По статье «Подготовка secret с сертификатом для работы по HTTPS» создайте в namespace r7office secret с наименованием elma365-onpremise-tls.

Шаг 2: Загрузка helm-чарта и конфигурационного файла

Для установки через интернет получите конфигурационный файл values-r7office.yaml, выполнив команду:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm show values elma365/r7office > values-r7office.yaml

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

Шаг 3: Заполнение конфигурационного файла

Заполните конфигурационный файл values-r7office.yaml для установки r7-office.

Убедитесь, что в параметре r7office.ingress.enabled задано значение true.
В параметрах r7office.ingress.hosts и r7office.ingress.tls.hosts вместо значения r7office.your_domain укажите домен (FQDN), по которому будет доступен Р7-Офис.
В параметре r7office.ingress.tls.secretName укажите наименование secret, созданного на шаге 1. В данной статье это значение elma365-onpremise-tls.
В параметре r7office.replicaCount укажите количество реплик для обеспечения высокой доступности.

Важно: если в Kubernetes кластере установлен Ingress-nginx-controller версии 1.9.0 или выше:

в параметре r7office.ingress.className задайте наименование нужного IngressClass. Стандартное наименование: nginx;
закомментируйте параметр r7office.ingress.annotations.kubernetes.io/ingress.class: nginx.

## Настройки r7office
r7office:
ingress:
## включение host в ingress
enabled: true
className: ""
annotations:
kubernetes.io/ingress.class: nginx
## аннотации для работы cert-manager
# certmanager.io/cluster-issuer: letsencrypt
hosts:
## домен (FQDN), по которому будет доступен r7office
- host: example.ru
paths:
- path: /
pathType: ImplementationSpecific
## включение шифрования, при использовании cert-manager указать используемый secretName letsencrypt
tls:
- secretName: elma365-onpremise-tls
hosts:
- example.ru
## включить создание secret с собственными сертификатами
## указать путь до сертификата в строках key: и cert:
secret:
enabled: true
key: "files/my_cert.key"
cert: "files/my_cert.crt"
## задайте значение true при использовании самозаверенных сертификатов для вашего хранилища
unautorizedStorage: false
## количество реплик для обеспечения высокой доступности
replicaCount: 1
## включение использования JWT токена
jwtEnabled: true
## при наличии файла лицензии выставить параметру enable: значение true
## указать путь до лицензии в строке licensePath:
license:
enable: false
licensePath: "files/license.lic"
...

Заполнение параметров подключения файла лицензии Р7-Офис

начало внимание

Подключить файл лицензии возможно при локальной установке чарта Р7-Офис.

конец внимание

На компьютере с доступом в интернет загрузите архив актуальной версии (latest) чарта Р7-Офис из репозитория ELMA365, выполнив следующую команду:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm pull elma365/r7office

Для установки в закрытом контуре полученный архив чарта r7office-X.Y.Z.tgz скопируйте на сервер, где будет производиться установка.
Распакуйте чарт r7office-X.Y.Z.tgz на сервере, где будет производиться установка, и скопируйте конфигурационный файл по умолчанию values.yaml в values-r7office.yaml:

tar -xf r7office-X.Y.Z.tgz
cp r7office/values.yaml values-r7office.yaml

Заполните параметры файла конфигурации values-r7office.yaml, описанные на шаге 3.
В конфигурационном файле values-r7office.yaml для параметра r7office.license.enable задайте значение true:

## Настройки r7office
r7office:
...
  ## при наличии файла лицензии выставить параметру enable: значение true
  ## указать путь до лицензии в строке licensePath:
  license:
    enable: true
    licensePath: "files/license.lic"
...

Скопируйте файл лицензии в каталог с распакованным чартом Р7-Офис по пути r7office/charts/r7office/files/:

cp path_to_license_file/license.lic r7office/charts/r7office/files/license.lic

Заполнение параметров подключения к приватному registry для установки в закрытом контуре без доступа в интернет

Шаг 4: Установка чарта r7‑office с помощью helm в Kubernetes-кластер

Выполните установку чарта r7-office в namespace r7office.

Для установки через интернет:

helm upgrade --install r7office elma365/r7office -f values-r7office.yaml -n r7office

Для офлайн-установки без доступа в интернет перейдите в каталог с загруженным чартом и выполните команду:

helm upgrade --install r7office ./r7office -f values-r7office.yaml -n r7office

Начало внимание

Установка компонента дополнений Р7-Офис автоматически не включает интеграцию сервера документов с приложением ELMA365.

Конец внимание

После установки нужно выполнить интеграцию сервера документов Р7-Офис с модулем Р7-Офис в приложении ELMA365.

Для полноценной работы приобретите лицензию «Р7-Офис. Профессиональный (серверная версия). Сервер документов ».

Удалить чарт r7-office с помощью helm в Kubernetes-кластере

Начало внимание

Перед удалением компонента дополнений Р7-Офис отключите использование модуля Р7-Офис в приложении ELMA365.

Конец внимание

Чтобы удалить чарт r7-office в namespace r7office, выполните команду:

helm uninstall r7office -n r7office

install-cert-manager.html install-onlyoffice.html

Была ли статья полезной?