Collabora Online CODE Docker에 사용자 지정 글꼴을 추가하는 방법

Docker에서 실행되는 Collabora Online CODE(Collabora Online 개발 버전)에서 사용자 지정 글꼴을 사용하려면 글꼴 파일이 Collabora 컨테이너 자체에서 사용 가능해야 합니다. 글꼴 파일을 Docker 호스트 또는 별도의 Nextcloud 컨테이너에만 설치하면 사무실 서버에서 사용할 수 없습니다. 단일 Compose 배포의 경우 읽기 전용 바인드 마운트가 일반적으로 가장 간단한 옵션입니다. 사용자 지정 이미지는 관리되는 여러 환경에서 쉽게 복제할 수 있으며, 원격 글꼴 구성은 안전하게 운영할 수 있다면 배포를 중앙 집중화할 수 있습니다.

글꼴 디렉터리의 정확한 위치는 이미지 및 릴리스에 따라 다를 수 있습니다. Collabora의 현재 업스트림 Helm 배포는 사용자 지정 글꼴을 두 위치 모두에 마운트합니다 /usr/share/fonts/custom. /opt/cool/systemplate/usr/share/fonts/custom이는 두 위치를 참조하는 데 유용한 정보이지만, 모든 독립 실행형 Docker 태그에서 동일하게 적용되는 것은 아닙니다. 아래 예제를 배포하기 전에 실제로 실행하는 이미지의 경로를 확인하십시오.

어떤 글꼴 설치 방법이 사용 환경에 적합합니까?

유지 관리하는 CODE 인스턴스 수, 업데이트 배포 방식, 그리고 안전한 폰트 호스트 운영 가능 여부에 따라 선택하십시오.

Collabora를 Helm 차트를 사용하여 설치하는 경우, 먼저 차트 deployment.customFonts설정을 확인하세요. 업스트림 차트에는 이미 사용자 지정 글꼴 마운트 옵션이 제공됩니다. 독립형 Docker Compose 설정의 경우, 이미지 경로가 일치하면 바인드 마운트를 사용하세요.

상위 Helm 배포 템플릿과 두 개의 글꼴 마운트 위치를 검토하고 차트 의 사용자 지정 글꼴 값을 확인하십시오 .

Docker를 변경하기 전에 무엇을 확인해야 할까요?

• 글꼴 형식: Collabora 설정에서 지원하는 글꼴 파일을 사용하십시오. Collabora 공식 글꼴 서버 프로젝트 문서에는 TrueType( .ttf) 및 OpenType( .otf) 파일이 설명되어 있습니다.
• 라이선스: 글꼴 라이선스가 서버 측 사용 및 사용자 배포를 허용하는지 확인하십시오. 라이선스에서 허용하지 않는 한 데스크톱 운영 체제에서 글꼴을 복사하지 마십시오.
• 패밀리 이름: 글꼴 메뉴에 표시되는 이름은 글꼴의 내부 메타데이터에서 가져오며, 파일 이름과 다를 수 있습니다. 파일 이름만 사용하지 말고 패밀리 이름을 사용하여 테스트하십시오.
• 모든 인스턴스: 프록시가 사용자를 여러 Collabora 컨테이너로 라우팅하는 경우 모든 인스턴스에 동일한 글꼴 파일을 설치하십시오. 그렇지 않으면 동일한 문서라도 어떤 서버에서 열느냐에 따라 다르게 표시될 수 있습니다.
• 정확한 이미지 경로:/opt/lool 실행 중인 이미지의 디렉터리와 시작 구성을 확인하십시오. 관련 없는 패키지의 경로 와 같은 이전 경로를 무분별하게 재사용하지 마십시오 .

./fonts작성 파일 옆에 호스트 디렉터리를 만들고 허용된 .ttf글꼴 .otf파일들을 그 안에 넣으세요. 디렉터리에는 Collabora를 통해 노출하려는 글꼴 파일만 넣어두세요.

Docker Compose를 사용하여 글꼴을 추가하는 방법은 무엇입니까?

기존 Collabora 서비스 volumes목록에 읽기 전용 볼륨 항목 두 개를 추가합니다. 서비스의 현재 이미지, 포트, 환경 변수 및 기타 설정은 그대로 유지합니다. 이는 기존 Compose 파일을 대체하는 것이 아니라 추가하는 것입니다.

services:
  collabora:
    volumes:
      - ./fonts:/usr/share/fonts/custom:ro
      - ./fonts:/opt/cool/systemplate/usr/share/fonts/custom:ro

왼쪽의 소스 디렉터리는 Docker 호스트에 있습니다. 오른쪽의 경로는 컨테이너 내부의 경로입니다. :ro접미사는 컨테이너 내에서 해당 파일을 읽기 전용으로 만듭니다. 이러한 대상 경로는 Collabora의 최신 Helm 템플릿을 따릅니다. 독립 실행형 CODE Docker의 경우, 먼저 정확한 태그를 확인하십시오. 두 위치 중 하나라도 없거나 릴리스에서 다른 디렉터리를 사용하는 경우, 이 예제를 강제로 사용하는 대신 해당 이미지에서 지원하는 경로를 사용하십시오.

Collabora 서비스를 다시 생성하면 활성 편집 세션이 중단될 수 있으므로, 작업이 뜸한 시간에 작성 변경 사항을 적용하세요. 서비스 이름이 인 경우 다음 명령 collabora을 실행하세요.

docker compose up -d collabora

Compose 서비스 이름이 다르면 실제 서비스 이름을 사용하십시오. 다른 서비스에도 구성 변경이 필요한 경우가 아니면 전체 스택을 재시작하지 마십시오.

