Files
2025-12-16 09:43:36 +00:00

4.6 KiB

uwuzu for Docker Compose

uwuzuがDocker Composeで動きます。
※1: 一部バージョンでは動かない可能性があります。
※2: 動作保証は致しません。
※3: セキュリティ上の問題が発生する可能性があるため本番環境では推奨しません。

構造

/.env

.env.exampleのコメントに従って入力してください。

/src/

srcフォルダにuwuzuのリポジトリで配布されているZIPファイルを展開してください。

/db/・/php/

設定ファイルやDockerfileなどがあります。
動作しない場合は適宜修正してください。 余裕があればIssue・プルリクエストのご協力をお願いします。

前提条件

必須

Docker Composeが必要です。
※Windows containersは利用できません。

動作確認済み

OS: Windows 11 23H2
WSLカーネル: 2.6.1.0
Docker Compose: v2.40.2-desktop.1
uwuzu:
  - v1.5.4
  - v1.6.0
  - v1.6.6

使い方

構築

2つの方法がありますが、どちらの場合も絶対にホスト側の/src/.source-flagを削除しないでください。(コンテナ内では自動的に削除されます)
uwuzu for Docker ComposeではGitやDockerfileの都合で.source-flagを必要とし、/srcのファイル/ディレクトリ数を参照して自動ダウンロードを判断します。
.source-flagを含めたsrcフォルダのファイル/ディレクトリ数が1つ以下の場合に自動ダウンロードを実行する仕様です。

自動ダウンロードを使用する

  1. /.env.exapleのコメントに従って/.envを作成。
  2. /php/apache2.conf/php/php.iniを適宜変更。
  3. プロジェクトルートでdocker-compose buildを実行。 以降は独自のソースコード(改変uwuzu)を使用するの手順5から同等ですのでそちらをご確認ください。

独自のソースコード(改変uwuzu)を使用する

  1. /.env.exampleのコメントに従って/.envを作成。
  2. /src/以下にuwuzuのリポジトリで配布されているZIPファイルを展開。
  3. /php/apache2.conf/php/php.iniを適宜変更。
  4. プロジェクトルートでdocker-compose buildを実行。
  5. docker-compose upでuwuzu及びMariaDBが起動します。
  6. ブラウザでuwuzuの/adminに移動し初期設定を行います。
  7. uwuzuの表示に従って初期設定を進めます。 データベース名にはuwuzu、ホストにはdbを使用してください。uwuzuデータベースは自動的に作成されています。
    ユーザーにはroot、あるいは/.envで設定したMARIADB_USERを使用し、パスワードは/.envで設定したMARIADB_ROOT_PASSWORDMARIADB_PASSWORDを使用してください。 これにてuwuzuの構築は完了です。

今後uwuzuの破壊的変更により/db//php/の設定が利用できなくなる可能性があります。
その場合はIssueを立てuwuzuのバージョンアップを報告するか対応を待機、あるいは自身で設定を変更してください。
(余裕があれば動作した設定をプルリクエストするご協力をお願いします。)

アップデート

※1: 飛び級アップデートは利用できません。リリース順にアップデートしてください。
※2: アップデート後にuwuzuが破損する可能性があるためバックアップをしてから行ってください。
※3: .envのUWUZU_SOURCE_TAG/UWUZU_SOURCE_FILENAMEはビルドする際のものです。

  1. uwuzuのリリースノートを参照し変更が必要な対応を行ってください。
  2. uwuzuのリリースを参照し対象のバージョンのZIPファイルをダウンロード。
  3. /settings_admin/update_admin.phpにアクセスし行程1でダウンロードしたZIPファイルを指定。
  4. 確認画面に移動するので問題がない場合はアップデートボタンを選択してください。
    これにてuwuzuのアップデートは完了です。

自動アップデートが使用できない場合

uwuzuの公式ドキュメントに従ってアップデートしてください。

備考

問題が発生した場合はIssueを立ててください。