Debian 9にCachetステータスページシステムをインストールする方法

Cachetは、PHPで書かれた美しく強力なオープンソースのステータスページシステムで、ダウンタイムやシステム障害を顧客、チーム、株主により良く伝えることができます。このアプリケーションは、多くの機能を提供しており、その中でも特に注目すべきは、強力なJSON API、インシデントレポート、メトリクス、インシデントメッセージ用のMarkdownサポート、メールによるサブスクライバー通知、二要素認証です。このチュートリアルでは、PHP、Nginx、MariaDB、およびComposerを利用してCachetステータスページシステムをインストールします。

要件

PHPバージョン5.5.9以上
PHPサポートのあるHTTPサーバー（例：Nginx、Apache、Caddy）
Composer
サポートされているデータベース：MySQL、PostgreSQL、またはSQLite

前提条件

Debian 9を実行しているサーバー。非rootユーザーでsudo権限を持っていること。

初期ステップ

Debianのバージョンを確認します：

lsb_release -ds  
# Debian GNU/Linux 9.5 (stretch)

タイムゾーンを設定します：

timedatectl list-timezones  
sudo timedatectl set-timezone 'Region/City'

オペレーティングシステムのパッケージを更新します：

sudo apt update && sudo apt upgrade -y

vim、git、socatパッケージをインストールします：

sudo apt install -y vim git socat sudo

ステップ1 - PHPをインストール

PHPと必要なPHP拡張をインストールします：

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-xml php7.0-gd php7.0-zip php7.0-mbstring php7.0-mysql php7.0-pgsql php7.0-sqlite3 php7.0-mcrypt php-apcu

PHPのバージョンを確認します：

php --version  
# PHP 7.0.30-0+deb9u1 (cli) (built: Jun 14 2018 13:50:25) ( NTS )

ステップ2 - MariaDBをインストールし、Cachet用のデータベースを作成

CachetはMySQL/MariaDB、PostgreSQL、およびSQLite3データベースをサポートしています。このチュートリアルでは、データベースサーバーとしてMariaDBを使用します。

MariaDBデータベースサーバーをインストールします：

sudo apt install -y mariadb-server

MariaDBのバージョンを確認します：

mysql --version  
# mysql  Ver 15.1 Distrib 10.1.26-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

mysql_secure_installationスクリプトを実行してMariaDBのセキュリティを向上させ、MySQLのrootユーザーのパスワードを設定します：

sudo mysql_secure_installation

各質問に答えます：

Enter current password for root (enter for none): Press Enter  
Set root password? [Y/n] Y  
New password: your_secure_password  
Re-enter new password: your_secure_password  
Remove anonymous users? [Y/n] Y  
Disallow root login remotely? [Y/n] Y  
Remove test database and access to it? [Y/n] Y  
Reload privilege tables now? [Y/n] Y

rootユーザーとしてMySQLシェルに接続します：

mysql -u root -p  
# Enter password

Cachet用の空のMariaDBデータベースとユーザーを作成し、資格情報を記録します：

MariaDB [(none)]> CREATE DATABASE dbname;  
MariaDB [(none)]> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
MariaDB [(none)]> FLUSH PRIVILEGES;

MariaDBから退出します：

MariaDB [(none)]> exit

dbname、username、およびpasswordを自分の名前に置き換えます。

ステップ3 - Acme.shクライアントをインストールし、Let’s Encrypt証明書を取得（オプション）

HTTPSでステータスページを保護することは必須ではありませんが、サイトトラフィックを保護するための良いプラクティスです。Let’s EncryptからSSL証明書を取得するために、Acme.shクライアントを使用します。Acme.shは、依存関係ゼロでLet’s EncryptからSSL証明書を取得するための純粋なUnixシェルソフトウェアです。

Acme.shをダウンロードしてインストールします：

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh   
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

Acme.shのバージョンを確認します：

/etc/letsencrypt/acme.sh --version  
# v2.8.0

