KUSANAGI 9クイックスタート

WordPressを動かしてみましょう

KUSANAGI 9がインストールされている仮想マシンを立ち上げましたか？
それでは早速、KUSANAGI 9をセットアップして、WordPressを動かすところまでやってみましょう。

仮想マシンにログイン

まずは、仮想マシンにログインしてください。
仮想マシンへのログイン方法は、クライアントがLinuxであればsshコマンドを利用してログインしてください。
クライアントがWindowsであればこちらを参照してください。

KUSANAGI 9の初期設定

仮想マシンにログインできたら、初期設定を行いましょう。
初期設定には専用の「KUSANAGIコマンド」を使用します。
「KUSANAGIコマンド」は、初期設定のほか、Webサーバーの切替え、キャッシュの制御なども行えるKUSANAGI専用のコマンドです。
「KUSANAGIコマンド」の詳細はこちらに一覧がありますのでそちらを参照してください。

ここからの手順ではKUSANAGI 9の初期設定を行い、WordPressをプロビジョン可能な状態にする手順について説明します。

初期設定の実行の前に

KUSANAGIコマンドによる初期設定を行う前に、まずOS（※）やKUSANAGIシステムのアップデートを dnf を利用して行います。

※KUSANAGI 9が利用できるOSの一覧は以下の通りです。
　クラウドベンダーによって提供されているOSは変わります。

CentOS Stream 8
CentOS Stream 9
AlmaLinux OS 8
AlmaLinux OS 9

仮想マシンにログインしたユーザーが root ユーザではない場合は、以下のように入力して root ユーザーへ切り替えてください。
仮想マシンにログインしたユーザーが root ユーザである場合は、この手順は不要です。

# sudo su -

続いて次のように入力し、アップデートを開始します。

# dnf upgrade -y

アップデートが完了したら、次のように入力し、一度サーバを再起動します。

# reboot

再起動を行いますと接続が切れますので、再度ログインしてから root ユーザーへ切り替え、初期設定の実行へ進みます。

初期設定の実行

仮想マシンにおけるLinuxのユーザ、データベースのユーザーのパスワードの設定、利用するミドルウェアの設定を行います。

# kusanagi init --passwd "パスワード" --nophrase --dbrootpass "パスワード" --nginx124 --php80 --mariadb10.6

オプションには必須のオプションと任意のオプションがあります。
オプションの内容については以下で説明します。

注意：TLS用ホスト鍵ファイルの生成には時間がかかります

初期設定で、TLSセッションチケットファイル、DH(Diffie-Hellman)鍵交換で使用するパラメータファイルを生成します。
これらのファイルは /etc/opt/kusanagi/ssl 下に生成され、すでに生成しているときは再生成しません。
マシンの性能によっては、このファイル生成に数分かかることがありますので、ご注意ください。

必須のオプション

kusanagiユーザーのパスワードの設定

kusanagiユーザーのパスワードの設定を行うために、--passwd オプションを指定します。
--passwd の指定は必須で、省略できません。
--passwd に指定した値を、kusanagiユーザーのパスワードとして設定します。

--passwd "パスワード"

kusanagiユーザーのSSHユーザ鍵のパスフレーズの設定

kusanagiユーザーのSSHユーザー鍵のパスフレーズの設定を行うために、--phrase または --nophrase オプションを指定します。
--phrase または --nophrase のいずれかの指定は必須で、省略できません。
--phrese に指定した値を、kusanagiユーザーのSSHユーザ鍵のパスフレーズとして設定します。
パスフレーズには5文字以上の文字列を指定してください。
--nophrese を指定すると、kusanagiユーザーのSSHユーザ鍵のパスフレーズに空文字列を設定します（値の指定は不要です）。

--phrase "パスフレーズ"

--nophrase

MariaDBのrootパスワードの設定

MariaDBのrootパスワードを設定を行うために、--dbrootpass オプションを指定しします。
--dbrootpass の指定は必須で、省略できません。
--dbrootpass に指定した値を、MariaDBのrootパスワードとして設定します。
このパスワードには、アルファベット大文字小文字、数字、「.!#%+_-」のいずれかで構成される 8文字以上の文字列を設定してください。

--dbrootpass "パスワード"

任意のオプション

以下のオプションは任意のオプションです。
ミドルウェアの設定に特にこだわりがない方は、「初期設定の完了」まで進んでください。

Webサーバの選択

起動するWebサーバをnginx、httpd(Apache) から選択します。それぞれ指定したときは以下のWebサーバを起動します（一部抜粋です）。
省略した場合は --nginx125 (NGINX 1.25) を指定したこととなります。

