Dockerラベル

ラベルリファレンス#

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/* へのリクエストがこのサービスにルーティングされます。

プレフィックスはパスのセグメント境界でのみ一致します。/api は /api と /api/users を捕まえますが、/apifoo や /api-docs は捕まえず、プレフィックス なしでそのホスト名を処理するルートへ流れます。

roji.path=/ はラベルを書かないのと同じ意味になります。プレフィックスではなく ホスト名全体をそのサービスが受け持ちます。

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.tunnel#

Cloudflare Tunnel を通してこのルートを外部から到達可能にする：

labels:
  - "roji.tunnel=true"

true / 1 / yes / on が肯定として扱われ、それ以外はすべて非公開に なる。設定ファイルに tunnel: ブロックが無ければ、ラベルを付けても何も 公開されない。

詳細は 外部公開（トンネル）ガイドを参照。

roji.self#

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