우분투 24.04 서버에 Cachet 상태 페이지 설치하는 방법

Cachet는 PHP로 작성된 오픈 소스 상태 페이지 시스템입니다. 이를 통해 인프라의 다운타임 및 시스템 실패를 모니터링할 수 있습니다. Cachet는 JSO API, 보고서, 메트릭, 여러 알림 방법 및 이중 인증을 제공합니다.

이 튜토리얼에서는 Docker를 사용하여 우분투 24.04 서버에 Cachet를 설치하고 실행하는 방법을 배웁니다. 또한 Nginx를 리버스 프록시로 설치하고 Certbot 및 Letsencrypt를 통해 Cachet를 HTTPS로 보호하는 방법도 배웁니다.

전제 조건

이 가이드를 완료하려면 다음이 필요합니다:

우분투 24.04 서버.
관리자 권한이 있는 비루트 사용자.
서버 IP 주소를 가리키는 도메인 이름.

Docker 엔진 설치

이 가이드에서는 Docker를 사용하여 Cachet를 컨테이너로 실행합니다. 그런 다음 우분투 시스템에 Docker 엔진을 설치합니다.

먼저, 아래 명령어를 실행하여 ca-certificates 및 curl 패키지를 설치합니다.

sudo apt install ca-certificates curl

이제 다음 명령어를 실행하여 Docker 리포지토리의 GPG 키를 추가합니다.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

다음과 같이 Docker 리포지토리를 추가합니다.

echo  
“deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu  
(. /etc/os-release && echo "VERSION_CODENAME") stable" |  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

setup docker repo

다음으로, 우분투 패키지 인덱스를 업데이트하고 다음 apt 명령어로 Docker 엔진을 설치합니다. 설치를 확인하려면 Y를 입력합니다.

sudo apt update  
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

install docker

설치 후, Docker 서비스가 우분투 시스템에서 실행되고 활성화되어 있어야 합니다.

아래 명령어를 실행하여 Docker 서비스를 확인합니다.

sudo systemctl is-enabled docker  
sudo systemctl status docker

아래와 유사한 출력이 표시됩니다:

check docker

Docker를 실행할 사용자 설정

Docker를 설치한 후, 사용자를 docker 그룹에 추가해야 합니다. 이를 통해 비루트 사용자로 컨테이너를 실행할 수 있습니다.

사용자를 docker 그룹에 추가하려면 아래 명령어를 실행합니다. 사용자 이름을 자신의 사용자로 변경합니다.

sudo usermod -aG docker username

이제 사용자로 로그인하고 docker 명령어를 실행하여 구성을 확인합니다.

su - username  
docker run hello-world

구성이 성공적이라면 Docker에서 Hello World 메시지를 볼 수 있습니다.

docker run hello world

Docker로 Cachet 설치하기

이제 Docker 엔진을 설치하고 사용자를 구성했으므로 Cachet 프로젝트를 다운로드하고 docker-compose.yml 파일을 설정하고 이미지를 빌드하며 Cachet를 위한 컨테이너를 재구성한 후 Cachet를 컨테이너로 실행합니다.

Cachet docker 버전을 cachet-docker 디렉토리에 다운로드하고 그 안으로 이동합니다.

git clone https://github.com/cachethq/Docker.git cachet-docker  
cd cachet-docker

nano 편집기를 사용하여 docker-compose.yml을 편집합니다.

nano docker-compose.yml

기본 포트를 8000으로 변경합니다. 컨테이너와 Docker 호스트 모두에 대해.

ports:  
 - 8000:8000

파일을 저장하고 종료합니다.

이제 아래 docker 명령어를 실행하여 Cachet 이미지를 빌드하고 Cachet 컨테이너를 시작합니다.

docker compose build  
docker compose up

빌드 과정에서 다음과 같은 내용을 볼 수 있습니다:

build cachet image

Cachet 컨테이너를 시작할 때 다음과 같은 출력이 표시됩니다:

build container

Cachet를 처음 실행하면 다음과 같은 새로운 APP_KEY가 생성됩니다 - APP_KEY를 복사하고 Ctrl+c를 눌러 Cachet 컨테이너를 종료합니다.

다음으로, docker-compose.yml 파일을 다시 편집하고 APP_KEY를 다음과 같이 교체합니다:

APP_KEY=base64:6ltZ62B69p6oxIVeQtf9jpX5BFvgUXU2qk5eXpw3OIQ=

파일을 저장하고 종료합니다.

이제 아래 docker 명령어를 실행하여 이전 컨테이너와 새로운 Cachet 컨테이너를 삭제합니다.

docker compose down  
docker compose up -d

마지막으로, 다음 명령어를 실행하여 실행 중인 컨테이너나 서비스를 확인합니다.

docker compose ps

