KUSANAGI 8 から KUSANAGI 9 の変更点

『KUSANAGI 9』

最新の CentOS 8 をベースにした KUSANAGI 最新版です。

  • CentOS 8 ベース
  • ミドルウェアバージョン切り替え(nginx、httpd、mariadb)
    • 安定稼働の組み合わせや最新バージョンの組み合わせなど、よりお好みの環境を構築しやすくなりました。
  • 各種コマンド類を Python ベースにリファクタリング
    • KUSANAGI コマンドを内部的にリファクタリングし、間違ったオプションの組み合わせを検出するようになりました。
    • 以前のバージョンは、重複する組み合わせのオプションを指定された場合、特にエラーを表示することなく最後に指定されたオプションを選択するようになっていました。期待しない環境を構築する恐れがあったため、KUSANAGI 9 ではオプションの組み合わせで重複する設定があった場合にはエラーを返すように設計されています。
    • ヘルプ -h / --help オプションが kusanagi コマンドおよび kusanagi サブコマンドすべてで表示されるようになりました。

『KUSANAGI 9』の変更点

インストール先を /opt/kusanagi 配下へ変更

KUSANAGI 9 では、kusanagi コマンドや kusanagi の各モジュールと設定ファイルを /opt/kusanagi 配下にインストールするように変更しました。
kusanagi コマンドのフルパスは /opt/kusanagi/bin/kusanagi となります。
従来通り kusanagi で使用したい場合は、alias を作る、あるいは、パスを通すなどしてください。

プロファイル指定を target サブコマンドから各種サブコマンドのオプション指定へ変更

KUSANAGI 9 では、サブコマンドの対象プロファイル指定を各コマンドのオプションとして追加するように変更しました。
オプションにプロファイル指定を追加できるコマンドは以下の通りです。

KUSANAGI 8KUSANAGI 9備考
target {profile}status {option} {profile}
update {option} {profile}
remove {option} {profile}
bcache {option} {profile}
fcache {option} {profile}
configure {option} {profile}
monit {option} {profile}
ssl {option} {profile}
各サブコマンドでプロファイルを指定できるように変更しました。
プロファイルの指定は省略できます。その場合は、現在のカレントディレクトリのプロファイルに対し各サブコマンドを実行します。以前のバージョンでは target サブコマンドでプロファイルを変更した後に、各サブコマンドを実行していました。
プロファイルの指定方法の変更に伴い、target サブコマンドは廃止となりました。

サブコマンド名の変更

KUSANAGI 8KUSANAGI 9備考
php7phpサブコマンド名を変更しました。
ruby24rubyサブコマンド名を変更しました。
settingconfigureサブコマンド名を変更しました。

【注意】KUSANAGI 9 より configure サブコマンドは以前バージョンと機能が異なります。

kusanagi init のオプション変更

KUSANAGI 8KUSANAGI 9備考
--nginx--nginx121
--nginx120
--nginx119
--nginx118
ウェブサーバーのミドルウェアとバージョンを指定するよう、オプション名が変更されました。
--httpd--httpd24
--php7--php80
--php74
--php73
PHP のバージョンを指定するよう、オプション名が変更されました。
--hhvm
--php5
(廃止)CentOS 8 のサポート対象外バージョンにつき、オプションは廃止になりました。
--ruby24--ruby
--ruby26
Ruby サポートバージョン変更につき、オプション名が変更されました。
--dbsystem--mariadb10.3
--mariadb10.4
--mariadb10.5
データベースのミドルウェアとバージョンを指定するよう、オプション名が変更されました。
--psql(検討中)PostgreSQL の動作を検証中のため使用できません。

kusanagi provision のオプション変更

