서버 관리 Part 4: 서버 배포¶

Systemd¶

프로젝트 소스 디렉터리의 etc/systemd/{{project-name}}.service 파일을 패키지 생성 시에 포함해서 배포합니다.

설정 파일 내용과 관련한 세부 사항은 Systemd 페이지를 확인해주세요.

예제: 서비스를 실행할 유저 변경하기

보안 상의 이유로, root 대신에 다른 유저를 생성하고, 해당 유저 계정으로 서비스를 실행하는 것을 권장합니다.

아래는 centos 라는 유저와 그룹으로 서비스를 실행하게끔 수정한 예시입니다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

[Service]
LimitNOFILE=999999

# It is strongly recommended that one should use uid:gid other than the root
# NOTE: Please update User=, Group=, and ExecStartPre=
User=centos
Group=centos

# Makes the daemon automatically restart
Type=simple
Restart=on-failure
RestartSec=5s

# create directories, and change permissions (with root privileges)
PermissionsStartOnly=true
ExecStartPre=/usr/bin/mkdir -p /var/log/funapi/example/glog \
  /var/log/funapi/example/activity \
  /var/crash/funapi/example
# NOTE: change root:root to service's uid:gid
ExecStartPre=/usr/bin/chown -R centos:centos /var/log/funapi/example/glog \
  /var/log/funapi/example/activity \
  /var/crash/funapi/example

ExecStart=/usr/bin/example-launcher

Ubuntu 16.04 또는 18.04¶

서버 관리 Part 3: 서버 패키징 에서 설명된 대로 deb 파일을 생성합니다. 이 파일을 서버에 복사한 후 dpkg 명령으로 설치합니다.

가령 example 이라는 이름의 게임인 경우 다음과 같습니다.

$ sudo dpkg -i example_0.0.1_install.deb
[sudo] password for ubuntu:
Selecting previously unselected package example.
(Reading database ... 424079 files and directories currently installed.)
Preparing to unpack example_0.0.1_install.deb ...
Unpacking example (0.0.1) ...
Setting up example (0.0.1) ...
Processing triggers for ureadahead (0.100.0-16) ...
ureadahead will be reprofiled on next reboot

$ sudo apt-get install -f

Centos 7 또는 Centos 8¶

서버 관리 Part 3: 서버 패키징 에서 설명된 대로 rpm 파일을 생성합니다. 이 파일을 서버에 복사한 후 rpm 명령으로 설치합니다.

가령 example 이라는 이름의 게임인 경우 다음과 같습니다.

$ sudo rpm -i example_0.0.1_install.rpm

$ sudo yum install funapi1-runtime

Systemd¶

systemctl 명령을 이용해서 서비스를 활성화 하고 시작, 종료할 수 있습니다.

가령 example 이라는 서버를 설치한 경우 다음과 같이 실행합니다.

$ sudo systemctl enable example

$ sudo systemctl start example

$ sudo systemctl stop example

Systemd¶

systemd 로 실행한 경우, 서비스 로그는 journalctl -x -u {{project-name}} 명령으로 확인할 수 있습니다.

만일 example 이라는 서버의 경우 다음과 같이 로그를 볼 수 있습니다.

$ sudo journalctl -x -u example

Ubuntu 환경에서 버전 고정하기¶

버전 고정:

funapi1-runtime 의 버전을 고정한다고 하면, 다음과 같이 명령을 입력하면 됩니다.

$ sudo apt-mark hold funapi1-runtime

해당 명령 후에는 apt-get upgrade 등에서 해당 패키지를 제외하고 업데이트하게 됩니다.

버전이 고정된 패키지 확인:

$ sudo apt-mark showhold
funapi1-runtime

위에서 입력한 패키지가 버전이 고정된 것을 확인하실 수 있습니다.

버전 고정 해제:

다음 명령으로 패키지 버전이 고정된 것을 풀 수 있습니다.

$ sudo apt-mark unhold funapi1-runtime

이 이후에는 패키지를 업그레이드할 수 있습니다.

CentOS 환경에서 버전 고정하기¶

