Astroのビルドエラーの解決方法

照屋塁公開 2023.06.10

Astroを使ってサイトを構築している方で、Cloud BuildなどCI環境でビルドした際に「The collection ‘xxx’ does not exist or is empty」とい […]

この問題は、ローカルでは正常に動作するのに、Cloud Buildのような外部のCI環境でのビルド時にだけ失敗するため、原因は分かりにくいものです。

ここでは、実際に起きた例を元に、問題の原因と解決方法を解説します。

問題

Cloud Build 上で、Astroの Content Collection (例: column, news)が「存在しない」または「空である」としてビルド時にエラーが発生する。

原因

Astro は Content Collection を読み込んだ上で型を自動生成します。しかし CI 環境では、この型生成コマンド (astro sync)が実行されていないことが原因となり、ビルド時に collection を読み込めずエラーになります。

解決方法

Cloud Build の YAML に astro sync を明示的に追加するだけで解決します！

例: cloudbuild.yaml

steps:
  - name: "node"
    entrypoint: "npm"
    args: ["install"]

  - name: "node"
    entrypoint: "npx"
    args: ["astro", "sync"]  # これを追加

  - name: "node"
    entrypoint: "npm"
    args: ["run", "build"]

  - name: "gcr.io/cloud-builders/gsutil"
    args: ["-m", "rsync", "-d", "-r", "dist", "gs://your-bucket"]