VPS에 먼저 Dokku를 설치해야 한다. 앞서 언급했듯이 나는 OVH를 사용한다.

Docker 컨테이너로 앱 배포하기

애플리케이션을 배포하는 가장 간편한 방법 중 하나는 Docker 컨테이너를 이용하는 것이다.

Docker 컨테이너로 배포하려면 git 저장소 루트에 다음과 같이 Dockerfile을 넣으면 된다:

Dockerfile

FROM python:3.10

COPY . /app
WORKDIR /app

# Install the local package
RUN pip install .

# This directory contains app.py, a FastApi app
WORKDIR /app/

ENTRYPOINT ["./entrypoint.sh"]

entrypoint.sh

#!/bin/bash
exec uvicorn main:app --port "$PORT" --host 0.0.0.0

Dokku 호스트에서 앱을 생성한다:

dokku apps:create myapp

로컬에서는 Dokku 호스트에 대한 접근을 설정하고, ~/.ssh/config 파일에 dokku라는 이름으로 등록한다. 내 경우를 예로 들면:

Host dokku
  HostName <The external IP address of your Dokku host>
  User ubuntu
  IdentityFile /Users/hamel/.ssh/dokku

로컬에서 Dokku 호스트를 리모트로 추가하고 푸시한다:

git remote add dokku dokku@dokku:myapp
git push dokku main

이게 전부다 — 이제 앱이 Dokku 호스트에서 실행 중일 것이다! 로컬 로그에 애플리케이션이 서비스되는 URL이 출력되며, 기본값은 myapp.yourdomain.com이다. 다음 명령어로 스케일을 조정할 수도 있다:

#scale to two workers
dokku ps:scale myapp web=2

여기서는 기본적인 내용만 다뤘다. 더 자세한 내용은 Dokku 공식 문서를 참고하자.

정적 사이트 배포

GitHub Pages는 비공개 정적 사이트를 배포하려면 비싼 Enterprise 계정이 필요해 불편하다. Dokku를 쓰면 비공개 GitHub 저장소에서 정적 사이트를 손쉽게 배포하고 비밀번호 보호까지 걸 수 있다.

이 예제에서는 _site 폴더에 정적 사이트가 git 저장소 형태로 있다고 가정한다.

Dokku 호스트에서 mysite라는 이름의 앱을 생성하고, NGINX_ROOT 환경 변수를 _site으로 설정한다:

dokku apps:create mysite
dokku config:set static-site NGINX_ROOT=_site

마찬가지로 Dokku 호스트에서 basic auth를 설치하고, 플러그인이 정상 동작할 수 있도록 권한을 설정한다.

# do setup for the auth plugin that we will use later
sudo dokku plugin:install https://github.com/dokku/dokku-http-auth.git
sudo chmod +x /home/dokku

이제 정적 사이트가 담긴 git 저장소 루트에서 다음 명령어들을 실행한다:

1touch .static
2echo BUILDPACK_URL=https://github.com/dokku/buildpack-nginx > .env
3git remote add dokku dokku@dokku:mysite

마지막으로 애플리케이션을 배포한다:

git push dokku main

Dokku 호스트에서 다음 명령어를 실행하면 인증을 추가할 수 있다:

dokku http-auth:enable mysite <username> <password>

GitHub Actions로 자동 배포하기

Dokku 호스트에 직접 푸시하는 번거로움을 없애고 싶다면 GitHub Actions로 배포를 자동화할 수 있다. 아래는 이를 구현한 GitHub Actions 워크플로우 예제다:

deploy-dokku.yml

name: CI
on:
  workflow_dispatch:
  push:
    branches: [main]

concurrency: # Cancel previous jobs to avoid deploy locks on dokku
  group: ${{ github.ref }}
  cancel-in-progress: true

jobs:
  deploy-dokku:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2
        with:
          fetch-depth: 0
      
      - name: Install SSH key
        run: |
          echo "${{ secrets.DOKKU_SSH_PRIVATE_KEY }}" > private_key.pem
          chmod 600 private_key.pem

      - name: Add remote and push
        run: |
          git remote add dokku dokku@rechat.co:llm-eval
          GIT_SSH_COMMAND="ssh -i private_key.pem -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no" git push dokku main -f

기타 유용한 팁

자꾸 잊어버리는 것들을 여기 정리해둔다. 아래 예제에서 앱 이름은 llm-eval, 호스트는 rechat.co으로 가정한다.

원격으로 명령어 실행하기

명령어 실행을 위해 Dokku 호스트에 직접 SSH로 접속할 필요는 없다. dokku 사용자를 통해 다음과 같이 원격으로 실행할 수 있다:

# https://dokku.com/docs/deployment/application-management/
ssh dokku@rechat.co apps:list

Docker 캐시

깨끗하게 새로 빌드하기 위해 Docker 캐시를 무효화하는 방법은 다음과 같다:

ssh dokku@rechat.co repo:purge-cache llm-eval

푸시 없이 재빌드하기

푸시 없이 재빌드만 하고 싶을 때가 있다. 여러 방법이 있지만 그중 하나는 다음과 같다:

ssh dokku@rechat.co ps:rebuild llm-eval

이 글을 쓴 이유

새 앱을 배포할 때마다 이 내용을 매번 다시 찾아야 했기에, 어차피 정리해야겠다 싶었다. 다른 분들에게도 도움이 되길 바란다!