본문으로 건너뛰기

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 sayrud

http://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/-/readyz

docker compose down -v는 데이터베이스 볼륨을 삭제하므로 실행하지 마세요.