チュートリアル
Astro 5から7へ上げたら、Tailwindの1行でビルドが落ちた
Zenn トレンド · 執筆:devtoolkits.app ·
要点
- 開発者向けオンラインツール集(全506ページを静的生成)をAstro 5.16から7.4.12へ上げた際、ビルドが失敗した
- ビルド失敗の原因は4つで、Markdownプラグインの渡し方、旧コンテンツコレクション、.astroの余分な---、Tailwindが生成した不正なセレクターだった
- Astro 7はNode 22.23.4以上が必要である
なぜ重要か
途中のAstro 6による破壊的変更も含めて2メジャー分をまとめて受けるため、移行時は原因を切り分けて対処する必要がある。Node.jsのバージョン要件も見直しが必要になる。
影響を受ける人
- Astro 5から7へ移行するチーム
- Cloudflare PagesでAstroサイトをビルドする開発者
取るべき対応
- Astro 7を使う場合はNode 22.23.4以上を用意する
- Cloudflare Pagesでは.node-versionを配置してNode.jsのバージョンを指定する
- Astro 5.16
- Astro 6
- Astro 7.4.12
- Node.js 22.23.4
- #Astro
- #Tailwind CSS
- #アップグレード
- #ビルドエラー
- #Cloudflare Pages
はじめに 開発者向けのオンラインツール集(Astro製・全506ページを静的生成)を、Astro 5.16 から 7.4.12 に上げました。途中に Astro 6 があるので、実際には2つ分の破壊的変更をまとめて受けています。 先に結論です。 Astro 7 は Node 22.23.4 以上が必要。Cloudflare Pages では .node-version を置く ビルドが落ちた原因は4つ。Markdown プラグインの渡し方・旧コンテンツコレクション・.astro の余分な ---・Tailwind が作った不正なセレクター…