Implementa Collabora CODE en Kubernetes con Helm.

A fecha de 10 de octubre de 2026, el registro de paquetes original indica que la versión 1.3.0 del gráfico es la más reciente. Instalar el gráfico es solo una parte de la implementación. También se requiere un nombre de host público de Collabora, una entrada válida en la lista de permisos de WOPI para el host de almacenamiento de documentos y una configuración de entrada que mantenga las solicitudes de cada documento en el mismo pod. El registro de paquetes original indica la versión 1.3.0 del gráfico en el momento de redactar este documento; consulte el repositorio antes de instalarlo, ya que la versión del gráfico de Helm y la versión de la imagen del contenedor CODE son valores distintos.

Este procedimiento utiliza el collabora/collabora-onlinegráfico oficial y un controlador de entrada NGINX. El archivo README del gráfico también incluye ejemplos de HAProxy; las anotaciones de entrada son específicas del controlador, así que utilice el ejemplo correspondiente a su controlador instalado en lugar de mezclar anotaciones.

Qué preparar primero

• Un clúster de Kubernetes con permiso para crear un espacio de nombres, un despliegue, un servicio y un Ingress.
• Helm 3 y un controlador de entrada instalado que pueda proporcionar HTTPS para un nombre de host como office.example.com.
• El nombre de host público del cliente WOPI, como Nextcloud o Seafile. Este es el host que Collabora debe permitir; no es el nombre de host de Collabora.
• Un secreto de Kubernetes para las credenciales de la consola de administración de Collabora. No guarde la contraseña de ejemplo del gráfico ni incluya una contraseña real en un archivo de valores.

1. Agregue el repositorio oficial de gráficos e inspeccione la versión.

Collabora publica su gráfico desde el repositorio en línea del proyecto. Agréguelo, actualice el índice local e inspeccione los metadatos del gráfico y los valores predeterminados antes de instalarlo:

helm repo add collabora https://collaboraonline.github.io/online/
helm repo update
helm show chart collabora/collabora-online
helm show values collabora/collabora-online

La versión del gráfico identifica el paquete, no necesariamente la etiqueta de imagen CODE. Verifique el repositorio de imágenes y la etiqueta en los valores de lanzamiento, luego fije la versión del gráfico que revisó para actualizaciones repetibles.

Cree un secreto con ámbito de espacio de nombres utilizando su flujo de trabajo de administración de secretos aprobado. Los valores del gráfico admiten un secreto existente y nombres de clave configurables; los nombres de clave predeterminados son usernamey password. Verifique que el secreto exista en el collaboraespacio de nombres antes de instalarlo.

2. Configure las opciones de host, entrada y proxy de WOPI.

Cree my_values.yaml. Reemplace ambos nombres de host de ejemplo con sus dominios públicos reales. El aliasgroupsvalor identifica al cliente WOPI (por ejemplo, el servidor Seafile o Nextcloud). El host Ingress y server_nameidentifican el servicio Collabora al que acceden los navegadores de los usuarios.

replicaCount: 1

ingress:
  enabled: true
  className: nginx
  annotations:
    nginx.ingress.kubernetes.io/upstream-hash-by: "$arg_WOPISrc"
    nginx.ingress.kubernetes.io/proxy-body-size: "0"
    nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
    nginx.ingress.kubernetes.io/proxy-send-timeout: "600"
  hosts:
    - host: office.example.com
      paths:
        - path: /
          pathType: ImplementationSpecific

autoscaling:
  enabled: false

collabora:
  aliasgroups:
    - host: "https://files.example.com:443"
  extra_params: --o:ssl.enable=false --o:ssl.termination=true
  server_name: office.example.com:443
  existingSecret:
    enabled: true
    secretName: collabora-admin
    usernameKey: username
    passwordKey: password

Este ejemplo sigue el patrón de entrada NGINX documentado por Collabora: las solicitudes se cifran mediante el WOPISrcparámetro y los tiempos de espera de lectura y envío del proxy se extienden para las sesiones de documentos. Confirme los nombres de las anotaciones con la versión de su controlador de entrada. Si utiliza HAProxy, consulte las anotaciones y la configuración de balanceo de HAProxy del archivo README del gráfico.

