Ubuntu 24.04サーバーにCachetステータスページをインストールする方法

CachetはPHPで書かれたオープンソースのステータスページシステムです。インフラストラクチャのダウンタイムやシステム障害を監視することができます。CachetはJSO APIを提供し、レポート、メトリクス、複数の通知方法、二要素認証も備えています。

このチュートリアルでは、Dockerを使用してUbuntu 24.04サーバーにCachetをインストールして実行する方法を学びます。また、Nginxをリバースプロキシとしてインストールし、CertbotとLetsencryptを使用してCachetをHTTPSで保護します。

前提条件

このガイドを完了するには、以下を確認してください：

• Ubuntu 24.04サーバー。
• 管理者権限を持つ非ルートユーザー。
• サーバーのIPアドレスを指すドメイン名。

Dockerエンジンのインストール

このガイドでは、Dockerを使用してCachetをコンテナとして実行します。次に、Ubuntuシステムに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

次に、Ubuntuパッケージインデックスを更新し、以下のaptコマンドでDockerエンジンをインストールします。インストールを確認するためにYを入力します。

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

インストール後、DockerサービスはUbuntuシステムで実行され、有効になっているはずです。

以下のコマンドを実行してDockerサービスを確認します。

sudo systemctl is-enabled docker  
sudo systemctl status docker

以下のような出力が表示されます：

Dockerを実行するユーザーの設定

Dockerをインストールした後、ユーザーをdockerグループに追加する必要があります。これにより、非ルートユーザーとしてコンテナを実行できるようになります。

ユーザーをdockerグループに追加するには、以下のコマンドを実行します。ユーザー名は自分のユーザーに変更してください。

sudo usermod -aG docker username

今、ユーザーでログインし、dockerコマンドを実行して設定を確認します。

su - username  
docker run hello-world

設定が成功していれば、Dockerからの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

デフォルトポートをコンテナとDockerホストの両方で8000に変更します。

ports:  
 - 8000:8000

ファイルを保存して終了します。

次に、以下のdockerコマンドを実行してCachetイメージをビルドし、Cachetコンテナを起動します。

docker compose build  
docker compose up

ビルドプロセス中に、以下のような表示がされます：

Cachetコンテナを起動すると、以下のような出力が得られます：

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で実行されているのが確認できます。

Nginxをリバースプロキシとして設定

このガイドでは、NginxをリバースプロキシとしてCachetを実行します。したがって、Nginxをインストールし、リバースプロキシ用の新しいサーバーブロックを作成します。ドメイン名が準備され、サーバーのIPアドレスを指していることを確認してください。

Nginxウェブサーバーをインストールするには、以下のaptコマンドを実行します。インストールを進めるためにYを入力します。

sudo apt 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-は成功しました - 構文は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インストールのリバースプロキシとして実行されているのが確認できます。

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をDatabaseとして選択し、SMTPの詳細を入力します。

最初のステータスページを作成し、次へをクリックして続行します。

新しい管理者ユーザー、メールアドレス、およびCachetインストール用のパスワードを入力します。

インストールが完了すると、Cachetが正常に構成されました。という出力が表示されます。その後、ダッシュボードに移動をクリックしてCachetにアクセスします。

管理者ユーザーとパスワードを入力し、ログインをクリックします。

正しい資格情報があれば、以下のようなCachetダッシュボードが表示されます。

結論

おめでとうございます！Ubuntu 24.04サーバーにDockerを使用してCachetステータスページのインストールが完了しました。NginxをCachetのリバースプロキシとして設定し、CertbotとLetsencryptを通じてCachetをHTTPSで保護しました。これでCachetを使用してウェブサイトやサービスを追加および監視し、メールアドレスなどで追加の通知を設定できます。