KUSANAGI 8KUSANAGI 9備考
--WordPress
--wordpress
--wp
--wordpress
WordPress 環境をプロビジョンするオプションのうち、大文字の --WordPress オプションは廃止になりました。
新たに --wp オプションが使用できます。
小文字の --wordpress オプションは従来通り使用できます。
--c5
--concrete5
(検討中)WordPress を除く各種CMS/フレームワークは検討中のため使用できません。
--drupal
--drupal8
--drupal7
--rails
--RubyonRails
--woo
--WooCommerce

kusanagi bcache / kusanagi fcache のオプション変更

 

KUSANAGI 8KUSANAGI 9備考
bcachebcache statusステータスを確認する場合は、オプション (指定なし) から status を指定する方式に変わりました。
fcachefcache status
bcache clear [path [--dryrun]][--dryrun] bcache clear [--path /path/to]--dryrun オプションは、各サブコマンドで共通して使える --dryrun オプションに変更となりました。
--dryrun オプションはサブコマンドの直前に指定してください。
fcache clear [path [--dryrun]][--dryrun] fcache clear [--path /path/to]

kusanagi nginx / kusanagi httpd / kusanagi php / kusanagi dbinit mariadb / kusanagi ruby
ミドルウェアのバージョン切替 --use オプションの追加

kusanagi init 後にミドルウェアのバージョンを切り替える際に使用するサブコマンドとなります。

KUSANAGI 8KUSANAGI 9備考
(なし)nginx [--use {installed | nginx121| nginx120 | nginx119 | nginx118}]
httpd [--use {installed | httpd24}]
php [--use {installed | php80 | php74 | php73}]
dbinit mariadb [--use {installed | mariadb10.5 | mariadb10.4 | mariadb10.3}]
ruby [--use {installed | ruby:2.6}]
ミドルウェアバージョン変更の --use オプション追加

dbinit のオプション必須化

KUSANAGI 8KUSANAGI 9備考
dbinitdbinit mariadbdbinit はオプションが必須のサブコマンドになりました。

update cert のプロファイル指定廃止

KUSANAGI 8KUSANAGI 9備考
update cert {profile}update certプロファイルの指定はできなくなりました。

廃止されたサブコマンド

KUSANAGI 8KUSANAGI 9備考
hhvm
warm-up
(廃止)CentOS 8 で HHVM のサポート対象外バージョンにつき、このサブコマンドは廃止になりました。
php-fpm(廃止)CentOS 8 で PHP 5 のサポート対象外バージョンにつき、このサブコマンドは廃止になりました。
httpsssl --httpsssl コマンドのオプションで実行可能であるコマンドのため、このサブコマンドは廃止になりました。
autorenewalssl --auto
configuredbinit
php
configure コマンドは2つのコマンドに機能を移管したため、このサブコマンドは廃止となりました。
・データベースのパラメータの調整は、dbinit コマンドで調整
・PHPのパラメータの調整は、php コマンドで調整
【注意】KUSANAGI 9 より configure サブコマンドは別のサブコマンドとなりますので、前バージョンと機能が異なります。
target(廃止)プロファイルの変更は、各サブコマンドの実行時にオプションでプロファイルを指定するように変更されました。
例)kusanagi bcache on {profile}

未実装のサブコマンド

KUSANAGI 8KUSANAGI 9備考
addon(未実装)このサブコマンドは未実装です。
images(未実装)このサブコマンドは未実装です。
selinux(未実装)このサブコマンドは未実装です。
upgrade(未実装)このサブコマンドは未実装です。
zabbix(未実装)このサブコマンドは未実装です。

『KUSANAGI 9』の変更に伴う注意点

下記のミドルウェアは CentOS 8 側もしくはミドルウェア側でサポートを終了しております。以下の環境をご利用の方はご注意ください。

  • HHVM は動作環境対象外となりました。
  • PHP 5 は動作環境対象外となりました。
  • MariaDB 10.1 は動作環境対象外となりました。

下記のミドルウェアは KUSANAGI9 で未実装のためサポート対象外となっております。ご了承ください。

  • PostgreSQL
  • WordPress を除くCMS及びフレームワーク