Astroサイトのデプロイ
Astroサイトをビルド・デプロイする準備ができましたか? さまざまなデプロイサービスのガイドに従うか、スクロールしてAstroサイトをデプロイする全般的なガイダンスを参照してください。
デプロイガイド
セクションタイトル: デプロイガイドクイックデプロイ・オプション
セクションタイトル: クイックデプロイ・オプションAstroのサイトは、WebサイトのダッシュボードUIまたはCLIを使用して、多くのホストに短時間でビルド・デプロイできます。
WebサイトUI
セクションタイトル: WebサイトUIWebサイトをデプロイする手っ取り早い方法は、AstroプロジェクトのオンラインGitリポジトリ(例:GitHub, GitLab, Bitbucket)をホストプロバイダーに接続し、Gitを使用した継続的デプロイを使用することです。
これらのホストプラットフォームは自動的にAstroプロジェクトのソースリポジトリへのプッシュを検出し、サイトをビルドして、カスタムURLまたは個人のドメインでWebにデプロイします。多くの場合、これらのプラットフォームにおけるデプロイの設定は以下のような手順に従います:
-
リポジトリをオンラインのGitプロバイダー(例:GitHub, GitLab, Bitbucket)に追加してください。
-
継続的デプロイをサポートするホスト(例:Netlify または Vercel)を選択し、新しいサイト/プロジェクトとしてGitリポジトリをインポートしてください。
多くの一般的なホストはプロジェクトをAstroサイトとして認識し、以下のようにビルド・デプロイに適切な構成設定を選択するはずです。(もしそうでない場合は、これらの設定は変更できます。)
- ビルドコマンド:
astro build
またはnpm run build
- 公開ディレクトリ:
dist
- ビルドコマンド:
-
「デプロイ」をクリックすると、新しいWebサイトがそのホストのユニークなURLに作成されます(例:
new-astro-site.netlify.app
)。
ホストはGitプロバイダーのmainブランチの変更を監視し、新しいコミットがあるたびにサイトを再ビルド・再公開するよう自動的に設定します。これらの設定は通常、ホストプロバイダーのダッシュボードUI上で行うことができます。
CLIを使用したデプロイ
セクションタイトル: CLIを使用したデプロイいくつかのホストは、npmを使用したあなたのマシンにグローバルにインストールできる独自のコマンドライン・インターフェース(CLI)を備えています。多くの場合、CLIを使用してデプロイする方法は以下のようになります:
-
ホストのCLIをグローバルにインストールします。例:
-
CLIを実行し、認証、セットアップ等の指示に従います。
-
サイトをビルドしてホストにデプロイします。
多くの一般的なホストは、サイトをビルドしデプロイしてくれます。それらは通常、プロジェクトをAstroサイトとして認識し、以下のようにビルド・デプロイのための適切な設定を選択するはずです。(もしそうでない場合は、これらの設定は変更可能です。)
- ビルドコマンド:
astro build
ornpm run build
- 公開ディレクトリ:
dist
その他のホストではローカルでサイトをビルドしコマンドラインを使用してデプロイする必要があります。
- ビルドコマンド:
ローカルでサイトをビルドする
セクションタイトル: ローカルでサイトをビルドするNetlifyやVercelのような多くのホストはサイトをビルドしてそのビルド出力をWebに公開してくれます。しかし、サイトによっては、ローカルでビルドし、デプロイコマンドを実行するか、ビルド出力をアップロードする必要があります。
また、ローカルでビルドしてサイトをプレビューしたり、潜在的なエラーや警告を自分の環境でキャッチしたりすることもできます。
Astroサイトをビルドするには、npm run build
コマンドを実行してください。
デフォルトでは、ビルド出力はdist/
に配置されます。この場所はoutDir
設定オプションを使って変更できます。
SSR用アダプターを追加する
セクションタイトル: SSR用アダプターを追加するSSR(サーバーサイド・レンダリング) (EN)を有効化してAstroサイトをデプロイする前に、確認してください:
- 適切なアダプター (EN)がプロジェクトの依存関係にインストールされていること(手動、またはアダプターの
astro add
コマンドを使用します。例:npx astro add netlify
) - 手動インストール時に
astro.config.mjs
ファイルのimportとdefault exportにアダプターを追加していること(このステップはastro add
コマンドが代行します!)