Ubuntu 22.04에 Helpy 고객 지원 데스크 설치하는 방법

Helpy는 Ruby on Rails 언어로 작성된 무료 오픈 소스 고객 지원 플랫폼입니다. 완전히 오픈 소스이며 MIT 라이센스 하에 변경할 수 있습니다. 자동화된 티켓 시스템을 구축하는 데 사용되며 타사 애플리케이션과 통합할 수 있습니다. 다음과 같은 다양한 기능을 제공합니다:

다채널 티켓 지원.
대규모 커뮤니티 지원. Sendgrid, Mandrill, Mailgun 등을 통한 수신 이메일 통합.
완전 다국어 지원 및 여러 언어로 지원 가능.
사용자 정의 가능하며 GDPR 준수.
모바일 친화적이며 모든 장치에서 즉시 작동.

이 게시물에서는 Ubuntu 22.04에 Helpy 고객 지원 시스템을 설치하는 방법을 보여줍니다.

요구 사항

Ubuntu 22.04를 실행하는 서버.
서버에 루트 비밀번호가 설정되어 있어야 합니다.

시스템 업데이트

먼저, 모든 시스템 패키지를 최신 버전으로 업데이트하고 업그레이드해야 합니다. 다음 명령어를 실행하여 모든 패키지를 업데이트할 수 있습니다.

apt update -y  
apt upgrade -y

모든 패키지가 업데이트되면 서버에 몇 가지 추가 종속성을 설치해야 합니다. 다음 명령어를 실행하여 모두 설치할 수 있습니다.

apt install apt-transport-https ca-certificates curl software-properties-common git -y

모든 패키지가 설치되면 다음 단계로 진행할 수 있습니다.

Docker 및 Docker Compose 설치

이 게시물에서는 Docker 및 Docker Compose를 사용하여 Helpy를 설치합니다. 따라서 두 패키지가 서버에 설치되어 있어야 합니다.

먼저, 다음 명령어를 사용하여 Docker GPG 키와 리포지토리를 추가합니다.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -  
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

다음으로, 다음 명령어로 리포지토리 캐시를 업데이트합니다.

apt update -y

다음으로, 다음 명령어를 사용하여 Docker와 Docker Compose를 모두 설치할 수 있습니다.

apt install docker-ce docker-compose -y

두 패키지가 성공적으로 설치되면 다음 명령어로 Docker 서비스를 시작하고 활성화합니다.

systemctl start docker  
systemctl enable docker

이제 다음 명령어로 Docker 버전을 확인합니다.

docker -v

다음과 같은 출력을 얻을 수 있습니다.

Docker version 20.10.22, build 3a2c30b

다음 명령어로 Docker Compose 버전도 확인할 수 있습니다.

docker-compose version

다음과 같은 출력을 보아야 합니다.

docker-compose version 1.29.2, build unknown
docker-py version: 5.0.3
CPython version: 3.10.4
OpenSSL version: OpenSSL 3.0.2 15 Mar 2022

Ubuntu 22.04에 Helpy 설치

먼저, 다음 명령어를 사용하여 GitHub 리포지토리에서 Helpy의 최신 버전을 다운로드합니다.

git clone https://github.com/helpyio/helpy.git

다운로드가 완료되면 다음 명령어로 helpy 디렉토리로 이동합니다.

cd helpy

다음으로, 다음 명령어를 사용하여 Helpy 환경 파일의 이름을 변경합니다.

cp docker/.env.sample docker/.env

다음으로, 다음 명령어를 사용하여 Helpy의 Docker 이미지를 빌드합니다.

docker-compose build

다음과 같은 출력을 보아야 합니다.

Building helpy
Sending build context to Docker daemon  134.4MB
Step 1/20 : FROM ruby:2.5
2.5: Pulling from library/ruby
0bc3020d05f1: Pull complete 
a110e5871660: Pull complete 
83d3c0fa203a: Pull complete 
a8fd09c11b02: Pull complete 
14feb89c4a52: Pull complete 
958d2475f181: Pull complete 
ba6c4f28fec1: Pull complete 
757d13b54b5e: Pull complete 
Digest: sha256:ecc3e4f5da13d881a415c9692bb52d2b85b090f38f4ad99ae94f932b3598444b
Status: Downloaded newer image for ruby:2.5
 ---> 27d049ce98db
Step 2/20 : ENV RAILS_ENV=production     HELPY_HOME=/helpy     HELPY_USER=helpyuser     HELPY_SLACK_INTEGRATION_ENABLED=true     BUNDLE_PATH=/opt/helpy-bundle

다음 명령어로 모든 Docker 이미지를 확인할 수 있습니다.

docker images

다음과 같은 출력을 얻어야 합니다.

REPOSITORY    TAG       IMAGE ID       CREATED          SIZE
helpy_helpy   latest    9d59c3019f8f   32 seconds ago   1.91GB
ruby          2.5       27d049ce98db   18 months ago    843MB

다음으로, 다음 명령어로 Helpy 및 Nginx 컨테이너를 시작합니다.

docker-compose up -d

다음과 같은 출력을 보아야 합니다.

Creating network "helpy_front" with driver "bridge"
Creating network "helpy_back" with driver "bridge"
Creating volume "helpy_rails-assets" with local driver
Pulling frontend (nginx:1.15)...
1.15: Pulling from library/nginx
743f2d6c1f65: Pull complete
6bfc4ec4420a: Pull complete
688a776db95f: Pull complete
Digest: sha256:23b4dcdf0d34d4a129755fc6f52e1c6e23bb34ea011b315d87e193033bcd1b68
Status: Downloaded newer image for nginx:1.15
Pulling postgres (postgres:9.4)...
9.4: Pulling from library/postgres
619014d83c02: Pull complete
7ec0fe6664f6: Pull complete
9ca7ba8f7764: Pull complete
9e1155d037e2: Pull complete
febcfb7f8870: Pull complete
8c78c79412b5: Pull complete
5a35744405c5: Pull complete
27717922e067: Pull complete
36f0c5255550: Pull complete
dbf0a396f422: Pull complete
ec4c06ea33e5: Pull complete
e8dd33eba6d1: Pull complete
51c81b3b2c20: Pull complete
2a03dd76f5d7: Pull complete
Digest: sha256:42a7a6a647a602efa9592edd1f56359800d079b93fa52c5d92244c58ac4a2ab9
Status: Downloaded newer image for postgres:9.4
Creating nginx            ... done
Creating helpy_postgres_1 ... done
Creating helpy_helpy_1    ... done

다음으로, 다음 명령어로 모든 실행 중인 컨테이너의 상태를 확인합니다.

docker-compose ps

다음과 같은 출력을 통해 모든 실행 중인 컨테이너를 확인할 수 있습니다.

      Name                    Command               State                                   Ports                                 
----------------------------------------------------------------------------------------------------------------------------------
helpy_helpy_1      /bin/bash /helpy/docker/run.sh   Up      0.0.0.0:3000->3000/tcp,:::3000->3000/tcp                              
helpy_postgres_1   docker-entrypoint.sh postgres    Up      5432/tcp                                                               
nginx              nginx -g daemon off;             Up      0.0.0.0:443->443/tcp,:::443->443/tcp, 0.0.0.0:80->80/tcp,:::80->80/tcp

모든 컨테이너가 시작될 때까지 잠시 기다립니다.

이 시점에서 Helpy가 시스템에 설치되고 실행되고 있습니다. 이제 다음 단계로 진행할 수 있습니다.