--nginx125 : NGINX 1.25
--nginx124 : NGINX 1.24
--httpd24 : Apache HTTPD 2.4

--nginx125、--nginx124、--httpd24 は複数指定できません。

--nginx124

PHPの選択

使用するPHPのバージョンを選択します。それぞれ指定したときは以下のPHPを使用します（一部抜粋です）。
省略した場合は --php81(PHP 8.1) を指定したこととなります。

--php82 : PHP 8.2
--php81 : PHP 8.1
--php80 : PHP 8.0

--php82、--php81、--php80 は複数指定できません。

--php80

MariaDB(MySQL)の選択

使用するMariaDB(MySQL)のバージョンを選択します。それぞれ指定したときは以下のMariaDBを起動します（一部抜粋です）。
省略した場合は --mariadb10.5(MariaDB 10.5) を指定したこととなります。

--mariadb10.5 : MariaDB 10.5
--mariadb10.6 : MariaDB 10.6
--mariadb10.11 : MariaDB 10.11

--mariadb10.5、--mariadb10.6、--mariadb10.11 は複数指定できません。

--mariadb10.6

初期設定の完了

オプションを指定してコマンドを実行します。
次のように「init completed.」というメッセージが表示されれば、初期設定は完了です。

# kusanagi init --passwd "パスワード" --nophrase --dbrootpass "パスワード" --nginx124 --php80 --mariadb10.6

(途中省略)

init completed.

これでWordPressがプロビジョンできる状態になりました。
続いて、WordPressのプロビジョニング（展開）を実行しましょう。

初期設定コマンド及びオプションをさらに詳しく知りたい方は、kusanagi initのページを参照してください。

WordPressのプロビジョニング

KUSANAGI 9の初期設定が完了したら、WordPressのプロビジョニング（配置）を行いましょう。
プロビジョニングには初期設定と同じく、専用の「KUSANAGIコマンド」を使用します。

KUSANAGIコマンドでWordPressを使用するためのプロファイルを作成します。
これにより、Webサーバの設定ファイル、MariaDB(MySQL)のデータベースや、ドキュメントルートなどがプロビジョニングされます。
プロファイルの説明はこちらを参照してください。

※このクイックスタートではWordPressをプロビジョンしますが、KUSANAGI 9では他にもLAMP、FCGI、Movable Type、Drupal をプロビジョニングできます。

プロビジョニングの実行の前に

仮想マシンにログインしたユーザーが root ユーザではない場合は、以下のように入力して root ユーザーへ切り替えてください。
仮想マシンにログインしたユーザーが root ユーザである場合や、初期設定から引き続きrootユーザーで実行している場合はこの手順は不要です。

# sudo su -

プロビジョニングの実行

KUSANAGI 9のプロビジョニングは、以下のコマンドを使います。

# kusanagi provision [options] "任意のプロファイル名"

/home/kusanagi/ の下に上記で指定した “任意のプロファイル名” のディレクトリが作成されます。
この中にドキュメントルートが作成され、必要なデータが格納されます。

必須オプション

プロビジョニングの種類の選択

プロビジョニングするCMSをオプションに指定することで、プロビジョニングするCMSを選ぶことができます。
このクイックスタートでWordPressをプロビジョニングするので、--wpを指定します。
--wpの指定は必須で、省略できません。

--wp

ホスト名の設定

作成するプロファイルで使用するホスト名(FQDN)の設定を行うために、--fqdnオプションを指定します。
--fqdn の指定は必須で、省略できません。
--fqdn に指定した値を、ホスト名として設定します。

--fqdn www.example.com

※http://や末尾の/は不要です。

SSL証明書(Let’s Encrypt)の設定

--fqdnで指定したホスト名に対応するLet’s EncryptのSSL証明書(※)を発行を行うために、--emailオプションを指定します。
SSL証明書の取得が不要な場合は、--noemailオプションを指定します。
--email または --noemail のいずれかの指定は必須で、省略できません。

--email に指定した値をもって、Let’s EncryptにSSL証明書の取得を行います。
--noemail を指定すると、Let’s EncryptのSSL証明書を取得しません（値の指定も不要です）。

--email kusanagi@example.com

--noemail

※Let’s EncryptのSSL証明書について

