Supervisor#

Supervisor는 Vapor 앱을 손쉽게 시작하고, 중지하고, 재시작할 수 있게 해주는 프로세스 제어 시스템입니다.

설치#

Supervisor는 Linux의 패키지 관리자를 통해 설치할 수 있습니다.

Ubuntu#

sudo apt-get update
sudo apt-get install supervisor

CentOS와 Amazon Linux#

sudo yum install supervisor

Fedora#

sudo dnf install supervisor

설정#

서버에 있는 각 Vapor 앱은 자신만의 설정 파일을 가져야 합니다. 예를 들어 Hello 프로젝트라면 설정 파일은 /etc/supervisor/conf.d/hello.conf에 위치하게 됩니다.

[program:hello]
command=/home/vapor/hello/.build/release/App serve --env production
directory=/home/vapor/hello/
user=vapor
stdout_logfile=/var/log/supervisor/%(program_name)s-stdout.log
stderr_logfile=/var/log/supervisor/%(program_name)s-stderr.log

설정 파일에 명시된 대로 Hello 프로젝트는 vapor 사용자의 홈 폴더에 위치합니다. directory가 Package.swift 파일이 있는 프로젝트의 루트 디렉터리를 가리키도록 해야 합니다.

--env production 플래그는 상세 로깅(verbose logging)을 비활성화합니다.

환경 변수#

Supervisor를 사용하여 Vapor 앱에 변수를 export할 수 있습니다. 여러 환경 변수 값을 export하려면 모두 한 줄에 작성하세요. Supervisor 문서에 따르면 다음과 같습니다.

영숫자가 아닌 문자를 포함하는 값은 따옴표로 묶어야 합니다(예: KEY=“val:123”,KEY2=“val,456”). 그 외의 경우 값을 따옴표로 묶는 것은 선택 사항이지만 권장됩니다.

environment=PORT=8123,ANOTHERVALUE="/something/else"

Export된 변수는 Vapor에서 Environment.get을 사용하여 사용할 수 있습니다.

let port = Environment.get("PORT")

시작#

이제 앱을 로드하고 시작할 수 있습니다.

supervisorctl reread
supervisorctl add hello
supervisorctl start hello