안전한 야간 크론 작업을 사용하여 ownCloud 데이터베이스 덤프를 자동화하세요.
ownCloud 서버에 대한 보호된 MariaDB 덤프를 예약하고, 유지 관리 모드를 안전하게 처리하며, 사용하기 전에 각 백업을 검증합니다.
현재 버전 참고: ownCloud의 최신 문서에서는 Classic 11.0을 안정적인 릴리스 버전으로 명시하고 있으며, Classic 11은 Docker 기반 설치만 지원한다고 합니다. 해당 배포를 위한 안정적인 자동화 방법은 Docker Compose 프로젝트 디렉터리의 스크립트를 실행하는 호스트 cron 작업입니다. MariaDB 기반 스택의 경우, 스크립트는 유지 관리 모드를 잠시 활성화하고, 웹 서비스를 중지하고, 데이터베이스를 내보내고, 압축 파일의 유효성을 검사한 후 ownCloud를 다시 시작합니다. ownCloud는 유지 관리 모드 및 데이터베이스 도구 덤프에 대한 내용을 백업 절차mysqldump 의 일부로 문서화하고 있습니다 .
이 예제에서는 공식 Compose 서비스 이름 owncloud과 를 사용합니다 mariadb. ownCloud Server 10.16을 실행하거나 Docker를 사용하지 않는 설치 환경 또는 PostgreSQL을 사용하는 경우, 스크립트를 변경하지 않고 복사하는 대신 해당 배포 환경에 맞는 서비스 이름과 데이터베이스별 명령어를 사용하십시오.
Docker Compose가 실행되는 호스트에서 백업을 실행하고, ownCloud 웹 컨테이너 내부에서는 실행하지 마십시오. Compose 프로젝트 디렉터리에 MariaDB 클라이언트가 백업 스크립트나 crontab에 암호를 입력하지 않고도 읽을 수 있는 클라이언트 옵션 파일을 생성하십시오.
mkdir -p secrets
nano secrets/db-backup-client.cnf
덤프에 사용할 데이터베이스 계정을 입력하십시오. 공식 샘플 스택의 경우 MariaDB 루트 암호가 배포 환경에 이미 구성되어 있습니다. 프로덕션 환경에서는 MariaDB 버전에 필요한 권한만 있는 전용 백업 계정을 사용하는 것이 좋습니다.
[client]
user=root
password=REPLACE_WITH_YOUR_DATABASE_PASSWORD
host=localhost
호스트에서 해당 파일에 대한 읽기 권한을 배포 관리자만 갖도록 제한합니다.
chmod 600 secrets/db-backup-client.cnf
해당 파일을 MariaDB 서비스에 Compose 시크릿으로 마운트합니다. secrets기존 mariadb서비스 아래에 항목을 추가하고 최상위 수준에서 시크릿을 선언합니다. Compose 파일의 다른 모든 설정은 그대로 유지합니다.
services:
mariadb:
secrets:
- db_backup_client
secrets:
db_backup_client:
file: ./secrets/db-backup-client.cnf
Compose는 이 파일을 MariaDB 컨테이너의 해당 경로에 제공합니다 /run/secrets/db_backup_client. 새 마운트를 적용하려면 Compose 구현에서 해당 서비스를 다시 생성하거나 재시작해야 하는 경우, 해당 서비스를 다시 생성하거나 재시작하십시오. 실제 설치 환경에서는 문서에 있는 예시 암호를 사용하지 마십시오.
루트 권한으로 생성하세요 /usr/local/sbin/owncloud-db-backup. 이 버전은 프로젝트가 에 위치하고 /srv/owncloud덤프 파일을 별도의 호스트 디렉터리에 저장한다고 가정합니다. 두 경로 모두 서버에 맞게 변경하세요. 유지 관리 모드 및 앱 서비스 중지는 매일 밤 짧은 시간 동안 서비스를 중단시키지만, 내보내기 과정 중에 웹 요청으로 인해 데이터가 변경되는 것을 방지합니다. 정리 트랩은 명령 실행이 실패할 경우 서비스를 재시작하고 유지 관리 모드를 해제하려고 시도합니다.
#!/usr/bin/env bash
set -Eeuo pipefail
cd /srv/owncloud
BACKUP_DIR=/srv/backups/owncloud-db
STAMP=$(date -u +%Y%m%dT%H%M%SZ)
TMP="$BACKUP_DIR/.owncloud-db-$STAMP.sql.gz.tmp"
FINAL="$BACKUP_DIR/owncloud-db-$STAMP.sql.gz"
install -d -m 700 "$BACKUP_DIR"
exec 9>/run/lock/owncloud-db-backup.lock
flock -n 9 || { echo "Backup already running" >&2; exit 1; }
maintenance=0
app_stopped=0
cleanup() {
status=$?
if (( app_stopped )); then docker compose start owncloud || status=1; fi
if (( maintenance )); then docker compose exec -T owncloud occ maintenance:mode --off || status=1; fi
rm -f -- "$TMP"
exit "$status"
}
trap cleanup EXIT
maintenance=1
docker compose exec -T owncloud occ maintenance:mode --on
app_stopped=1
docker compose stop owncloud
docker compose exec -T mariadb /usr/bin/mysqldump \
--defaults-extra-file=/run/secrets/db_backup_client \
--single-transaction owncloud | gzip -c > "$TMP"
gzip -t "$TMP"
test -s "$TMP"
mv -- "$TMP" "$FINAL"
docker compose start owncloud
app_stopped=0
docker compose exec -T owncloud occ maintenance:mode --off
maintenance=0
trap - EXIT
--single-transaction`$$$`는 ownCloud의 MariaDB/MySQL 백업 예제에서 사용되는 데이터베이스 옵션입니다. 임시 파일 이름은 불완전한 덤프가 완료된 백업처럼 보이지 않도록 하며, gzip -t파일 test -s이름이 변경되기 전에 작업이 성공적으로 완료되어야 합니다. 잠금은 느린 실행이 다음 예약된 실행과 겹치는 것을 방지합니다. Compose 프로젝트에서 다른 데이터베이스 이름을 사용하는 경우 마지막 owncloud인수를 해당 이름으로 변경하십시오.
스크립트를 설치하고 실행 권한을 부여한 다음, 예약 실행 전에 한 번 수동으로 실행하십시오. 수동 실행을 통해 Compose 경로, 비밀 마운트, 사용 가능한 디스크 공간 및 유지 관리 모드 복구를 확인하고 로그를 모니터링할 수 있습니다.
sudo chmod 700 /usr/local/sbin/owncloud-db-backup
sudo /usr/local/sbin/owncloud-db-backup
작업이 완료되고 ownCloud가 정상적으로 작동하면 root 계정의 crontab을 열고 매일 오전 2시 30분에 실행되는 작업을 추가하세요. cron은 호스트의 로컬 시간대를 사용하므로, 사용 환경에 맞는 비교적 한적한 시간대로 일정을 변경하십시오.
sudo crontab -e
30 2 * * * /usr/local/sbin/owncloud-db-backup >> /var/log/owncloud-db-backup.log 2>&1
해당 작업은 Docker를 제어하고, 보호된 백업 디렉터리에 쓰기 작업을 수행하고, 잠금 파일을 생성해야 하므로 루트 권한으로 실행됩니다. 스크립트와 데이터베이스 비밀 키는 관리자만 읽을 수 있도록 안전하게 관리하십시오. 로그 순환을 설정하고, 0이 아닌 종료 값에 대한 경고 또는 모니터링 검사를 구성하십시오. cron 로그만으로는 유효한 백업이 생성되었는지 확인할 수 없습니다.
수동 실행 후와 첫 번째 예약 실행 후, 새 타임스탬프가 찍힌 파일이 생성되었는지, 비어 있지 않은지, 그리고 gzip 무결성 검사를 통과했는지 확인하십시오.
ls -lh /srv/backups/owncloud-db/
gzip -t /srv/backups/owncloud-db/owncloud-db-YYYYMMDDTHHMMSSZ.sql.gz
복원 성공은 gzip -t압축된 스트림을 읽을 수 있음을 확인하는 것일 뿐, MariaDB가 SQL을 복원할 수 있거나 복원된 ownCloud 인스턴스가 정상적으로 작동함을 보장하는 것은 아닙니다. ownCloud 복원 지침을 사용하여 주기적으로 임시 스테이징 스택에 복사본을 복원하십시오 . 실제 운영 중인 데이터베이스에 직접 가져와서 테스트하는 것은 절대 금지입니다.
데이터베이스 덤프는 Compose 프로젝트 외부에 보관하고 암호화된 사본을 별도의 스토리지에 전송하세요. 복구 필요성과 사용 가능한 용량에 따라 보존 기간을 설정하고, 대상 스토리지가 갑자기 가득 차는 것을 방지하기 위해 모니터링하세요. 데이터베이스 덤프만으로는 완전한 ownCloud 백업이 아닙니다. 현재 복원 가이드에서는 apps, config, files폴더가 포함된 Docker 볼륨 데이터와 사용자 지정 테마 파일 또는 별도로 저장된 암호화 키도 필요합니다.
ownCloud 설치에서 PostgreSQL을 사용하는 경우, 문서화된 형식으로 전환하십시오 pg_dump. pg_restore현재 서버 가이드는 프로덕션 환경에서 MySQL/MariaDB 및 PostgreSQL을 지원합니다. SQLite는 평가용으로 설명되어 있으며 프로덕션 환경에는 적합하지 않습니다. 또한 ownCloud의 "Cron 작업 백업" 섹션은 기존 www-datacrontab을 보존하는 것을 의미하며, 반복적인 데이터베이스 덤프를 생성하는 것은 아닙니다.
ownCloud 서버에 대한 보호된 MariaDB 덤프를 예약하고, 유지 관리 모드를 안전하게 처리하며, 사용하기 전에 각 백업을 검증합니다.
지원되는 앱, 순서대로 실행되는 명령, 신원 확인 절차, 그리고 별도로 처리해야 할 데이터 목록을 명확하게 작성하여 ownCloud 10에서 oCIS로의 마이그레이션을 계획하십시오.
업그레이드 및 무결성 검사 관련 문제를 피하면서 테마 앱을 사용하여 ownCloud Classic 10 로고를 교체하고 웹 UI 색상을 조정하세요.
역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.
TLS 인증을 비활성화하지 않고 서버 호스트 이름, 인증서 체인, 개인 CA 신뢰 및 캡티브 포털 문제를 확인하여 ownCloud 데스크톱 동기화를 복원하세요.
잘못된 파일 보고서를 사용하여 코어 파일이나 앱 서명이 일치하지 않는 부분을 식별하고, 올바른 릴리스 파일을 복원하고, 무결성 검사를 안전하게 확인할 수 있습니다.
ownCloud Infinite Scale을 공식 Compose 예제를 사용하여 배포하고, 도메인 및 영구 스토리지를 구성한 다음, TLS, 컨테이너 및 첫 로그인을 확인합니다.
ownCloud Infinite Scale이 파일 콘텐츠를 안정적으로 저장할 수 있도록 S3NG 드라이버, 버킷 권한, 영구 메타데이터 저장소 및 업로드 크기를 설정합니다.
ownCloud 서버 업로드가 거의 완료될 무렵 중단되는 이유를 파일 상태, 할당량, 임시 디스크 공간, PHP 제한 및 프록시 시간 초과를 확인하여 알아보세요.
ownCloud의 웹 루트에만 AllowOverride All을 설정하고, 활성 Apache vhost를 확인한 다음, 안전하게 페이지를 새로 고침하여 .htaccess 규칙을 복원하십시오.