CentOS 환경에서 버전을 고정하려면 추가 패키지가 필요합니다. 다음 명령으로 설치해주시면 됩니다.

$ sudo yum install yum-versionlock

yum-versionlock 패키지를 설치한 후에 아래 명령들을 실행할 수 있습니다.

버전 고정:

funapi1-runtime 의 버전을 고정한다고 하면, 다음과 같이 명령을 입력하면 됩니다.

$ sudo yum versionlock funapi1-runtime

해당 명령 후에는 yum update 등에서 해당 패키지를 제외하고 업데이트하게 됩니다.

버전이 고정된 패키지 확인:

$ sudo yum -q versionlock list
0:funapi1-runtime-1.0.0-1680centos7.*

위에서 입력한 패키지가 버전이 고정된 것을 확인하실 수 있습니다.

버전 고정 해제:

다음 명령으로 패키지 버전이 고정된 것을 풀 수 있습니다.

$ sudo yum versionlock delete funapi1-runtime

이 이후에는 패키지를 업그레이드할 수 있습니다.

비표준 위치에 게임 서버 패키지 설치하기¶

앞에서는 DEB 나 RPM 형태의 파일을 만들어서 배포하는 것을 설명했습니다. 이런 패키지 파일은 미리 정해진 위치에 게임 서버를 설치하고, root 권한도 필요로 합니다.

그러나 경우에 따라서는 root 권한을 취득할 수 없는 경우도 있을 수 있고, 특정 디렉토리 아래 게임 서버 내용을 모두 설치해야될 수도 있습니다. 예를 들어, 퍼블리셔에게 게임 서버를 전달하면 퍼블리셔가 사용하는 Linux 계정 아래 게임 패키지가 그대로 설치되길 바라는 경우를 생각해볼 수 있습니다. 이런 경우는 설치 위치를 강제하는 DEB 나 RPM 으로는 곤란하고 tar.gz 로 패키지를 생성해서 퍼블리셔에게 전달하고 퍼블리셔가 원하는 위치에 압축을 풀게 하는 것이 좋습니다. (tar.gz 의 생성에 관련해서는 생성 가능한 패키지 타입 을 참고하세요.)

편의상 우리가 만드는 게임의 이름을 hello 라고 하고, lobby flavor 를 사용했다고 하겠습니다. 그러면 생성되는 패키지는 hello_0.0.1_install-lobby.tar.gz 가 될 것입니다. 이제 퍼블리셔가 관리하는 리눅스 서버의 계정이 zeus 라고 가정했을 때, 퍼블리셔는 저 패키지를 /home/zeus 아래에서 풀었을 것입니다.

$ cd /home/zeus
$ tar zxf hello_0.0.1_install-lobby.tar.gz

이렇게 하면 /home/zeus 아래에 DEB 나 RPM 으로 설치했을 때 / 디렉토리 아래 설치되었을 내용들이 그대로 복사된 것을 확인하실 수 있을 겁니다.

비표준 위치에 게임 서버 패키지 설치하고 서비스로 띄우기¶

그런데, 이 방법은 파일은 복사하지만, upstart 나 systemd 처럼 게임 서버를 서비스로 (즉, 데몬으로) 실행시키는 것을 자동으로 해줄 수는 없습니다. 따라서 이런 설정은 수작업으로 해줘야됩니다.

또한 서비스를 등록하더라도 / 가 아니라 우리가 지정한 /home/zeus 에서 게임 서버를 찾을 수 있게끔 경로를 지정하는 작업도 필요합니다. 이 작업들은 게임 서버 OS를 세팅할 때 처음 1회만 하면 됩니다.

아래는 Upstart 와 Systemd 의 경우에 대해서 서비스를 등록하는 방법을 설명합니다. 두 가지 방법 모두, 환경 변수를 지정해주고 스크립트를 등록해주는 작업을 하게 됩니다.

$ ls lib/systemd/system
hello.lobby.service

$ sudo cp lib/systemd/system/hello.lobby.service /lib/systemd/system/

GAME_ROOT_DIR=/home/zeus

$ sudo systemctl start hello.lobby