開発運用

Cachet 状態ページの作成ガイド

最終更新： 2月 23, 2025
1 分の読み

Cachetで状態ページを作成する方法 (Debian 8におけるインストールと設定の完全ガイド)

はじめに

Cachetは、システムのステータスページを作成・管理するためのオープンソースツールで、特にサービスの稼働状況や障害情報を公開するために使用されます。Cachetは非常に柔軟で、デザインや機能もカスタマイズ可能です。この記事では、Debian 8環境にCachetをインストールし、基本的な設定を行い、状態ページを作成する方法を詳しく説明します。

関連記事

必要な前提条件

Cachetを正常にインストールするためには、いくつかの前提条件があります。以下のパッケージがインストールされていることを確認してください。

  • Debian 8（Jessie）
  • Nginx（Webサーバー）
  • PHP 7.0（もしくはそれ以上）
  • Composer（PHPの依存関係管理ツール）
  • MySQLまたはMariaDB（データベースサーバー）

以下に示す手順に従って、Cachetをインストールし、構成します。

ステップ1: 必要なパッケージのインストール

まず、Debian 8に必要なパッケージをインストールします。以下のコマンドを実行してください。

bash
sudo apt-get update
sudo apt-get install nginx mysql-server php7.0-fpm php7.0-mysql php7.0-xml php7.0-mbstring php7.0-curl php7.0-zip unzip curl git

これにより、Nginx、MySQL、PHPなどの基本的な依存関係がインストールされます。

ステップ2: Cachetのインストール

次に、CachetをGitHubからクローンし、インストールを行います。

bash
cd /var/www
sudo git clone https://github.com/CachetHQ/Cachet.git cachet
cd cachet

次に、Composerを使用して依存関係をインストールします。

bash
sudo curl -sS https://getcomposer.org/installer | php
sudo php composer.phar install --no-dev --optimize-autoloader

ステップ3: データベースの設定

CachetはMySQLまたはMariaDBを使用してデータを管理します。以下の手順でデータベースを作成し、適切なユーザーを設定します。

  1. MySQLにログインします。
bash
sudo mysql -u root -p
  1. 新しいデータベースを作成します。
sql
CREATE DATABASE cachet;
  1. Cachet用のユーザーを作成し、権限を付与します。
sql
GRANT ALL PRIVILEGES ON cachet.* TO 'cachetuser'@'localhost' IDENTIFIED BY 'yourpassword';
FLUSH PRIVILEGES;
EXIT;
  1. .envファイルを編集して、データベースの設定を更新します。
bash
cp .env.example .env
sudo nano .env

DB_*の項目を以下のように設定します。

env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=cachet
DB_USERNAME=cachetuser
DB_PASSWORD=yourpassword

ステップ4: Cachetのマイグレーション

次に、データベースのマイグレーションを実行します。これにより、Cachet用のテーブルがデータベースに作成されます。

bash
php artisan migrate --seed

ステップ5: アプリケーションキーの生成

Cachetではアプリケーションキーが必要です。次のコマンドでキーを生成します。

bash
php artisan key:generate

ステップ6: Nginxの設定

CachetをWebで公開するために、Nginxを設定します。以下の手順で設定を行います。

  1. Nginxの設定ファイルを作成します。
bash
sudo nano /etc/nginx/sites-available/cachet
  1. 以下の設定をファイルに追加します。
nginx
server {
    listen 80;
    server_name your_domain.com;

    root /var/www/cachet/public;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    error_log /var/log/nginx/cachet_error.log;
    access_log /var/log/nginx/cachet_access.log;
}
  1. シンボリックリンクを作成して、Nginxに設定を反映させます。
bash
sudo ln -s /etc/nginx/sites-available/cachet /etc/nginx/sites-enabled/
  1. Nginxを再起動します。
bash
sudo systemctl restart nginx

ステップ7: キャッシュとパーミッションの設定

Cachetが正しく動作するためには、キャッシュとストレージディレクトリに適切な権限を設定する必要があります。

bash
sudo chown -R www-data:www-data /var/www/cachet/storage /var/www/cachet/bootstrap/cache
sudo chmod -R 775 /var/www/cachet/storage /var/www/cachet/bootstrap/cache

ステップ8: 設定の確認

最後に、Cachetのセットアップが正常に行われたことを確認します。ブラウザを開き、http://your_domain.comにアクセスします。Cachetの状態ページが表示されるはずです。

ステップ9: 管理者アカウントの作成

状態ページにアクセスするためには、管理者アカウントを作成する必要があります。次のコマンドで管理者を作成します。

bash
php artisan cachet:install

これにより、インストールが完了し、管理者アカウントを設定するよう求められます。

まとめ

以上が、Debian 8上でCachetをインストールし、状態ページを設定するための手順です。Cachetは強力で柔軟なツールであり、システムの状態をユーザーにわかりやすく提供するために非常に役立ちます。設定が完了した後は、必要に応じてデザインや機能をカスタマイズして、より使いやすい状態ページを作成できます。

最終更新： 2月 23, 2025
1 分の読み
Back to top button