Implementează Collabora CODE pe Kubernetes cu Helm

Începând cu 10 octombrie 2026, registrul pachetelor din amonte listează versiunea 1.3.0 a diagramei ca fiind cea mai recentă versiune. Instalarea diagramei este doar o parte a unei implementări funcționale. De asemenea, aveți nevoie de un nume de gazdă Collabora public, o intrare validă în lista de permisiuni WOPI pentru gazda de stocare a documentelor și o configurație de intrare care să păstreze cererile pentru fiecare document pe același pod. Registrul pachetelor din amonte listează versiunea 1.3.0 a diagramei la momentul scrierii; verificați depozitul înainte de instalare, deoarece versiunea diagramei Helm și versiunea imaginii containerului CODE sunt valori separate.

Această procedură folosește graficul oficial collabora/collabora-onlineși un controler de intrare NGINX. Fișierul README al graficului include și exemple de HAProxy; adnotările de intrare sunt specifice controlerului, așa că folosiți exemplul pentru controlerul instalat, în loc să amestecați adnotările.

Ce să pregătești mai întâi

• Un cluster Kubernetes cu permisiunea de a crea un spațiu de nume, o implementare, un serviciu și un ingres.
• Helm 3 și un controler de intrare instalat care poate furniza HTTPS pentru un nume de gazdă precum office.example.com.
• Numele public de gazdă al clientului WOPI, cum ar fi Nextcloud sau Seafile. Aceasta este gazda pe care Collabora trebuie să o permită; nu este numele de gazdă Collabora.
• Un secret Kubernetes pentru acreditările consolei de administrare Collabora. Nu păstrați parola exemplu a graficului și nu salvați o parolă reală într-un fișier de valori.

1. Adăugați depozitul oficial de diagrame și inspectați versiunea

Collabora își publică diagrama din depozitul online al proiectului. Adăugați-o, actualizați indexul local și verificați metadatele și valorile implicite ale diagramei înainte de instalare:

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

Versiunea diagramei identifică pachetul, nu neapărat eticheta imaginii CODE. Verificați depozitul de imagini și eticheta din valorile versiunii, apoi fixați versiunea diagramei pe care ați revizuit-o pentru actualizări repetabile.

Creați un Secret cu domeniul de spațiu de nume utilizând fluxul de lucru aprobat pentru gestionarea secretelor. Valorile diagramei acceptă un Secret existent și nume de chei configurabile; numele de chei implicite sunt usernameși password. Verificați dacă Secretul există în spațiul collaborade nume înainte de instalare.

2. Setați opțiunile WOPI pentru gazdă, intrare și proxy

Creați my_values.yaml. Înlocuiți ambele nume de gazdă exemplu cu domeniile publice reale. Valoarea aliasgroupsidentifică clientul WOPI (de exemplu, serverul Seafile sau Nextcloud). Gazda Ingress și server_nameidentificați serviciul Collabora pe care îl accesează browserele utilizatorilor.

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

Acest exemplu urmează modelul de intrare NGINX documentat de Collabora: cererile sunt codificate prin hashing folosind WOPISrcparametrul, iar timeout-urile de citire și trimitere ale proxy-ului sunt extinse pentru sesiunile de documente. Confirmați numele adnotărilor în funcție de versiunea controlerului de intrare. Dacă utilizați HAProxy, utilizați în schimb adnotările HAProxy și configurația de echilibrare din fișierul README al diagramei.

Opțiunile ssl.enable=falseși ssl.termination=truesunt pentru un design în care TLS se termină la intrare, iar traficul de la intrare la pod este intern. Acestea nu înseamnă că endpoint-ul public ar trebui să utilizeze HTTP. Păstrați numele de gazdă de intrare pe HTTPS și nu expuneți serviciul HTTP simplu al pod-ului direct la internet. Setați server_nameatunci când Collabora se află în spatele unui proxy invers sau nu poate deduce direct numele său de gazdă extern.

Pentru mai multe replici fixe, setați replicaCountîn mod deliberat și păstrați afinitatea de sesiune. Fișierul README din amonte spune în prezent că HPA este dezactivat deoarece scalarea poate perturba editarea colaborativă și copierea/lipirea. Un număr mai mare de replici nu oferă o rutare corectă; confirmați că intrarea dvs. trimite cereri pentru același document către același pod.

3. Instalați CODUL Collabora

Instalați versiunea din depozitul oficial și așteptați ca implementarea să fie gata:

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

Dacă actualizați o versiune existentă, utilizați-o helm upgradecu același nume de versiune, spațiu de nume și fișier de valori, în loc să creați o a doua versiune. Consultați notele de lansare ale graficului și modificările redate înainte de a actualiza o instanță de producție.

Verificați dacă pod-ul este gata și dacă Ingress raportează gazda și adresa așteptate. Dacă rămâne în așteptare, verificați evenimentele și jurnalele înainte de a modifica setările resurselor:

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

Dimensionați CPU-ul și memoria pentru sarcina de lucru și capacitatea clusterului. Diagrama README oferă exemple de solicitări și limite, nu o garanție pentru fiecare implementare. Fiți atenți la limitarea activității, întreruperile OOM și reporniri.

4. Verificarea descoperirii și a editării documentelor

După ce DNS și TLS sunt active, solicitați endpoint-ul de descoperire Collabora prin intermediul numelui de gazdă public:

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

Un răspuns reușit ar trebui să conțină fișierul XML de descoperire WOPI, nu o pagină de eroare de intrare sau un avertisment de certificat. Apoi, configurați clientul WOPI cu aceeași adresă URL publică Collabora și confirmați că adresa URL Collabora aliasgroupsinclude numele de gazdă HTTPS și portul clientului respectiv. Setările exacte ale clientului depind de produsul de stocare.

Deschideți un document de test din clientul WOPI și faceți o mică modificare. Confirmați că editorul se încarcă, că o a doua sesiune de browser se poate alătura dacă este necesară colaborarea, iar modificarea este salvată înapoi în serviciul de stocare. Această verificare end-to-end verifică DNS, TLS de intrare, rutarea sesiunii, autorizarea gazdei WOPI și transferul de fișiere.

Presupuneri comune de verificat

• „Helm instalat, deci Collabora este pregătit pentru producție.” Graficul creează resurse Kubernetes, dar DNS, TLS, autorizarea gazdei WOPI, rutarea de intrare și dimensionarea resurselor depind în continuare de clusterul dvs. Verificați fiecare element de mai sus.
• „Gazda de intrare și gazda WOPI au aceeași setare.” Adesea diferă: gazda de intrare este adresa publică a Collabora; gazda WOPI este serverul de stocare. Plasați fiecare în câmpul corect din diagramă.
• „Mai multe replici îmbunătățesc automat colaborarea.” Graficul din amonte documentează afinitatea sesiunii și dezactivează în prezent HPA deoarece scalarea poate perturba editarea colaborativă. Începeți cu o singură replică sau cu un număr fix deliberat și păstrați afinitatea de rutare.
• „Un mic fragment XML poate fi furnizat ca configurație personalizată.” Valoarea diagramei coolwsd_xml_contentînlocuiește fișierul de configurare implicit și necesită conținutul complet al fișierului. Preferați valorile dedicate ale diagramei pentru grupuri de aliasuri și parametri, cu excepția cazului în care aveți o configurație XML completă, compatibilă cu versiunea.

Referințe oficiale

• Fișier README pentru implementarea diagramei Collabora Online Helm
• Valorile oficiale ale graficului și opțiunile de configurare
• Versiuni pachet diagramă Collabora
• Documentație Kubernetes Ingress