ドメイン/ホスト名のためにRSAおよびECC/ECDSA証明書を取得します：

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d status.example.com --ocsp-must-staple --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d status.example.com --ocsp-must-staple --keylength ec-256

上記のコマンドを実行した後、証明書とキーは以下の場所にあります：

RSAの場合：/etc/letsencrypt/status.example.comディレクトリ。
ECC/ECDSAの場合：/etc/letsencrypt/status.example.com_eccディレクトリ。

ステップ4 - Nginxをインストールして構成

Cachetは多くのWebサーバーで正常に動作します。このチュートリアルでは、Nginxを選択しました。

Nginxをインストールします：

sudo apt install -y nginx

Nginxのバージョンを確認します：

sudo nginx -v  
# nginx version: nginx/1.10.3

Cachet用にNginxを構成するには、次のコマンドを実行します：

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

次の構成でファイルを埋めます：

server {  
  listen 80;  
  listen [::]:80;  
  server_name status.example.com;  
  root /var/www/cachet/public;  
  index index.php;  
  ssl_certificate /etc/letsencrypt/status.example.com/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/status.example.com/status.example.com.key;  
  ssl_certificate /etc/letsencrypt/status.example.com_ecc/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/status.example.com_ecc/status.example.com.key;  
  location / {  
    try_files $uri /index.php$is_args$args;  
  }  
  location ~ \.php$ {  
    include fastcgi_params;  
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;  
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    fastcgi_index index.php;  
    fastcgi_keep_conn on;  
  }  
}

新しいcachet.conf構成を有効にするには、ファイルをsites-enabledディレクトリにリンクします：

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

NGINX構成をテストします：

sudo nginx -t

Nginxを再読み込みします：

sudo systemctl reload nginx.service

ステップ5 - Composerをインストール

PHP依存関係マネージャーであるComposerをグローバルにインストールします：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"  
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"  
php composer-setup.php  
php -r "unlink('composer-setup.php');"  
sudo mv composer.phar /usr/local/bin/composer

Composerのバージョンを確認します：

composer --version  
# Composer version 1.7.2 2018-08-16 16:57:12

ステップ6 - Cachetをインストール

Cachetが存在するドキュメントルートディレクトリを作成します：

sudo mkdir -p /var/www/cachet

ドキュメントルートディレクトリに移動します：

cd /var/www/cachet

GitでCachetのソースコードをダウンロードし、最新のタグ付けされたリリースにチェックアウトします：

git clone https://github.com/cachethq/Cachet.git .  
git tag -l  
git checkout v2.3.15

.env.exampleを.envファイルにコピーし、.envファイル内のデータベースおよびAPP_URL設定を構成します：

cp .env.example .env  
vim .env

ComposerでCachetの依存関係をインストールします：

composer install --no-dev -o

アプリケーションキーを設定するには、次のコマンドを実行します：

php artisan key:generate

Cachetをインストールします：

php artisan app:install

/var/www/cachetディレクトリの所有権をwww-data:に変更します：

sudo chown -R www-data:www-data /var/www/cachet

ウェブブラウザでサイトを開き、画面の指示に従ってCachetのインストールを完了します。

ステップ7 - Cachetのセットアップを完了

キャッシュとセッションドライバーを選択し、メールオプションを構成します： Cachetのセットアップを完了

サイト名、サイトドメイン、タイムゾーン、言語などの一般的なサイト設定を構成します： Cachet一般設定

管理ユーザーアカウントを作成します：管理アカウントを追加

その後、Cachetが正常に構成されたというメッセージが表示されるはずです。「ダッシュボードに移動」ボタンを押してCachetダッシュボードを開くことができます： Cachetが正常にインストールされました

Cachetのインストールとセットアップが完了しました。

Cachetダッシュボードにアクセスするには、ウェブサイトのURLに/dashboardを追加します。

Cachetダッシュボード

リンク

https://cachethq.io/

要件