Let’s Encryptは認証局(CA)として「SSL/TLSサーバ証明書」を無料で発行するプロジェクトです。
詳細は公式サイトをご覧ください。
--emailにメールアドレスを指定することでLet’s Encryptの使用に同意したことになります。
Let’s Encryptは、ドメイン認証によるSSL/TLSサーバ証明書です。
利用するには、認証の仕組み上、取得するFQDNの名前解決ができること、httpのアクセスに認証がかかっていないことが必要です。
また、Let’s Encryptのドメイン単位での利用制限が定められており、仮想マシン作成時にクラウドより付与されるFQDNは利用できません。
--noemailを指定し、SSL証明書を取得しなかった場合も、プロビジョニング完了後でに kusanagi ssl コマンドにて、Let’s EncryptのSSL証明書を取得することが可能です。
詳しくは、kusanagi sslのドキュメントを参照してください。

データベース名の設定

データベース名を設定を行うために、--dbname オプションを指定します。
--dbnameの指定は必須で、省略できません。
--dbname で指定した値を、データベース名として設定します。

--dbname kusanagi_db

データベースのユーザー名の設定

上記で作成したデータベースのユーザー名を設定を行うために、--dbuserオプションを指定します。
--dbuser の指定は必須で、省略できません。
--dbuser で指定した値を、データベースユーザー名として設定します。

--dbuser kusanagi_db

データベースのユーザーのパスワードの設定

上記で作成したデータベースのユーザーのパスワードを設定を行うために、--dbpassオプションを指定します。
--dbpass の指定は必須で、省略できません。
--dbpass で指定した値を、データベースユーザーのパスワードとして設定します。

--dbpass "パスワード"

プロビジョニングの完了

オプションを指定してコマンドを実行します。
次のように「provison completed.」メッセージが表示されれば、プロビジョニングは完了です。

# kusanagi provision --wp --fqdn www.example.com --email kusanagi@example.com --dbname kusanagi_db --dbuser kusanagi_db --dbpass "パスワード" "任意のプロファイル名"

(途中省略)

Provisioning of "任意のプロファイル名" completed. Access www.example.com and install wp.
provison completed.

これでWordPressのプロビジョニングまで完了しました。
続いて、WordPressのインストールを行いましょう。

プロビジョニングコマンド及びオプションをさらに詳しく知りたい方は、kusanagi provisionのページを参照してください。

WordPressのインストール

WordPressのインストールはブラウザから行えるので、まずブラウザを立ち上げます。
ブラウザからプロビジョニング時に指定したホスト名(FQDN)にアクセスします。

KUSANAGI 8ではデータベースの接続設定を入れる必要がありましたが、KUSANAGI 9では必要ありません。
自動的にデータベースへの接続設定まで終わっている状態です。

必要情報の入力

ホスト名(FQDN)にアクセスすると、必要情報の入力画面になります。
WordPressサイトの基本情報、サイト管理者のユーザー情報等を入力します。

① 次のように入力します。

サイトのタイトル	任意のWebサイトのタイトル
ユーザー名	WordPressの管理ユーザー名
パスワード	WordPressの管理画面にログインするためのパスワード
メールアドレス	WordPressからの通知メールを受け取るメールアドレス
検索エンジンでの表示	検索エンジンによるインデックスを許可するか否か

② すべて入力したら、「WordPressをインストール」をクリックします。

インストール結果の確認

インストールが成功すると、以下の画面が表示されます。

① 「成功しました！」画面が表示されますので、「ログイン」リンクをクリックします。

管理画面にログイン

ログイン画面が表示されたら、必要情報の入力で入力したユーザー名、パスワードを入力してWordPressの管理画面にログインします。

パーマリンク設定の確認

「設定」のサブメニュー「パーマリンク」をクリックし、「パーマリンク設定」の「共通設定」->「パーマリンク構造」を確認します。
必要に応じて設定を変更し、URLのカスタマイズを行います。

「KUSANAGI」メニューより、KUSANAGI専用の高速化に関する設定を行うことができます。
機能、および設定方法については、KUSANAGI専用プラグインのページをご覧ください。

確認が終わりましたら、管理画面の左上のサイトのタイトル（例では家のマークの隣の「KUSANAGI」と表示されている部分）をクリックし、トップページを表示します。

トップページの表示を確認

以下のようにトップページが正しく表示されればインストールは完了です（表示される内容はテーマによって変わります）。

おめでとうございます！　これでWordPressを動かすことができました。
あとは、自由にサイトをカスタマイズして、思い通りのサイトを構築してください。

KUSANAGIコマンドの詳細はこちらのドキュメントを参照してください。
WordPressのサポートはこちらを参照してください。