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

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

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

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

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

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

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

  1. Подготовка secret с сертификатом для работы по HTTPS.
  2. Загрузка Helm-чарта и конфигурационного файла.
  3. Заполнение конфигурационного файла.
  4. Установка чарта r7-office с помощью Helm в Kubernetes-кластер.

Шаг 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.

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

Заполнение параметров подключения к приватному 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