Instalación de ONLYOFFICE Apps Community con parámetros adicionales del script
Introducción
ONLYOFFICE Apps Community es una versión gratuita de un centro de documentos donde puedes conectar usuarios y documentos en un solo lugar para impulsar la colaboración.
ONLYOFFICE Apps Community se distribuye como un script de instalación automática para sistemas operativos Linux con Docker instalado. El script configurará contenedores Docker con todos los componentes necesarios para el funcionamiento correcto de ONLYOFFICE Apps Community y es fácil de ejecutar, gestionar y actualizar.
Después de descargar el script de instalación de ONLYOFFICE Apps Community, es posible que necesites ejecutarlo especificando algunos parámetros adicionales, por ejemplo, si quieres instalar cada componente en una máquina distinta.
Usa el siguiente comando para mostrar la lista de todos los parámetros Docker disponibles del script:
bash apps-install.sh docker -h
Usa el siguiente comando para mostrar la lista de todos los parámetros DEB/RPM disponibles del script:
bash apps-install.sh package -h
A continuación encontrarás una breve descripción y algunos ejemplos de uso de estos parámetros.
Cuando ejecutes el script con parámetros, se te pedirá que selecciones la forma en que quieres instalar ONLYOFFICE Apps. Escribe Y y pulsa Enter para instalar ONLYOFFICE Apps con Docker. Escribe N y pulsa Enter para instalar ONLYOFFICE Apps desde paquetes DEB/RPM.
Credenciales
| Parámetro | Descripción |
|---|---|
-reg, --registry | URL del registro de Docker (p. ej., https://myregistry.com:5000) |
-un, --username | usuario del registro de Docker |
-p, --password | contraseña del registro de Docker |
Estos parámetros se utilizan en caso de que te proporcionemos credenciales para acceder a un repositorio de pruebas y así puedas ejecutar contenedores a partir de las imágenes almacenadas en él.
Ejemplo
bash apps-install.sh -reg URL -un username -p password
Tipo de instalación
| Parámetro | Descripción | Valores | Predeterminado |
|---|---|---|---|
-it, --installationtype | tipo de instalación | community|developer|enterprise | community |
Este parámetro te permite instalar la solución especificada: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer u ONLYOFFICE Apps Enterprise.
Ejemplo
bash apps-install.sh -it enterprise
Esto instalará la solución ONLYOFFICE Apps Enterprise.
Verificación de hardware
| Parámetro | Descripción | Valores | Predeterminado |
|---|---|---|---|
-skiphc, --skiphardwarecheck | úsalo para omitir la verificación de hardware | true|false | false |
Este parámetro te permite omitir la comprobación de si el sistema cumple los requisitos mínimos de hardware.
Ejemplo
bash apps-install.sh -skiphc true
Esto omitirá la verificación de hardware.
Actualización de componentes
| Parámetro | Descripción | Valores | Predeterminado |
|---|---|---|---|
-u, --update | úsalo para actualizar los componentes existentes | true|false | false |
Este parámetro te permite instalar las últimas versiones de los componentes necesarios si los componentes correspondientes instalados en tu máquina están obsoletos.
Ejemplo
bash apps-install.sh -u true
Esto detendrá sucesivamente los contenedores que deban actualizarse, los eliminará y luego ejecutará las últimas versiones de los componentes correspondientes de ONLYOFFICE Apps Community. Si la versión actual del componente coincide con la última disponible, ese contenedor no se verá afectado. Si omitiste algunos componentes durante la instalación anterior, también se omitirán. Los datos de ONLYOFFICE Apps deberían recogerse automáticamente.
Actualizar solo Docs a la versión 7.2.1.34 y omitir la actualización de todos los demás componentes:
bash apps-install.sh -u true -docsi onlyoffice/documentserver -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Actualizar solo ONLYOFFICE Apps a la versión 1.2.0 y omitir la actualización de todos los demás componentes:
bash apps-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
Instalación de componentes
| Parámetro | Descripción | Valores | Predeterminado |
|---|---|---|---|
-ia, --installapps | instalar ONLYOFFICE Apps | true|false | true |
-idocs, --installdocs | instalar ONLYOFFICE Docs | true|false | true |
-irbt, --installrabbitmq | instalar RabbitMQ | true|false | true |
-irds, --installredis | instalar Redis | true|false | true |
-imysql, --installmysql | instalar MySQL | true|false | true |
Estos parámetros te permiten especificar si necesitas instalar o no un determinado componente. Se pueden utilizar si quieres instalar cada componente en una máquina distinta.
- Usa el valor
truepara instalar un componente. - Usa el valor
falsepara omitir la instalación de un componente.
Ejemplo
bash apps-install.sh -idocs false
Esto instalará todos los componentes de ONLYOFFICE Apps Community sin ONLYOFFICE Docs.
bash apps-install.sh -ia false -idocs true -imysql false -irbt false -irds false
Esto omitirá la instalación de ONLYOFFICE Apps, MySQL, RabbitMQ y Redis e instalará únicamente ONLYOFFICE Docs.
Versión de componentes
| Parámetro | Descripción |
|---|---|
-asv, --appsversion | versión de ONLYOFFICE Apps |
-docsv, --docsversion | versión de ONLYOFFICE Docs |
Estos parámetros se pueden utilizar para instalar una versión determinada de ONLYOFFICE Apps o de ONLYOFFICE Docs si, por algún motivo, no quieres instalar la última versión disponible en el repositorio. De forma predeterminada, se utiliza una imagen etiquetada como latest para ejecutar el contenedor del componente.
Ejemplo
Abre el repositorio de Docker Hub en tu navegador, selecciona ONLYOFFICE Docs y ve a la pestaña Tags para ver todas las etiquetas disponibles en el repositorio. Especifica la versión que quieres instalar:
bash apps-install.sh -docsv 7.2.1.34
Esto instalará ONLYOFFICE Apps con la versión 7.2.1.34 de ONLYOFFICE Docs.
Nombre de la imagen de ONLYOFFICE Docs
| Parámetro | Descripción |
|---|---|
-docsi, --docsimage | nombre de la imagen de ONLYOFFICE Docs |
Este parámetro se puede utilizar para especificar el nombre de la imagen de ONLYOFFICE Docs a partir de la cual debe iniciarse un contenedor. La imagen especificada debe estar almacenada en nuestro repositorio público oficial de Docker Hub.
Ejemplo
bash apps-install.sh -docsi onlyoffice/documentserver
Esto ejecutará un contenedor a partir de la imagen de ONLYOFFICE Docs especificada y almacenada en el repositorio.
Configuración para hosts
| Parámetro | Descripción |
|---|---|
-ash, --appshost | host de ONLYOFFICE Apps |
-esh, --elastichost | hosts de OpenSearch |
Estos parámetros se pueden utilizar para conectar los componentes si los instalas en máquinas distintas.
Ejemplo
bash apps-install.sh -esh 192.168.3.202
Esto instalará ONLYOFFICE Apps y lo conectará con OpenSearch instalado en otra máquina que tiene la dirección IP 192.168.3.202.
Configuración para core.machinekey
| Parámetro | Descripción |
|---|---|
-mk, --machinekey | Configuración de la clave core.machinekey |
Este parámetro te permite especificar tu propia machinekey al instalar ONLYOFFICE Apps Community.
Este parámetro se escribe en el archivo de configuración /app/onlyoffice/config/appsettings.json (la ruta se especifica dentro del contenedor onlyoffice-studio).
Ejemplo
bash apps-install.sh -mk yourmachinekey
Puerto externo de ONLYOFFICE Apps
| Parámetro | Descripción | Predeterminado |
|---|---|---|
-ep, --externalport | puerto externo de ONLYOFFICE Apps | 80 |
Este parámetro te permite cambiar el puerto en el que se ejecutará ONLYOFFICE Apps. De forma predeterminada, se utiliza el puerto 80.
Ejemplo
bash apps-install.sh -ep 8080
Configuraciones para el encabezado y secreto JWT
| Parámetro | Descripción |
|---|---|
-jh, --jwtheader | Configuración del encabezado JWT |
-js, --jwtsecret | Configuración de la clave secreta JWT |
Estos parámetros te permiten especificar el encabezado JWT y tu propia clave secreta JWT al instalar ONLYOFFICE Apps Community. El encabezado JWT define el encabezado http que se utilizará para enviar el JWT. La clave secreta se utiliza para firmar el token web JSON y validar el token en la solicitud a ONLYOFFICE Docs.
Estos parámetros se escriben en los siguientes archivos de configuración (las rutas se especifican dentro de los contenedores onlyoffice-studio y onlyoffice-document-server):
- Para ONLYOFFICE Apps -
/app/onlyoffice/config/appsettings.json - Para Document Server -
/etc/onlyoffice/documentserver/local.json
Ejemplo
bash apps-install.sh -js yoursecret
Servidor MySQL
| Parámetro | Descripción | Predeterminado |
|---|---|---|
-mysqlrp, --mysqlrootpassword | contraseña root del servidor MySQL | generada automáticamente |
-mysqlh, --mysqlhost | host del servidor MySQL | localhost |
-mysqlport, --mysqlport | número de puerto del servidor MySQL | 3306 |
Si no especificas explícitamente el host y el puerto, se utilizan los valores predeterminados. La contraseña de root se genera automáticamente si no la estableces.
Ejemplo
bash apps-install.sh -mysqlrp new-secret-pw
Este comando te permite establecer tu propia contraseña para la cuenta root de MySQL durante la instalación de ONLYOFFICE Apps Community.
Base de datos de ONLYOFFICE Apps
| Parámetro | Descripción | Predeterminado |
|---|---|---|
-mysqld, --mysqldatabase | nombre de la base de datos de ONLYOFFICE Apps | onlyoffice_apps |
-mysqlu, --mysqluser | usuario de la base de datos de ONLYOFFICE Apps | - |
-mysqlp, --mysqlpassword | contraseña de la base de datos de ONLYOFFICE Apps | generada automáticamente |
Estos parámetros te permiten crear la base de datos de ONLYOFFICE Apps especificando un nombre de base de datos personalizado, así como un nombre de usuario y una contraseña para la cuenta con permisos de superusuario sobre la base de datos creada. Si no especificas explícitamente el nombre de la base de datos, se utiliza el valor predeterminado. Si no estableces una contraseña, se genera automáticamente.
Ejemplo
bash apps-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
Servidor RabbitMQ
| Parámetro | Descripción | Predeterminado |
|---|---|---|
--rabbitmqprotocol | protocolo de conexión de RabbitMQ | amqp |
--rabbitmqhost | host del servidor RabbitMQ | localhost |
--rabbitmqport | número de puerto del servidor RabbitMQ | 5672 |
--rabbitmqusername | nombre de usuario de RabbitMQ | - |
--rabbitmqpassword | contraseña del usuario de RabbitMQ | - |
--rabbitmqvirtualhost | host virtual de RabbitMQ | / |
Utiliza estos parámetros para conectar ONLYOFFICE Apps a un servidor RabbitMQ que ya se está ejecutando en otra máquina. Omite la instalación de RabbitMQ con el parámetro -irbt false y, a continuación, especifica los parámetros de conexión de tu propio servidor. Si no especificas explícitamente el protocolo, el host, el puerto o el host virtual, se utilizan los valores predeterminados.
Ejemplo
bash apps-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
Esto instalará ONLYOFFICE Apps sin RabbitMQ y lo conectará al servidor RabbitMQ que se ejecuta en el host mq.example.com.
Servidor Redis
| Parámetro | Descripción | Predeterminado |
|---|---|---|
--redishost | host del servidor Redis | localhost |
--redisport | número de puerto del servidor Redis | 6379 |
--redisusername | nombre de usuario de Redis, si el servidor requiere autorización | - |
--redispassword | contraseña del usuario de Redis, si el servidor requiere autorización | - |
Utiliza estos parámetros para conectar ONLYOFFICE Apps a un servidor Redis que ya se está ejecutando en otra máquina. Omite la instalación de Redis con el parámetro -irds false y, a continuación, especifica los parámetros de conexión de tu propio servidor. El nombre de usuario y la contraseña solo son necesarios si tu servidor Redis requiere autorización.
Ejemplo
bash apps-install.sh -irds false --redishost redis.example.com --redispassword password
Esto instalará ONLYOFFICE Apps sin Redis y lo conectará al servidor Redis que se ejecuta en el host redis.example.com.
Servidor OpenSearch
| Parámetro | Descripción | Predeterminado |
|---|---|---|
--elasticprotocol | protocolo de conexión de OpenSearch | http |
--elasticport | número de puerto del servidor OpenSearch | 9200 |
Utiliza estos parámetros junto con el parámetro -esh, --elastichost descrito en la sección Configuración para hosts anterior para conectar ONLYOFFICE Apps a un servidor OpenSearch que se ejecuta en otra máquina. Si no especificas explícitamente el protocolo y el puerto, se utilizan los valores predeterminados.
Ejemplo
bash apps-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
Esto conectará ONLYOFFICE Apps al servidor OpenSearch que se ejecuta en el host search.example.com mediante HTTPS.
Cambio a HTTPS
| Parámetro | Descripción |
|---|---|
-led, --letsencryptdomain | define el dominio para el certificado de Let's Encrypt |
-lem, --letsencryptmail | define la dirección de correo del administrador del dominio para el certificado de Let's Encrypt |
-cf, --certfile | ruta al archivo de certificado del dominio |
-ckf, --certkeyfile | ruta al archivo de clave privada del certificado |
Estos parámetros te permiten cambiar el espacio de trabajo a HTTPS. Solo se pueden utilizar con la versión de Docker.
Ejemplo
bash apps-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Esto creará e instalará automáticamente en tu servidor el certificado firmado por la CA letsencrypt.org y reiniciará el servicio NGINX para que los cambios surtan efecto.
bash apps-install.sh docker --certfile path --certkeyfile path
Esto aplicará tu propio certificado SSL.