Las opciones ssl.enable=falsey ssl.termination=trueestán diseñadas para un entorno donde TLS finaliza en el ingress y el tráfico desde el ingress al pod es interno. No implican que el endpoint público deba usar HTTP. Mantenga el nombre de host del ingress en HTTPS y no exponga el servicio HTTP simple del pod directamente a internet. Establézcalo server_namecuando Collabora se encuentre detrás de un proxy inverso o no pueda inferir directamente su nombre de host externo.

Para múltiples réplicas fijas, configúrelas replicaCountdeliberadamente y mantenga la afinidad de sesión. El archivo README original indica que HPA está deshabilitado porque el escalado puede interrumpir la edición colaborativa y la función de copiar/pegar. Un mayor número de réplicas por sí solo no garantiza un enrutamiento correcto; confirme que su entrada envía las solicitudes del mismo documento al mismo pod.

3. Instalar Collabora CODE

Instala la versión desde el repositorio oficial y espera a que el despliegue esté listo:

helm install --create-namespace \
  --namespace collabora \
  collabora-online collabora/collabora-online \
  --values my_values.yaml

kubectl get pods -n collabora
kubectl get ingress -n collabora

Si va a actualizar una versión existente, utilice helm upgradeel mismo nombre de versión, espacio de nombres y archivo de valores en lugar de crear una segunda versión. Revise las notas de la versión del gráfico y los cambios realizados antes de actualizar una instancia de producción.

Verifique que el pod esté listo y que el Ingress informe el host y la dirección esperados. Si permanece pendiente, revise los eventos y los registros antes de cambiar la configuración de los recursos.

kubectl describe pods -n collabora
kubectl logs -n collabora deployment/<deployment-name>

Dimensiona la CPU y la memoria según tu carga de trabajo y la capacidad del clúster. El archivo README de la tabla proporciona ejemplos de solicitudes y límites, pero no garantiza su validez para cada implementación. Ten cuidado con la limitación de recursos, los errores de memoria insuficiente (OOM kills) y los reinicios.

4. Verificar el descubrimiento y la edición de documentos.

Una vez que DNS y TLS estén activos, solicite el punto final de descubrimiento de Collabora a través del nombre de host público:

curl -fsS https://office.example.com/hosting/discovery

Una respuesta exitosa debería contener el XML de descubrimiento de WOPI en lugar de una página de error de entrada o una advertencia de certificado. A continuación, configure su cliente WOPI con la misma URL pública de Collabora y confirme que Collabora aliasgroupsincluya el nombre de host y el puerto HTTPS de dicho cliente. La configuración exacta del cliente depende del producto de almacenamiento.

Abra un documento de prueba desde el cliente WOPI y realice un pequeño cambio. Confirme que el editor se carga, que se puede unir una segunda sesión del navegador si se requiere colaboración y que el cambio se guarda en el servicio de almacenamiento. Esta verificación integral pone a prueba el DNS, el TLS de entrada, el enrutamiento de sesiones, la autorización del host WOPI y la transferencia de archivos.

Supuestos comunes que se deben verificar

• “Helm está instalado, por lo que Collabora está listo para producción.” El gráfico crea recursos de Kubernetes, pero el DNS, TLS, la autorización de host WOPI, el enrutamiento de entrada y el dimensionamiento de recursos aún dependen de su clúster. Verifique cada uno de los elementos anteriores.
• «El host de entrada y el host WOPI tienen la misma configuración». A menudo difieren: el host de entrada es la dirección pública de Collabora; el host WOPI es el servidor de almacenamiento. Coloque cada uno en el campo correspondiente del gráfico.
• «Más réplicas mejoran automáticamente la colaboración». El gráfico ascendente documenta la afinidad de sesión y actualmente desactiva HPA porque el escalado puede interrumpir la edición colaborativa. Comience con una réplica o un número fijo deliberado y conserve la afinidad de enrutamiento.
• Se puede proporcionar un pequeño fragmento XML como configuración personalizada. El valor del gráfico coolwsd_xml_contentreemplaza el archivo de configuración predeterminado y requiere el contenido completo del archivo. Se recomienda utilizar los valores específicos del gráfico para los grupos de alias y los parámetros, a menos que se disponga de una configuración XML completa y compatible con la versión.

Referencias oficiales

• Archivo README de implementación del gráfico Helm de Collabora Online
• Valores oficiales de la carta náutica y opciones de configuración
• Versiones del paquete de gráficos de Collabora
• Documentación de Kubernetes Ingress