GitHub Pages
npm run buildを実行し、dist/の内容をgh-pagesブランチにプッシュします。astro.config.mjsのbase設定をリポジトリ名に設定してください。
このページの翻訳は LLM によって生成されています。誤りに気づいた場合は GitHub で issue を開いてお知らせください。
デプロイ
varshaは静的サイトを出力するため、事実上すべてのホスティングプラットフォームにデプロイできます。このガイドでは主要なプラットフォームの手順を説明します。
デプロイ前に
Section titled “デプロイ前に”デプロイ前に以下を確認してください：
astro.config.mjsのsiteURLが実際のドメインに設定されている- ビルドがエラーなしで成功する：
npm run build - プロダクションビルドをローカルで確認：
npm run preview - すべてのドラフト記事が公開準備完了している
npm run buildnpm run previewVercel（推奨）
Section titled “Vercel（推奨）”Vercelは最速のデプロイ体験を提供します。varshaにはVercelアダプターがプリインストールされています。
# Vercel CLIをインストールnpm i -g vercel
# デプロイvercel
# プロダクションにデプロイvercel --prod- コードをGitHub/GitLab/Bitbucketにプッシュ
- vercel.comで「New Project」をクリック
- リポジトリを選択
- フレームワークプリセットとして「Astro」が自動検出される
- 「Deploy」をクリック
Vercelは自動的に：
- プッシュごとにデプロイ
- プレビューURLを生成
- HTTPSを処理
- CDNキャッシュを処理
ビルド設定：
- フレームワーク：Astro
- ビルドコマンド：
npm run build - 出力ディレクトリ：
dist - インストールコマンド：
npm install
Netlify
Section titled “Netlify”# Netlify CLIをインストールnpm i -g netlify-cli
# デプロイnetlify deploy --build --prod- コードをGitHub/GitLab/Bitbucketにプッシュ
- app.netlify.comで「Add new site」をクリック
- リポジトリを選択
- ビルド設定：
- ビルドコマンド：
npm run build - 公開ディレクトリ：
dist
- ビルドコマンド：
- 「Deploy site」をクリック
注意： Netlifyにデプロイする場合、Vercelアダプターを削除してデフォルトの静的アダプターを使用するか、Netlifyアダプターに切り替えてください。
Cloudflare Pages
Section titled “Cloudflare Pages”- コードをGitHub/GitLabにプッシュ
- dash.cloudflare.comで「Pages」に移動
- 「Create a project」→「Connect to Git」をクリック
- リポジトリを選択
- ビルド設定：
- フレームワークプリセット：Astro
- ビルドコマンド：
npm run build - ビルド出力ディレクトリ：
dist
- 「Save and Deploy」をクリック
# Wranglerをインストールnpm i -g wrangler
# ビルドnpm run build
# デプロイnpx wrangler pages deploy dist --project-name=your-siteその他の静的ホスティング
Section titled “その他の静的ホスティング”varshaは静的サイトをdist/ディレクトリに出力するため、任意の静的ホスティングで動作します：
AWS S3 + CloudFront
dist/をS3バケットにアップロードし、CloudFrontディストリビューションを作成します。
Nginx/Apache
dist/の内容をウェブサーバーのドキュメントルートにコピーします。
Firebase Hosting
firebase init hostingを実行し、公開ディレクトリをdistに設定してfirebase deployを実行します。
デプロイ時に環境変数が必要な場合は、ホスティングプラットフォームのダッシュボードで設定してください。Astroはビルド時にimport.meta.envを通じて環境変数を利用できます。
PUBLIC_で始まる変数はクライアントサイドで利用可能です：
const apiKey = import.meta.env.PUBLIC_API_KEY;カスタムドメイン
Section titled “カスタムドメイン”各プラットフォームはカスタムドメイン設定をサポートしています：
- プラットフォームのダッシュボードでカスタムドメインを追加
- DNSレコードをプラットフォームの指示に従って設定
- HTTPS証明書が自動的にプロビジョニングされるのを待つ
astro.config.mjsのsiteを新しいドメインに更新して再デプロイ
トラブルシューティング
Section titled “トラブルシューティング”デプロイの問題に遭遇した場合は、トラブルシューティングガイドを参照してください。