日本
The Morning Dev

知っておくべきことだけを、毎朝

‹
 

チュートリアル

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サイトをビルドする開発者

取るべき対応

  1. Astro 7を使う場合はNode 22.23.4以上を用意する
  2. 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 が作った不正なセレクター…

この記事をどう思いますか?

コメント0件