ラベルリファレンス

ラベル説明デフォルト
roji.hostカスタムホスト名{service}.dev.localhost
roji.portターゲットポート最初のEXPOSEポート
roji.pathパスプレフィックスなし
roji.mock.{METHOD}.{PATH}モックレスポンスボディなし
roji.mock.status.{METHOD}.{PATH}モックレスポンスステータスコード200
roji.auth.basic.userBASIC認証ユーザー名なし
roji.auth.basic.passBASIC認証パスワードなし
roji.auth.basic.realmBASIC認証レルムRestricted
roji.self予約済み: コンテナをルーティングから除外(内部使用)なし

roji.host

デフォルトのホスト名({service}.dev.localhost)を上書き:

labels:
  - "roji.host=myapp.dev.localhost"

任意のホスト名を使用できます。ドットを含まない場合は設定済みドメインで展開されます。

roji.port

コンテナが複数ポートを公開している場合、プロキシ先のポートを指定:

expose:
  - "3000"
  - "9229"   # デバッガー
labels:
  - "roji.port=3000"

未設定の場合、最初の公開ポートが使用されます。

roji.path

パスプレフィックスに一致するリクエストをこのサービスにルーティング:

labels:
  - "roji.host=myapp.dev.localhost"
  - "roji.path=/api"

https://myapp.dev.localhost/api/* へのリクエストがこのサービスにルーティングされます。

roji.mock.*

実際のバックエンドなしでモックレスポンスを定義:

labels:
  - "roji.host=api.dev.localhost"
  - 'roji.mock.GET./api/users=[{"id":1,"name":"Alice"}]'
  - 'roji.mock.GET./api/health={"status":"ok"}'
  - "roji.mock.status.POST./api/users=201"

詳細は モックルートガイドを参照。

roji.auth.basic.*

HTTP BASIC認証でルートを保護:

labels:
  - "roji.auth.basic.user=admin"
  - "roji.auth.basic.pass=secret"
  - "roji.auth.basic.realm=Admin Area"   # 任意

詳細は BASIC認証ガイドを参照。

roji.self

予約済みの内部ラベル。コンテナをルーティングから除外するためにマークします。Docker モードでroji自身が使用します。独自のコンテナには設定しないでください。