아래에서 Cachet 컨테이너가 포트 8000에서 실행되고 있는 것을 볼 수 있습니다.

rerun container

Nginx를 리버스 프록시로 설정하기

이 가이드에서는 Nginx를 리버스 프록시로 사용하여 Cachet를 실행합니다. 이제 Nginx를 설치하고 리버스 프록시를 위한 새로운 서버 블록을 설정합니다. 도메인 이름이 준비되어 있고 서버 IP 주소를 가리키고 있는지 확인하십시오.

Nginx 웹 서버를 설치하려면 다음 apt 명령어를 실행합니다. 설치를 진행하려면 Y를 입력합니다.

sudo apt install nginx

install nginx

설치가 완료되면 nano 편집기를 사용하여 새로운 Nginx 서버 블록 파일 /etc/nginx/sites-available/cachet.conf를 생성합니다.

sudo nano /etc/nginx/sites-available/cachet.conf

다음 구성을 붙여넣고 status.howtoforge.local을 자신의 도메인 이름으로 변경합니다.

server {  
 listen 80;  
 server_name status.howtoforge.local;  
 location / {  
 proxy_pass http://127.0.0.1:8000;  
 proxy_set_header Host $host;  
 proxy_set_header X-Real-IP $remote_addr;  
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
 proxy_set_header X-Forwarded-Proto $scheme;  
 }  
}

작업이 완료되면 파일을 저장하고 편집기를 종료합니다.

이제 아래 명령어를 실행하여 서버 블록 파일 cachet.conf를 활성화하고 Nginx 구문을 확인합니다. 구문이 올바르면 test- is successful - syntax is ok라는 출력을 볼 수 있습니다.

sudo ln -s /etc/nginx/sites-available/cachet.conf /etc/nginx/sites-enabled/  
sudo nginx -t

마지막으로, 아래 systemctl 명령어를 실행하여 Nginx 서비스를 재시작하고 변경 사항을 적용합니다. 그런 다음 Nginx 서비스 상태를 확인하여 실행 중인지 확인합니다.

sudo systemctl restart nginx  
sudo systemctl status nginx

아래에서 Nginx 서비스가 Cachet 설치를 위한 리버스 프록시로 실행되고 있는 것을 볼 수 있습니다.

check nginx

HTTPS로 Cachet 보호하기

이 시점에서 Cachet는 컨테이너에서 실행되고 있으며 Nginx를 리버스 프록시로 구성했습니다. Cachet를 보호하기 위해 SSL 인증서를 생성하고 Certbot 및 Letsencrypt를 통해 HTTPS를 구현합니다.

다음 apt 명령어를 사용하여 Certbot 및 Certbot Nginx 플러그인을 설치합니다. 설치를 확인하려면 Y를 입력합니다.

sudo apt install certbot python3-certbot-nginx

이제 아래 certbot 명령어를 실행하여 SSL 인증서를 생성하고 Cachet를 HTTPS로 보호합니다. 도메인 이름과 이메일 주소를 자신의 정보로 변경하는 것을 잊지 마십시오.

sudo certbot --nginx

프로세스가 완료되면 SSL 인증서는 /etc/letsencrypt/live/domain.com 디렉토리에 저장되며 Cachet 설치는 HTTPS로 보호됩니다.

Cachet 설치하기

선호하는 웹 브라우저를 사용하여 https://status.howtoforge.local/와 같은 Cachet 도메인 이름을 방문합니다. 설치 마법사를 볼 수 있습니다.

환경 설정 섹션에서 기본 Cache, Queue 및 Session을 데이터베이스로 선택하고 SMTP 세부정보를 입력합니다.

env setup

첫 번째 상태 페이지를 생성하고 다음을 클릭하여 계속합니다.

create first page

새 관리자 사용자, 이메일 주소 및 Cachet 설치를 위한 비밀번호를 입력합니다.

setup admin

설치가 완료되면 Cachet가 성공적으로 구성되었습니다.라는 출력을 볼 수 있습니다. 그런 다음 대시보드로 이동을 클릭하여 Cachet에 접근합니다.

install success

관리자 사용자와 비밀번호를 입력한 후 로그인을 클릭합니다.

정확한 자격 증명이 있는 경우 다음과 같은 Cachet 대시보드를 볼 수 있습니다:

dashboard

결론

축하합니다! 우분투 24.04 서버에 Docker를 사용하여 Cachet 상태 페이지 설치를 완료했습니다. Nginx를 Cachet의 리버스 프록시로 구성하고 Certbot 및 Letsencrypt를 통해 Cachet를 HTTPS로 보호했습니다. 이제 Cachet를 사용하여 웹사이트나 서비스를 추가하고 모니터링하며 이메일 주소 등으로 추가 알림을 설정할 수 있습니다.