railway-deploy

Railway Deploy

railway up を使用して、現在のディレクトリのコードを Railway にデプロイします。

使用するタイミング

• ユーザーが「deploy」「ship」「push code」と依頼したとき
• ユーザーが「railway up」または「deploy to Railway」と言ったとき
• ユーザーがローカルのコード変更をデプロイしたいとき
• ユーザーが「deploy and fix any issues」と言ったとき（--ci モードを使用）

モード

デタッチモード（デフォルト）

デプロイを開始し、すぐに戻ります。ほとんどのデプロイで使用します。

railway up --detach

CI モード

ビルドが完了するまでビルドログをストリーミング表示します。ユーザーがビルドを監視したい場合や、問題をデバッグする必要がある場合に使用します。

railway up --ci

CI モードを使用するタイミング:

• ユーザーが「deploy and watch」「deploy and fix issues」と言ったとき
• ユーザーがビルドの失敗をデバッグしているとき
• ユーザーがビルドの出力を確認したいとき

特定のサービスへのデプロイ

デフォルトはリンク済みのサービスです。別のサービスにデプロイするには、次のようにします。

railway up --detach --service backend

リンクされていないプロジェクトへのデプロイ

事前にリンクせず、プロジェクトにデプロイします。

railway up --project <project-id> --environment production --detach

--project と --environment の両方のフラグが必要です。

CLI オプション

フラグ	説明
-d, --detach	ログにアタッチしない（デフォルト）
-c, --ci	ビルドログをストリーミング表示し、完了したら終了
-s, --service <NAME>	対象のサービス（デフォルトはリンク済み）
-e, --environment <NAME>	対象の環境（デフォルトはリンク済み）
-p, --project <ID>	対象のプロジェクト（--environment が必要）
[PATH]	デプロイするパス（デフォルトは現在のディレクトリ）

ディレクトリのリンク

Railway CLI はディレクトリツリーを上方向にたどって、リンク済みのプロジェクトを探します。リンク済みプロジェクトのサブディレクトリにいる場合は、再度リンクする必要はありません。

サブディレクトリからデプロイする場合は、railway-environment スキルで rootDirectory を設定してから、通常どおり railway up でデプロイすることをおすすめします。

デプロイ後

デタッチモード

Deploying to <service>...

railway-deployment スキルを使用してビルドのステータスを確認します（--lines フラグを使用）。

CI モード

ビルドログはインラインでストリーミング表示されます。ビルドが失敗した場合、エラーは出力内に表示されています。

CI モードの後に railway logs --build を実行しないでください。 ログはすでにストリーミング表示されています。さらに詳しい情報が必要な場合は、railway-deployment スキルを --lines フラグ付きで使用してください（ストリーミングは行わないでください）。

関連スキル

• デプロイ後のステータス確認: railway-service スキルを使用
• ログの表示: railway-deployment スキルを使用
• 設定の問題の修正: railway-environment スキルを使用
• 設定修正後の再デプロイ: railway-environment スキルを使用

エラーハンドリング

プロジェクトがリンクされていない

No Railway project linked. Run `railway link` first.

サービスがリンクされていない

No service linked. Use --service flag or run `railway service` to select one.

ビルドの失敗（CI モード）

ビルドログはすでにストリーミング表示されているため、railway up --ci の出力から直接分析してください。 CI モードの後に railway logs を実行しないでください（--lines なしではストリーミングが永続的に続きます）。

よくある問題:

• 依存関係の不足 → package.json / requirements.txt を確認
• ビルドコマンドの誤り → railway-environment スキルを使用して修正
• Dockerfile の問題 → dockerfile のパスを確認