はじめに

公式で公開されている方法を使ってAstroで作成したブログをGitHub Pagesで公開していたのですが、ファイルを更新してもビルドが通らない、という現象に遭遇しました。

これはよくないということで対処してみたのですが、結構格闘する羽目になったので、その時の対処法を記録しておきます。

対処法

結論から言うと、GitHub Actionの設定ファイル、(.github/workflows/deploy.yamlのようなもの)を以下のように変更することで解決することができました。

name: Deploy to GitHub Pages

on:
  push:
    branches: [ master ]
  workflow_dispatch:

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Install, build, and upload your site
        # v1→v2
        uses: withastro/action@v2
  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        # v1→v4
        uses: actions/deploy-pages@v4

これでGitHub Pagesへデプロイできるようになりました。

上記の通り変更は二か所だったのですが、どこを直せばいいのかが調べても中々分からず、GitHub Actionのエラーログとにらめっこしてなんとか原因をつかみました。

withastro/action@v1はどうやらactions/upload-artifact@v2を使っているようです。しかし、最近actions/upload-artifact@v2が廃止され、actions/upload-artifact@v3を用いないといけなくなったそうです。

Error: This request has been automatically failed because it uses a deprecated version of `actions/upload-artifact: v3`. Learn more: https://github.blog/changelog/2024-04-16-deprecation-notice-v3-of-the-artifact-actions/

なので、withastro/action@v2に変更してこれに対応する必要があったわけです。

最初はactions/upload-artifact@v3を明示的に書いてどうにかしようとしたのですが、結局withastro/action@v1が存在しているとactions/upload-artifact@v2を呼び出そうとするようで永遠にエラーが解消されませんでした。

おわりに

Astroは静的なサイトジェネレータとして人気なので、GitHub Pagesで公開する人も多いと思います。しかし、最近の仕様変更で今回のようなエラーが発生する可能性が出て来たようです。

上記のようにGitHub Actionの設定ファイルを変更することで解決できるので、同じようなエラーに遭遇した方は参考にしてみてください。

それではまた。