railway-domain

Railway ドメイン管理

Railway サービスのドメインを追加、表示、削除します。

使用するタイミング

• ユーザーが「ドメインを追加」「ドメインを生成」「URL を取得」と依頼したとき
• ユーザーがカスタムドメインを追加したいとき
• ユーザーが「自分のサービスの URL は何ですか」と尋ねたとき
• ユーザーがドメインを削除したいとき

Railway ドメインの追加

Railway が提供するドメインを生成します（サービスごとに最大 1 つ）:

railway domain --json

特定のサービスの場合:

railway domain --json --service backend

レスポンス

生成されたドメイン URL を返します。サービスにデプロイが存在している必要があります。

カスタムドメインの追加

railway domain example.com --json

レスポンス

必要な DNS レコードを返します:

{
  "domain": "example.com",
  "dnsRecords": [
    { "type": "CNAME", "host": "@", "value": "..." }
  ]
}

これらのレコードを DNS プロバイダーに追加するようユーザーに伝えてください。

現在のドメインの読み取り

railway-environment スキルを使用して設定済みのドメインを確認するか、直接クエリします:

query domains($envId: String!) {
  environment(id: $envId) {
    config(decryptVariables: false)
  }
}

ドメインは config.services.<serviceId>.networking にあります:

• serviceDomains - Railway が提供するドメイン
• customDomains - ユーザーが提供するカスタムドメイン

ドメインの削除

railway-environment スキルを使用してドメインを削除します:

カスタムドメインの削除

{
  "services": {
    "<serviceId>": {
      "networking": {
        "customDomains": { "<domainId>": null }
      }
    }
  }
}

Railway ドメインの削除

{
  "services": {
    "<serviceId>": {
      "networking": {
        "serviceDomains": { "<domainId>": null }
      }
    }
  }
}

その後、railway-environment スキルを使用して変更を適用し、コミットします。

CLI オプション

フラグ	説明
[DOMAIN]	追加するカスタムドメイン（Railway ドメインの場合は省略）
-p, --port <PORT>	接続するポート
-s, --service <NAME>	対象のサービス（リンク済みのものがデフォルト）
--json	JSON 形式で出力

組み合わせ利用

• ドメインの読み取り: railway-environment スキルを使用
• ドメインの削除: railway-environment スキルを使用
• 削除の適用: railway-environment スキルを使用
• サービスの確認: railway-service スキルを使用

エラー処理

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

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

ドメインが既に存在する場合

Service already has a railway-provided domain. Maximum 1 per service.

デプロイがない場合

Service has no deployment. Deploy first with `railway up`.

無効なドメインの場合

Invalid domain format. Use a valid domain like "example.com" or "api.example.com".