Docker Compose 배포
Compose 설정 만들기
배포 디렉터리를 만듭니다. 이후 명령은 모두 이 디렉터리에서 실행합니다.
sh
mkdir -p ~/sayrud
cd ~/sayrud
sudo install -d -o 10001 -g 10001 -m 0750 ./config ./data
umask 077
printf 'SAYRUD_IMAGE=ghcr.io/sayrud/sayrud:latest\nPOSTGRES_PASSWORD=%s\nREDIS_PASSWORD=%s\n' \
"$(openssl rand -hex 24)" "$(openssl rand -hex 24)" > .env.env의 POSTGRES_PASSWORD와 REDIS_PASSWORD는 각각 PostgreSQL과 Redis의 비밀번호입니다. 설치 마법사에서도 입력해야 합니다.
다음 내용을 compose.yaml로 저장합니다.
yaml
services:
sayrud:
image: ${SAYRUD_IMAGE:?.env에서 SAYRUD_IMAGE을 설정하세요}
restart: unless-stopped
ports:
- "2830:2830"
stop_grace_period: 45s
volumes:
- ./config:/home/app/config
- ./data:/home/app/data
depends_on:
postgres:
condition: service_healthy
redis:
condition: service_healthy
postgres:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_DB: sayrud
POSTGRES_USER: sayrud
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?.env에서 POSTGRES_PASSWORD을 설정하세요}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U sayrud -d sayrud"]
interval: 2s
timeout: 3s
retries: 30
redis:
image: redis:7-alpine
restart: unless-stopped
environment:
REDISCLI_AUTH: ${REDIS_PASSWORD:?.env에서 REDIS_PASSWORD을 설정하세요}
command: ["redis-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD}"]
volumes:
- redis_data:/data
healthcheck:
test: ["CMD-SHELL", "redis-cli ping | grep -qx PONG"]
interval: 2s
timeout: 3s
retries: 30
volumes:
postgres_data:
redis_data:실행 및 설치
sh
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100 sayrudhttp://server-address:2830/setup을 열고 로그의 Setup token: 뒤에 있는 토큰을 입력한 다음 웹 설치 절차를 따릅니다. 데이터베이스 정보는 다음과 같이 입력합니다.
| 항목 | 값 |
|---|---|
| PostgreSQL 호스트, 포트 | postgres, 5432 |
| 데이터베이스 이름, 사용자 이름 | sayrud, sayrud |
| PostgreSQL 비밀번호 | .env의 POSTGRES_PASSWORD |
| PostgreSQL SSL 모드 | 암호화 안 함 |
| Redis 주소 | redis:6379 |
| Redis 사용자 이름 | default |
| Redis 비밀번호 | .env의 REDIS_PASSWORD |
애플리케이션 컨테이너의 127.0.0.1은 해당 컨테이너 자체를 가리키므로 다른 두 컨테이너에 연결할 때 사용할 수 없습니다. 기존 데이터베이스를 사용한다면 컨테이너에서 접근할 수 있는 주소를 입력하세요.
설정은 ./config/sayrud.yaml에, 업로드 파일은 ./data/storage에 저장됩니다.
업그레이드 및 백업
애플리케이션을 중지하고 데이터베이스와 로컬 파일을 백업합니다.
sh
umask 077
docker compose stop sayrud
docker compose exec -T postgres pg_dump -U sayrud -d sayrud -Fc > sayrud.dump
sudo tar -czf - .env config data > sayrud-files.tar.gz.env의 SAYRUD_IMAGE를 변경한 뒤 업그레이드합니다.
sh
docker compose pull sayrud
docker compose up -d sayrud
docker compose logs --tail=100 sayrud
curl -fsS http://127.0.0.1:2830/-/readyzdocker compose down -v는 데이터베이스 볼륨을 삭제하므로 실행하지 마세요.