Collabora Online을 ownCloud Infinite Scale에 연결하세요.

ownCloud Infinite Scale의 Collaboration 서비스를 웹 UI와 Collabora Online 간의 WOPI 브리지로 사용하세요. 새 설치의 경우, ocis_fullInfinite Scale, Collaboration, Collabora 및 Traefik이 포함된 ownCloud의 공식 모듈형 Docker Compose 예제를 사용하는 것이 가장 안전합니다. 공개 Infinite Scale, Collaboration 및 WOPI URL을 설정하고, 유효한 TLS 인증서를 사용하며, 모든 서비스 암호를 일관되게 유지하세요. Infinite Scale을 기존 ownCloud 서버처럼 구성하지 마세요.

이러한 차이점은 ownCloud의 최신 문서에서 확인할 수 있습니다. Infinite Scale은 WOPI와 협업 서비스를 통해 오피스 제품군을 통합합니다. cs3org/wopi최신 릴리스에서는 해당 서비스가 기존의 외부 서버를 대체하므로, 이전 버전을 업그레이드하는 관리자는 설치된 버전에 맞는 마이그레이션 지침을 따라야 합니다.

1. 릴리스 및 네트워크 요구 사항을 확인하십시오.

설치하기 전에 정확한 Infinite Scale 릴리스 버전을 확인하십시오. 현재 ownCloud 문서에는 Collaboration 서비스가 9.0 개발 문서에 포함되어 있으며 Infinite Scale이 관리 모드로 실행될 때 별도로 시작해야 한다고 명시되어 있습니다. ownCloud 풀스택 예제에서도 설정이 Collaboration 서비스가 포함된 릴리스에 의존하며 5.x 프로덕션 릴리스에서는 작동하지 않는다고 경고합니다. 설치된 릴리스 버전에 맞는 문서와 Compose 파일을 사용하십시오. 호환성을 확인하지 않고 롤링 예제를 이전 프로덕션 시스템에 복사하지 마십시오.

cloud.example.com공개 배포의 경우, `<hostname>`, ` <hostname>`, `<hostname>` office.example.com과 같이 별도의 호스트 이름을 계획하십시오 wopi.example.com. 브라우저는 클라우드 및 Collabora URL에 모두 접속할 수 있어야 하며, Collabora는 Infinite Scale에서 제공하는 WOPI 엔드포인트에 접속할 수 있어야 합니다. DNS, 방화벽 및 TLS 신뢰는 양방향으로 작동해야 합니다. 노트북에서는 접속 가능하지만 Collabora 컨테이너에서는 접속할 수 없는 호스트는 충분하지 않습니다.

ownCloud의 배포 예제는 Traefik을 리버스 프록시로 사용하며 서버 설정에 유효한 SSL 인증서가 필요하다고 가정합니다. 로컬 테스트 환경에서는 자체 서명 인증서를 사용할 수 있지만, 공개 설치 환경에서는 인증서 검증을 자동으로 비활성화해서는 안 됩니다. 스택을 구성하기 전에 사용할 호스트 이름과 인증서를 결정하십시오.

2. ownCloud의 해당 Compose 예제부터 시작하세요.

1. ownCloud의 공식 전체 모듈형 oCIS(WebOffice 포함) 배포 가이드와 해당 ocis_full 예제 디렉토리를 엽니다 . 프로덕션 환경에서는 저장소의 롤링 브랜치에 의존하는 대신 Infinite Scale 버전에 맞는 릴리스 또는 태그를 체크아웃하세요.
2. 예제 .env파일을 검토하세요. OCIS_DOMAIN, COLLABORA_DOMAIN, 및 WOPISERVER_DOMAIN를 서버로 확인되는 호스트 이름으로 설정하세요. 예제에서는 를 사용하여 Collabora를 활성화했습니다 COLLABORA=:collabora.yml. Collabora를 사용하려는 오피스 편집기인 경우 해당 설정을 유지하세요.
3. 강력하고 안전한 관리자 자격 증명을 설정하고 예제의 프로덕션 TLS 지침을 따르십시오. 예제 암호를 그대로 두지 마십시오. 저장소 버전에서 환경 변수 이름이나 파일 레이아웃이 변경된 경우, 서로 다른 버전의 지침을 혼합하여 사용하지 말고 동일한 태그가 지정된 릴리스의 파일을 사용하십시오.
4. 시작하기 전에 Compose 구성을 검토하십시오. Collabora, Collaboration, Infinite Scale 및 프록시 서비스가 의도한 네트워크 및 구성을 공유하는지 확인하십시오. ownCloud 가이드에서는 Collaboration이 별도의 컨테이너에서 실행되는 경우 관련 Infinite Scale 구성 및 생성된 비밀 키를 다른 서비스와 공유해야 한다고 경고합니다.

이 배포 예시는 통합 스택이며, 모든 기존 설치에 적용 가능한 범용 구성이 아닙니다. 이미 systemd, Kubernetes 또는 사용자 지정 리버스 프록시를 사용하여 Infinite Scale을 실행 중인 경우, 기존 배포 모델을 유지하고 해당 릴리스의 설명서를 참조하여 협업 서비스와 앱 레지스트리를 구성하십시오. 두 번째 전체 스택을 새로 구축할 필요는 없습니다.

