新しいプラグインを作成した場合は、リリース時にモノレポの分割対象のパッケージとして登録します。
パッケージの分割は、 master ブランチ、または、タグをプッシュした際には、GitHub Actions にて実行されますので、
/.github/workflow/split_monorepo.yml を編集して登録します。
jobs:
packages_split:
strategy:
matrix:
package:
-
local_path: 'new-plugin-name'
split_repository: 'new-plugin-name'
また、新しいプラグインのリポジトリを Packagist に登録します。
Dockerコンテナにログインし、マージコマンドを使って、パッケージの設定をルートの composer.json にマージします。
# PHPの実行環境が必要
cd docker
docker exec -it bc-php /bin/bash
vendor/bin/monorepo-builder merge
plugins/baser-core/VERSION.txt の先頭行をリリースするバージョン番号に変更し、変更内容をまとめます。
現在(2023年1月時点)では月に一度行われるマイルストーンミーティングにて、記載内容を決定します。
VERSION.txt に記載するログは、次の形式でまとめます。
-改修タイプ: [パッケージの省略文字] 改修内容
（例）
-BUG [BC] fixes #7385 RSSフィードの読込時に本文中の<img>タグが読み取れていない 問題を改善
改修タイプ
パッケージの省略文字
その後、コミットしてプッシュします。
git commit -a -m "basercms-5.x.x をリリース"
dev-5 ブランチを master ブランチにマージします。
git checkout master
git merge dev-5
モノレポを使うことで、GitHub 上のパッケージごとのレポジトリへ、一括でリリースすることができます。
リリースの際は、モノレポのリリースコマンドを実行します。
自動的にタグを作成しプッシュします。
GitHubへのプッシュ権限が必要となり、Dockerのコンテナ内で実行する場合、Gitのセットアップができているかを確認してください。
事前に dev-5 ブランチをプッシュすることでテストを行ってもよいかもしれません。
# PHPの実行環境が必要
vendor/bin/monorepo-builder release 5.x.x
親パッケージより一括リリースするため、子パッケージのレポジトリは、読み取り専用の扱いとします。
GitHubActions より、次の２つのCIが成功していることを確認します。
baser-core の Packagist に新しいバージョンが反映されているか確認します。
master ブランチにおいてのリリースコマンドで更新された composer.json の変更内容を、 dev ブランチにマージした上でプッシュします。
git checkout dev-5
git merge master
git push origin dev-5
Dockerコンテナにログインし、次のコマンドを実行しパッケージを作成します。
# PHPの実行環境が必要
bin/cake create release master
cd tmp
# バージョン番号付きのファイル名にリネーム
mv basercms.zip basercms-5.x.x.zip
master ブランチより作成しますので、必ずリリースコマンド実行後 に行う必要がありますが、開発ブランチでパッケージを作成し、インストール等の動作を確認したい場合は、branch オプションとして引数にブランチ名を追加します。
bin/cake create release dev-5
baserCMSのオフィシャルサイトの /files/basercms/ ディレクトリにアップロードします。
baserCMSのオフィシャルサイトのダウンロードページを更新します。過去バージョンダウンロードについても忘れないように更新します。
GitHubにて 新しいリリース記事 を作成します。
※ コミット履歴から参加者を抽出するコマンド git log --after="YYYY-MM-DD" --pretty=format:"%an" |sort| uniq
こちらの記事に先ほど作成した、basercms-5.x.x.zip を添付します。
必要があれば、baserCMS公式ガイドの機能一覧を更新します。
最後にbaserCMSのオフィシャルサイトでリリース記事を作成します。
その際、カテゴリについて「リリースノート」を選択します。
baserCMSプロジェクトメンバー名簿より、新しくメンバーとなった方で、スペシャルサンクスへの登録希望の方をピックアップし、baserCMS公式サイトのスペシャルサンクスリストに追加します。
バージョンアップした事を広く認知してもらえるよう、告知を行います。
これでリリース作業は完了です。お疲れさまでした。
plugins/baser-core/VERSION.txt の先頭行を開発バージョンに変更します。
コミットメッセージを バージョンを5.x.x開発版に変更 としdev-5ブランチにpushします。
バージョンアップに合わせて次の２サイトのアップデートを行います。
リリースについてコミット漏れがあるなど、同じバージョンで再度リリース作業を行いたい場合があります。
その際、次の手順に従います。
リリースコマンドを実行すると、composer.json の replace の箇所について、各パッケージごとのバージョン番号が、最新バージョン番号で更新されます。
こちらを手動で元のバージョンに戻します。
"replace": {
"baserproject/baser-core": "5.0.2",
"baserproject/bc-admin-third": "5.0.2",
"baserproject/bc-blog": "5.0.2",
"baserproject/bc-column": "5.0.2",
"baserproject/bc-content-link": "5.0.2",
"baserproject/bc-custom-content": "5.0.2",
"baserproject/bc-editor-template": "5.0.2",
"baserproject/bc-favorite": "5.0.2",
"baserproject/bc-front": "5.0.2",
"baserproject/bc-installer": "5.0.2",
"baserproject/bc-mail": "5.0.2",
"baserproject/bc-search-index": "5.0.2",
"baserproject/bc-theme-config": "5.0.2",
"baserproject/bc-theme-file": "5.0.2",
"baserproject/bc-uploader": "5.0.2",
"baserproject/bc-widget-area": "5.0.2"
},
リリースコマンドで作成されたローカルタグを削除します。
git tag -d 5.0.2
リリースコマンドで作成されたリモートタグを削除します。
git push origin :5.0.2
その後、修正コミットなどを追加して、準備ができたら、リリースコマンドを実行します。
vendor/bin/monorepo-builder release 5.0.2