デプロイ — $mol

デプロイ

ビルドした $mol アプリは静的ファイルの入ったフォルダです。動かすサーバーもなく、生かし続ける Node プロセスもなく、選ぶアダプタもありません。フォルダを配れる場所なら、どこでもアプリが動きます。

配るのは何か

ビルドはすべてをモジュール内の -/ フォルダに書き出します。1my/hello/-/2├── index.html 配置先のパスに合わせて書き換え済み3├── web.js アプリ全体、ファイル一つ4├── web.css5├── web.locale=en.json 言語ごとに一つ6├── manifest.json7└── … `deploy` ディレクティブが持ち込んだものこのフォルダがサイトそのものです。どんな静的ホスティングから配ってもアプリは動きます。my/hello/ の残りはソースで、-/ は生成物です。ワークスペースの .gitignore が -* を無視するので、ビルド結果がプロジェクト自身の履歴に入ることはありません。ウェブへはデプロイ用ブランチから出ていきます。

短い版

ワークフローはスキャフォルダが書くので、新しいプロジェクトは push だけで公開されます。1npx create-view-tree-lsp my/hello2git push.github/workflows/deploy.yml がモジュールをビルドし、my/hello/-/ を gh-pages ブランチへ push します。Settings → Pages → Source が Deploy from a branch で gh-pages になっていれば、GitHub がそのブランチを配信します。そのブランチがあるリポジトリの既定値がまさにこれです。URL が 404 を返すなら、まず確認するのはこの設定です。以後サイトは https://<user>.github.io/<repo>/ に住みます。

ワークフローが実際にしていること

支えているのは二つのアクションで、どちらも入力は数個です。1- uses: hyoo-ru/mam_build@master22 with:3 package: "my/hello" # ビルドするフォルダ、ワークスペースからの相対パス4 modules: "app" # その中のどのモジュールか5 6- uses: hyoo-ru/gh-deploy@v4.4.17 if: github.ref == 'refs/heads/main'8 with:9 folder: "my/hello/app/-"mam_build はあなたのパッケージの周りに MAM ワークスペースを広げ、コード中の $name トークンをそれを収めたリポジトリへ解決し、ビルドします。ロックファイルも npm install の手順も要りません。依存関係の一覧は .meta.tree のレジストリそのもので、

プロジェクト構成で説明したとおりです。gh-deploy はビルドしたフォルダを gh-pages にコミットします。target-folder を渡すとルートではなくサブフォルダに置かれ、これがブランチのプレビューになります。1- name: Deploy feature branch2 if: startsWith(github.ref, 'refs/heads/feature/')3 uses: hyoo-ru/gh-deploy@v4.4.14 with:5 folder: "my/hello/app/-"6 target-folder: ${{ github.ref_name }}feature/* の各ブランチが同じ Pages サイト上に自分の URL を持ち、delete トリガーがブランチの消滅に合わせてフォルダを片付けます。

デプロイに要る一つのファイル

GitHub でこのページを編集役に立ちましたか？はいいいえ前へテスト次へトラブルシューティングこのページの内容配るのは何か短い版ワークフローが実際にしていることデプロイに要る一つのファイルサイトのルートに置くべきファイル静的ホスティングでの深いリンク push の前に確かめる GitHub Pages の外でも