3. WOPI를 사용하여 Collabora에 협업 기능을 연결합니다.

핵심 설정은 편집기 URL과 외부에서 접근 가능한 WOPI 소스를 식별합니다. 현재 서비스 문서에서 COLLABORATION_APP_NAME는 앱의 표시 이름이고, 는 COLLABORATION_APP_PRODUCT제품을 식별하며, COLLABORATION_APP_ADDR는 Collabora를 가리키고, 는 COLLABORATION_WOPI_SRCCollabora가 Infinite Scale을 통해 파일을 읽고 쓰는 데 사용하는 URL입니다. 개념적인 구성은 다음과 같습니다.

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

배포 환경에 필요한 실제 공개 URL과 변수 형식을 사용하십시오. 서비스가 내부 컨테이너 네트워크에서 통신하는 경우, 내부 주소는 특정 설정에 적합할 수 있지만 브라우저에 표시되는 URL은 다른 설정에 적합할 수 있습니다. Collabora가 외부에서 확인해야 하는 값에 컨테이너 전용 호스트 이름을 사용하지 마십시오.

협업 서비스는 Infinite Scale 런타임 값인 OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, 및 도 필요로 합니다 MICRO_REGISTRY_ADDRESS. 이러한 값은 실행 중인 인스턴스와 일치해야 합니다. 공식 풀스택 예제는 자체 Compose 네트워크에 대한 서비스 관계를 제공합니다. 불일치를 우회하기 위해 특정 서비스만을 위한 새로운 비밀 키를 생성하거나 WOPI 증명 키 검사를 비활성화하지 마십시오. 신뢰할 수 있는 공개 인증서의 경우 인증서 확인을 활성화된 상태로 유지하십시오. COLLABORATION_APP_INSECURE는 자체 서명된 WOPI 앱 인증서에 대한 옵션으로만 문서화되어 있으며 일반적인 프로덕션 환경 해결 방법은 아닙니다.

앱 레지스트리는 각 MIME 유형에 대해 표시되는 오피스 앱과 기본적으로 열리는 앱을 제어합니다. Collabora가 실행 중이지만 문서에 '다음으로 열기' 옵션이 표시되지 않으면 레지스트리의 MIME 유형 구성과 해당 default_app값을 확인하십시오. 여기에 사용된 이름은 구성된 오피스 앱 이름과 일치해야 합니다. ownCloud는 이를 YAML 구성으로 문서화하며, 환경 변수는 MIME 유형 매핑을 대체하지 않습니다.

4. 통합 시작, 테스트 및 진단

공식 Compose 예제를 사용하여 렌더링된 구성을 검증한 다음 배포 디렉터리에서 스택을 시작하세요.

docker compose config
docker compose up -d

Compose 예제를 사용하지 않는 경우, 먼저 게이트웨이, 앱 공급자 및 Collabora 서비스를 시작해야 합니다. 관리 모드에서는 ownCloud 문서에서 Collaboration 서비스를 명시적으로 시작하도록 안내하고 ocis collaboration server있으며, 자동으로 시작되지 않습니다. Collaboration 서비스 프로세스에서 필요한 환경 변수가 설정되었는지 확인한 후 서비스를 시작하십시오.

1. https://office.example.com/hosting/discovery브라우저에서 여세요 . 연결 가능한 엔드포인트는 DNS, TLS 또는 프록시 오류가 아닌 Collabora의 검색 XML을 반환해야 합니다.
2. Infinite Scale에 로그인하고 지원되는 문서를 연 다음, UI에 여러 오피스 앱이 표시되면 Collabora를 선택하세요. 기존 파일과 (앱 레지스트리에서 활성화된 경우) 새 문서 생성 기능을 모두 테스트해 보세요.
3. 간단한 수정을 하고 저장 표시기가 안정될 때까지 기다린 후 편집기를 닫고 파일을 다시 열어 변경 사항이 저장되었는지 확인하십시오.
4. 편집기가 열리지 않으면 Infinite Scale Collaboration 및 앱 공급자 로그, Collabora 로그, 역방향 프록시 로그를 동일한 타임스탬프로 확인하십시오. "권한 없는 WOPI 호스트"는 Collabora의 WOPI 신뢰 구성 문제를 나타내고, 콜백 실패 또는 TLS 오류는 URL 연결 가능성 또는 인증서 신뢰 문제를 나타내며, 앱 옵션 누락은 앱 레지스트리 문제를 나타냅니다.

통합이 성공적으로 완료되면 브라우저에서 에디터가 로드되고, WOPI 연결이 Infinite Scale에 도달하며, 브라우저를 다시 열었을 때 편집 내용이 유지됩니다. 정확한 컨테이너 이름, URL 연결 및 구성 파일 위치는 Infinite Scale 릴리스 및 배포 방법에 따라 다릅니다. 특히 기존 외부 WOPI 서버에서 마이그레이션하는 경우, 해당 릴리스에 맞는 ownCloud 설명서를 참조하여 자세한 내용을 확인하십시오.

참고 자료: ownCloud 협업 서비스 구성 , ownCloud 앱 레지스트리 구성 , Infinite Scale 릴리스 노트 및 마이그레이션 노트 .