Release

CHIRIMEN for Raspberry Pi 3 (GreenCHIRIMEN) リリース手順

基本的に下記 1,2 のフローを回します。

1. ソースを直す
2. テストする (ソース直したら必ず実際のデバイス使い実施)

• exampleを修正する場合: 対象のデバイスを使ったコードを必ずテスト。
• polyfill / Bridge Serverを修正する場合: example 全て実デバイスでテスト

3. テストリリース (コミュニティ内向け)

• ある程度テストして公開したいタイミングで最小限のテストをしてコミュニティ向けにリリースする
  • example を修正した場合: jsbin の example も新しくして、中継システムのリンクの切替が必要(中継システムはこのリポジトリの外側にあるのでリポジトリ自身のの内容の変更は不要。ただし新しいexamplesを追加した場合は、中継システムにそのexample用の設定を追加したうえでこのリポジトリのexamplesのインデックスページ及びBookmarkへ中継システムへのリンクの追加が必要)
  • polyfill / bridge server を修正した場合: jsbin の全 example を新しくして、同様に中継システムのリンクの切替が必要(明らかに後方互換のある修正であれば既存の example から読み込む polyfill URL をアップデートするだけでも良い)
• github でテストリリース用タグを付けてリリース QA テストの issue をたてる
  • Release-Checklist に記載のチェックリストをコピペして実施したテストにチェックを入れる Release-Checklist
• 必要に応じてビルドイメージにして公開する
  • 要詳細追記

4. 正式リリース (外部向けリリース)

• ビルドイメージをユーザ向けに公開する前に、必ずフルテストを行う
• テストリリースしたビルドをそのままリリースしたい場合
  • 既存 issue のチェックリストの残りを全てテストしてリリースする
• 新規にビルドイメージを作ってリリースする場合
  • github でテストリリース用のタグを付けてリリース QA テストの issue をたてる
  • Release-Checklist に記載のチェックリストをコピペして全てのテストを実施する
• 全テストに通ったら github のタグに正式リリース用のタグを追加する
• ビルドイメージを公開してアナウンス

1. ソース直す

これは、直す。それだけ。 ただし、jsbinのコードを直した場合には、下記を実施してください。

1. jsbin修正して保存するとURLが変わる
2. 該当する中継システムのリンクを同URLに切り替える

2. テストする

テストは、オンライン、オフライン両方のexampleでテストします。 不具合があったら 1. に戻ってやりなおし。

https://github.com/chirimen-oh/chirimen-raspi3/issues/24 を参考にするとテストが容易です。WebDINOにテスト用ハードが準備されています。このハードを用いた半自動テストセットが、gc/testSet/testAll.htmlです。　ttps://localhost/testSet/testAll.html　で使います。

3. リリース作業

env/ をカレントに変更して、release.sh を実行すると、release フォルダに最新のリリースファイルができます。

テスト

まず、deployする前にテストを実施します。

• imageファイルを作成 して、そのimageファイルを別のSDに焼き込んでからexamples 全試験

テストが終わってから実際のdeploy作業を行います。

deploy

release/cdn/ フォルダ

これは、ホスティングURLへコピーするファイルです。 10/17版までは、https://mz4u.net/libs/gc2/ にコピーしていました。

release/env/ フォルダ

_gc.zip と gc.zip ができます。 こちらも wget で取得可能なURL (setup-ja.md に記載のURL)にコピーします。 10/17版までは、https://mz4u.net/libs/gc2/env/ にコピーしていました。

gitへadd -> commit

全て終わったら githubへ反映・周知します。

SDイメージ作成

• ここを参照

おつかれさまでした。