배포 변경 사항을 손실하지 않고 Collabora CODE 설정을 복원하는 방법

Collabora CODE 컨테이너는 재구축 후 기본 설정으로 다시 시작될 수 있으며, 서버 오류로 인해 구성 파일의 작업 복사본을 사용할 수 없게 될 수도 있습니다. coolwsd.xml설정을 제공하는 활성 파일과 배포 파일을 백업하십시오. 백업한 파일을 동일한 영구 저장소에 복원한 다음, 사용자가 편집을 재개하기 전에 파일과 서비스의 유효성을 검사하십시오.

주요 파일은 일반적으로 입니다 /etc/coolwsd/coolwsd.xml. 패키지, Docker 및 Helm 설치에 따라 소스 파일이 다르므로 복사하기 전에 배포 환경을 확인해야 합니다.

1. 활성 구성 소스를 찾습니다.

패키지 설치 시에는 호스트 파일을 검사하십시오. Docker 환경에서는 실행 중인 컨테이너 내부의 파일을 검사하여 호스트 파일이나 디렉터리가 마운트되었는지 확인하십시오. Compose 파일, 참조된 환경 파일 또는 Helm 값도 보존해야 합니다. 이러한 파일에 제공된 시작 옵션은 XML에 저장되지 않을 수 있습니다.

sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml

컨테이너 이름을 실제 이름으로 바꾸세요 collabora-code. Collabora의 구성 및 Docker 문서에는 이러한 배포 경로가 설명되어 있으며, 상위 Helm 차트는 차트 수준 설정을 제공합니다. 사용 중인 릴리스의 문서를 참조하세요. 기본값 및 배포 동작은 버전 간에 변경될 수 있습니다.

2. XML 및 배포 파일 백업

날짜가 표시된 사본을 접근이 제한된 디렉터리에 저장하십시오. 구성 정보에는 허용된 WOPI 호스트, 프록시 동작, 인증서 경로 또는 관리 설정이 포함될 수 있습니다. 백업 파일은 민감한 운영 데이터로 취급해야 합니다.

패키지 설치 시 파일 메타데이터를 보존하십시오.

sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml

Docker 환경에서는 컨테이너에서 호스트로 실행 중인 파일을 복사합니다.

mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
  ~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml

바인드 마운트를 통해 파일이 제공되는 경우 호스트 측 소스 파일도 백업하십시오. 이 파일은 컨테이너 재시작 시 컨테이너 내부 편집 내용을 덮어쓸 수 있습니다. Compose 파일과 참조되는 모든 .env파일을 동일한 보호된 백업 세트에 보관하십시오. Helm의 경우, 정확한 값 파일과 릴리스 ID, 그리고 기존 비밀 관리 프로세스를 사용하여 별도로 관리되는 Secret 또는 ConfigMap을 저장하십시오.

3. 백업을 재현 가능하게 만드세요

CODE 이미지 태그 또는 패키지 버전, 컨테이너 이름, 마운트 소스 및 백업 날짜를 기록해 두십시오. 패키지 설치 시 cp -a메타데이터를 보존하는 데 사용할 수 있습니다. 컨테이너 파일 소유권은 호스트와 다를 수 있으므로 호스트 소유자 또는 모드가 모든 이미지 버전에 적합하다고 가정하지 마십시오.

Compose를 사용할 때 파일 또는 전체 디렉터리가 마운트되었는지 확인하십시오 /etc/coolwsd. 디렉터리가 마운트되면 이미지에 포함된 파일이 숨겨질 수 있으며, 디렉터리가 불완전하면 예상되는 파일을 사용할 수 없게 될 수 있습니다. CODE가 사용하는 마운트된 디렉터리의 모든 파일을 백업하십시오. 환경 설정은 별도로 보관하고 기밀 정보를 보호하십시오.

Helm을 사용하는 경우, 생성된 Pod를 직접 편집하는 것은 권장하지 않습니다. 업그레이드 과정에서 Pod가 다시 생성될 수 있기 때문입니다. 차트 값과 외부 Secret 또는 ConfigMap은 반드시 보존하십시오. Collabora의 업스트림 차트는 값을 통해 구성 콘텐츠를 지원하므로, 실행 중인 Pod에서 복사한 값보다 업스트림 차트의 소스 값이 더 신뢰할 수 있습니다.

4. 영구 저장소로 복원

CODE를 중지하거나 유지 관리 기간을 사용하십시오. 파일을 교체하기 전에 현재 파일을 저장하십시오. 패키지 설치의 경우, 선택한 백업을 복원하고 해당 패키지에서 요구하는 소유권 및 모드를 유지하십시오.

sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd

샘플 소유자 및 그룹이 패키지와 일치하지 않을 수 있습니다. stat샘플 값을 그대로 적용하기보다는 기존 파일을 확인하고 예상되는 소유권 및 모드를 유지하십시오. 바인드 마운트된 컨테이너의 경우 호스트 파일을 복원하고 Compose 재시작 또는 재생성 워크플로를 따르십시오. 사용자 지정 이미지 또는 Helm 값이 구성을 제공하는 경우 해당 소스를 업데이트하고 다시 배포하십시오. 일회용 컨테이너를 편집해도 변경 사항은 저장되지 않습니다.

주요 버전 변경 후 복원하기 전에 구성을 검토하십시오. 옵션은 릴리스 간에 변경될 수 있으므로 저장된 파일을 대상 버전의 템플릿 및 마이그레이션 참고 사항과 비교하십시오. XML 복원 시 인증서, 개인 키, 사용자 지정 글꼴 또는 역방향 프록시 구성은 별도로 백업하지 않은 경우 복원되지 않습니다.

5. 편집을 다시 시작하기 전에 확인하십시오.

파일이 존재하는지, 서비스에서 읽을 수 있는지, 그리고 올바른 형식의 XML인지 확인하십시오. 설치되어 있는 경우 xmllint구문을 확인하십시오.

xmllint --noout /etc/coolwsd/coolwsd.xml

이는 XML 구문만 확인하는 것이며, 사용 중인 CODE 버전에서 모든 옵션이 지원되는지 증명하는 것은 아닙니다. 구문 분석 오류가 있는지 로그를 확인하고 서비스가 계속 실행 중인지 확인하십시오. 컨테이너의 경우 docker compose ps최근 로그를, 패키지의 경우 systemctl status coolwsd시스템 저널을 확인하십시오.

마지막으로, 일반적인 WOPI 호스트를 통해 문서를 열고 문서가 로드되고 저장되는지 확인합니다. CODE가 시작되지만 문서 로드에 실패하는 경우, 복원된 허용 목록, 외부 호스트 이름, TLS 종료 및 프록시 설정을 배포된 설정과 비교합니다. 시작에 실패하면 복원 전 상태로 되돌린 후 파일을 비교하고 다시 시도하십시오.

• 백업 버전과 배포 버전이 일치하는지 확인하십시오.
• 마운트 또는 Helm 값이 복원된 소스를 가리키는지 확인하십시오.
• XML 구문 분석 및 서비스 시작이 성공적으로 완료되었는지 확인하십시오.
• 연결된 스토리지 플랫폼을 통해 파일 열기 및 저장 기능을 테스트합니다.

공식 참조

• Collabora 온라인 구성 문서
• Collabora CODE Docker 이미지 문서
• Collabora 업스트림 Helm 차트 값
• Docker 바인드 마운트 문서