GitLab Pages でブランチ毎にディレクトリを分けて公開したい

mkdocs で作成したサイトを GitLab Pages で公開していたのですが、これをブランチ毎にディレクトリを分けて公開するようにしました。 <img border="0" src="https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEgUHKAuau-UkOEnXT8FsqU_H9yl9N77-PZVAe-h4R-vpWC4weuM0f5wphmXqeZGraTy7CI625ts8jj1Pst9avzoJD3tOSKLUEkEGyvkQnQ_uR8DtjO0Du7r_2NQNwlob-v_dj4d17JECzY/s320/gitlab.png" width="320" height="320" data-original-width="300" data-original-height="300" hidden/> 基本的には、キャッシュを有効にするだけで可能です。 各ブランチでの成果物も一緒に Pages で公開したいため、キャッシュのキーは固定値にします。 以下、 `.gitlab-ci.yml` の抜粋です。 ```yaml pages: stage: build script: - mkdocs build - rm -rf public/${CI_COMMIT_REF_NAME} - mv site public/${CI_COMMIT_REF_NAME} artifacts: paths: - public cache: # ブランチ毎に別のキャッシュを利用したい場合はブランチ名をキーにするが、 # 今回は全ブランチのビルド結果も一緒に公開したいため、キーは全ブランチで共通の固定値にする key: "common-key" #key: "$CI_COMMIT_REF_NAME" paths: - public ``` `site` ディレクトリが mkdocs の成果物が入っているディレクトリですが、これを `public/ブランチ名` に配置しています。 ## 注意点 デフォルトでは、保護されたブランチと保護されていないブランチではキャッシュが共有されないため、この場合はプロジェクトの設定変更が必要です。 これを知らずに何度試してもキャッシュが共有されずはまっていました・・・。 - https://gitlab-docs.creationline.com/ee/ci/caching/#use-the-same-cache-for-all-branches 変更する設定は以下です。 1. サイドメニューより、`Settings` > `CI/CD` を選択 1. `General pipelines` を開く 1. `Use separate caches for protected branches` のチェックボックスをオフにする 1. `Save changes` をクリックして保存 ## 参考 URL - https://dev.to/zenika/gitlab-pages-preview-the-no-compromise-hack-to-serve-per-branch-pages-5599 - https://gist.github.com/donaldpipowitch/2590b20520b2cf6ae01aab4f7b55f8fa - https://gitlab-docs.creationline.com/ee/ci/caching/#use-the-same-cache-for-all-branches