コンテンツにスキップ

Astroサイトのデプロイ

Astroサイトをビルド・デプロイする準備ができましたか? さまざまなデプロイサービスのガイドに従うか、スクロールしてAstroサイトをデプロイする全般的なガイダンスを参照してください。

Astroのサイトは、WebサイトのダッシュボードUIまたはCLIを使用して、多くのホストに短時間でビルド・デプロイできます。

Webサイトをデプロイする手っ取り早い方法は、AstroプロジェクトのオンラインGitリポジトリ(例:GitHub, GitLab, Bitbucket)をホストプロバイダーに接続し、Gitを使用した継続的デプロイを使用することです。

これらのホストプラットフォームは自動的にAstroプロジェクトのソースリポジトリへのプッシュを検出し、サイトをビルドして、カスタムURLまたは個人のドメインでWebにデプロイします。多くの場合、これらのプラットフォームにおけるデプロイの設定は以下のような手順に従います:

  1. リポジトリをオンラインのGitプロバイダー(例:GitHub, GitLab, Bitbucket)に追加してください。

  2. 継続的デプロイをサポートするホスト(例:Netlify または Vercel)を選択し、新しいサイト/プロジェクトとしてGitリポジトリをインポートしてください。

    多くの一般的なホストはプロジェクトをAstroサイトとして認識し、以下のようにビルド・デプロイに適切な構成設定を選択するはずです。(もしそうでない場合は、これらの設定は変更できます。)

  3. 「デプロイ」をクリックすると、新しいWebサイトがそのホストのユニークなURLに作成されます(例: new-astro-site.netlify.app)。

ホストはGitプロバイダーのmainブランチの変更を監視し、新しいコミットがあるたびにサイトを再ビルド・再公開するよう自動的に設定します。これらの設定は通常、ホストプロバイダーのダッシュボードUI上で行うことができます。

いくつかのホストは、npmを使用したあなたのマシンにグローバルにインストールできる独自のコマンドライン・インターフェース(CLI)を備えています。多くの場合、CLIを使用してデプロイする方法は以下のようになります:

  1. ホストのCLIをグローバルにインストールします。例:

    Terminal window
    npm install --global netlify-cli
  2. CLIを実行し、認証、セットアップ等の指示に従います。

  3. サイトをビルドしてホストにデプロイします。

    多くの一般的なホストは、サイトをビルドしデプロイしてくれます。それらは通常、プロジェクトをAstroサイトとして認識し、以下のようにビルド・デプロイのための適切な設定を選択するはずです。(もしそうでない場合は、これらの設定は変更可能です。)

    その他のホストではローカルでサイトをビルドしコマンドラインを使用してデプロイする必要があります。

NetlifyやVercelのような多くのホストはサイトをビルドしてそのビルド出力をWebに公開してくれます。しかし、サイトによっては、ローカルでビルドし、デプロイコマンドを実行するか、ビルド出力をアップロードする必要があります。

また、ローカルでビルドしてサイトをプレビューしたり、潜在的なエラーや警告を自分の環境でキャッチしたりすることもできます。

Astroサイトをビルドするには、npm run buildコマンドを実行してください。

Terminal window
npm run build

デフォルトでは、ビルド出力はdist/に配置されます。この場所はoutDir設定オプションを使って変更できます。