ZeaburでGitHubリポジトリをデプロイする方法
このガイドは、GitHub上にあるプロジェクトを取得し、ユーザーと共有できる実際のライブウェブサイトまたはAPIに変換する最も簡単な方法です。
概要
GitHubはコードが存在する場所ですが、オンラインに公開するには「ホスティング」が必要です。技術的な重い作業を処理してくれるため、Zeaburを推奨します。リポジトリを分析し、ビルドし、実行し、わずか数クリックで共有可能なURLを提供します。
ワークフロー:
- 準備: リポジトリがローカルで実行され、適切な設定（ポート、環境変数）があることを確認します。
- デプロイ: Zeaburにデプロイします（Cursor / VS CodeのZeabur拡張機能を使用するのが最速です）。
- 公開: ドメインを生成し、（オプションで）データベースやその他のサービスを追加します。
📝 重要な注記: アプリがシークレット（APIキー、データベースURLなど）を使用する場合、それらをGitHubにコミットしないでください。開発用にローカルの
.envファイルに配置し、デプロイ後にZeaburの変数として追加してください。
前提条件
- GitHubアカウント（デプロイしたいリポジトリへのアクセス権限）。
- コンピュータにCursorまたはVS Codeがインストールされている。
- Zeaburアカウント。
- ローカルにNode.jsがインストールされている（バージョン18+推奨）またはプロジェクトに必要なランタイム（Python/Goなど）。
移行の概要
この計画は、最小限の設定で「リポジトリ内のコード」から「デプロイされたサービス」に移動します。
- ソース: GitHubリポジトリ
- エディター: Cursor / VS Code
- ホスト: Zeabur
ステップ1: 新しいプロジェクトを作成
Zeaburのメインダッシュボードから:
- 右上隅の紫色のNew Projectボタンをクリックします。
- プロンプトが表示された場合は、希望するリージョン（設定で確認できるAWS Taipeiなど）を選択するか、デフォルトで標準リージョンが使用されます。
ステップ2: デプロイソースを選択
プロジェクト環境が作成されると、「何をデプロイしますか？」というモーダルが表示されます。
- GitHub（GitHubリポジトリからデプロイ）をクリックします。
- 注記: コードは既にGitHubにプッシュされているため、これが正しいパスです。
ステップ3: 接続してリポジトリを選択
- 検索: 検索バーに、作成したリポジトリの名前（例:
cnynewyrdishesまたはリポジトリに付けた名前）を入力します。 - 選択: リストから特定のリポジトリをクリックします。
- ヒント: リポジトリがリストに表示されない場合は、Configure GitHubボタンをクリックして、ZeaburがGitHubアカウント内のその特定のリポジトリにアクセスする権限を持っていることを確認してください。
ステップ4: ビルド設定を確認
Zeaburは自動的にコードを分析して、言語とフレームワークを決定します（例: スクリーンショットでは、Node.jsとViteを検出しました）。
- ビルドプランのプレビューを確認します。
- インストールコマンド（例:
yarn install）とビルドコマンド（例:yarn build）がプロジェクトに適していることを確認します。 - 右下の紫色のDeployボタンをクリックします。
ステップ5: デプロイを待つ
Zeaburはコードをプルし、依存関係をインストールし、プロジェクトをビルドします。
- ステータスが「Building」からRunningに変わります。
- インジケーターライトが緑色になると（最後のスクリーンショットで確認できる）、サービスがアクティブになります。
ステップ6: ウェブサイトを公開（ドメインを追加）
現在、アプリは実行中ですが、まだ一般にアクセスできません。URLを生成する必要があります。
- サービス概要ページ（最後のスクリーンショット）で、Add Domainボタンまたはタブを探します。
- Add Domainをクリックします。
- 次のいずれかを選択できます:
- zeabur.appドメインを生成: これにより無料のURL（例:
cnynewyrdishes.zeabur.app）が提供されます。 - カスタムドメイン: 所有している場合は、独自のドメインを接続します。
- zeabur.appドメインを生成: これにより無料のURL（例:
- 追加したら、リンクをクリックしてライブサイトにアクセスしてください！