컨테이너가 파일을 볼 수 있는지 어떻게 확인할 수 있나요?

먼저 마운트된 디렉터리에 글꼴 파일이 있는지 확인하십시오. collabora컨테이너 이름은 사용 중인 설정에 맞게 변경하십시오.

docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom

파일을 확인하면 Docker 마운트가 제대로 되었음을 알 수 있지만, 편집기가 글꼴을 로드했는지 여부는 증명할 수 없습니다. 이미지에 Fontconfig 유틸리티가 포함되어 있다면, fc-list예를 들어 다음과 같이 검색된 글꼴 패밀리 이름을 확인할 수 있습니다.

docker exec collabora fc-list : family file

컨테이너에서 사용 가능한 도구를 사용하여 원하는 글꼴 패밀리에 맞게 출력을 필터링하세요. 해당 도구가 fc-list설치되어 있지 않은 경우, 실행 중인 컨테이너에 패키지를 추가하여 영구적인 해결책으로 사용하지 마세요. 이미지의 글꼴 구성을 확인하거나 재현 가능한 사용자 지정 이미지를 사용하세요. 파일이 표시되지만 검색되지 않는 경우, 권한, 파일 형식, 내부 패밀리 메타데이터 및 두 마운트 경로를 모두 확인하세요. 그런 다음 배포한 이미지 및 릴리스의 로그를 참조하세요.

Collabora Online에서 글꼴을 테스트하는 방법은 무엇인가요?

1. Collabora 편집기를 실행하는 일반적인 통합 기능을 통해 테스트 문서를 열거나 생성하세요.
2. 글꼴 패밀리 메뉴를 열고 글꼴의 내부 패밀리 이름을 찾으세요.
3. 해당 항목을 선택하고 간단한 샘플을 입력한 다음 저장하고 문서를 닫았다가 다시 여세요.
4. Collabora 인스턴스가 여러 개 배포된 경우 다른 사용자 또는 브라우저에서 동일한 문서를 확인할 수 있습니다.

아래 예시는 예상되는 검사 유형을 보여줍니다. 글꼴 패밀리가 편집기 메뉴에 나타나는지 확인하는 것입니다. 이 예시는 실제 CODE 배포 환경에서 캡처한 것이 아니며, 버전이나 통합 방식에 따라 툴바가 다를 수 있습니다.

글꼴 패밀리는 표시되지만 텍스트가 다른 글꼴로 표시되는 경우, 선택한 글꼴과 굵기(예: 보통 및 굵게)가 존재하는지 확인하고, 시스템플레이트 경로와 일반 글꼴 디렉터리 모두에 해당 글꼴이 있는지 확인하십시오. 메뉴 항목만으로는 모든 스타일이나 모든 서버에 해당 글꼴이 있다는 것을 보장할 수 없습니다.

맞춤 이미지 또는 원격 글꼴 서비스는 언제 가치가 있을까요?

반복성을 위해 사용자 지정 이미지를 생성합니다.

선택한 CODE 이미지에서 사용하는 경로에 승인된 글꼴 파일을 복사하는 Dockerfile을 사용하면 배포 재현이 더 쉬워집니다. 이미지 다이제스트를 통해 서버 빌드와 글꼴 세트를 모두 식별할 수 있기 때문입니다. 단, 글꼴이나 기본 이미지를 업데이트할 때마다 다시 빌드하고, 스캔하고, 배포해야 합니다. 기본 이미지 업그레이드 후에는 대상 디렉터리를 다시 확인하고, 글꼴 복사 지침이 모든 CODE 버전에서 동일하게 적용되는 것은 피해야 합니다.

공유 카탈로그에 원격 글꼴 구성을 사용하세요.

Collabora의 fontserver 프로젝트는 원격 글꼴 구성 및 JSON 카탈로그에 대한 정보를 제공합니다. 해당 저장소는 개발 및 테스트용으로 제공되므로 샘플 서버를 프로덕션 환경에서 사용할 목적으로 사용하지 마십시오. 프로덕션 환경에서는 제대로 관리되는 HTTPS 엔드포인트를 사용하고, 제공되는 글꼴을 제한 및 검증하며, 네트워크 가용성과 캐시 갱신 동작을 고려해야 합니다. 이 방법을 사용하면 호스트별 파일 관리 부담을 줄일 수 있지만, 서비스 장애 또는 구성 변경으로 인해 글꼴 가용성에 영향을 미칠 수 있다는 단점이 있습니다.

이 방법을 선택하기 전에 Collabora 공식 폰트 서버 프로젝트 및 Collabora 구성 문서를 참조하여 원격 폰트 사용 가능 여부를 확인 하십시오.

어떤 옵션을 선택해야 할까요?

Docker Compose로 관리되는 단일 CODE 컨테이너의 경우, 읽기 전용 바인드 마운트로 시작하세요. 롤백이 간단하고 사용자 지정 빌드가 필요하지 않습니다. CI/CD를 통해 관리되는 컨테이너 집단의 경우, 각 배포에 명시적이고 검토 가능한 글꼴 세트를 포함시키려면 사용자 지정 이미지를 사용하는 것이 좋습니다. 중앙 집중식 배포가 실질적인 운영상의 이점을 제공하고 안전하고 안정적인 HTTPS 서비스를 제공할 수 있는 경우에만 원격 글꼴 구성을 고려하세요. 모든 경우에 배포 후 경로를 확인하고 실제 문서에서 글꼴을 테스트하세요. 호스트의 글꼴 목록만으로는 Collabora가 글꼴을 로드했는지 확인할 수 없습니다.