第12章 EgressRouter [network.operator.openshift.io/v1]
- Description
- EgressRouter は、Pod と外部システム間のブリッジとして機能するスロールーターをユーザーが定義できるようにする機能です。スロールーターは、Pod または Pod のグループから発信された出力トラフィックを、設定に従ってリモートの外部システムまたは複数の宛先にリダイレクトするサービスを実行します。これは、cluster-network-operator によって消費されます。より具体的には、<name> を持つ EgressRouter CR が与えられると、CNO は以下を作成および管理します。-<name> と呼ばれるサービス -<name> と呼ばれる出力 Pod-<name> と呼ばれる NAD 互換性レベル 1: メジャーリリース内で安定最低 12 か月または 3 つのマイナーリリース (どちらか長い方)。EgressRouter は、単一の egressrouterPod 設定オブジェクトです。
- タイプ
-
object
- 必須
-
spec
-
12.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| 目的のスロールーターの仕様。 |
|
| EgressRouter の監視ステータス。 |
12.1.1. .spec
- Description
- 目的のスロールーターの仕様。
- タイプ
-
object
- 必須
-
addresses
-
mode
-
networkInterface
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| Pod のセカンダリーインターフェイスで設定する IP アドレスのリスト。 |
|
| EgressRouterAddress には、ルーターのインターフェイスで設定する IPCIDR とゲートウェイのペアが含まれています |
|
| モードは、スロールーターに使用されるモードを示します。デフォルトのモードはリダイレクトであり、現在サポートされている唯一のモードです。 |
|
| 作成/使用するインターフェイスの仕様。デフォルトは macvlan です。現在、macvlan のみがサポートされています。 |
|
| リダイレクトは、リダイレクトモードに固有の設定パラメーターを表します。 |
12.1.2. .spec.addresses
- Description
- Pod のセカンダリーインターフェイスで設定する IP アドレスのリスト。
- タイプ
-
array
12.1.3. .spec.addresses[]
- Description
- EgressRouterAddress には、ルーターのインターフェイスで設定する IPCIDR とゲートウェイのペアが含まれています
- タイプ
-
object
- 必須
-
ip
-
プロパティー | タイプ | Description |
---|---|---|
|
| ネクストホップゲートウェイの IP アドレス (自動的に決定できない場合)。IPv4 または IPv6 にすることができます。 |
|
| IP は、ルーターのインターフェイスで設定するアドレスです。IPv4 または IPv6 にすることができます。 |
12.1.4. .spec.networkInterface
- Description
- 作成/使用するインターフェイスの仕様。デフォルトは macvlan です。現在、macvlan のみがサポートされています。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| interfaceTypemacvlan に固有の引数 |
12.1.5. .spec.networkInterface.macvlan
- Description
- interfaceTypemacvlan に固有の引数
- タイプ
-
object
- 必須
-
mode
-
プロパティー | タイプ | Description |
---|---|---|
|
| マスターインターフェイスの名前。IP アドレスから推測できる場合は指定する必要はありません。 |
|
| モードは、macvlan インターフェイスに使用されるモードを示します。Bridge | Private | VEPA|Passthru の 1 つ。デフォルトのモードはブリッジです。 |
12.1.6. .spec.redirect
- Description
- リダイレクトは、リダイレクトモードに固有の設定パラメーターを表します。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| FallbackIP は、リモート宛先の IP アドレスを指定します。IPv4 または IPv6 にすることができます。リダイレクトルールが指定されていない場合、ルーターからのすべてのトラフィックはこの IP にリダイレクトされます。リダイレクトルールが指定されている場合、ルーター上の他のポート (ルールで定義されていない) の接続はすべてこの IP にリダイレクトされます。リダイレクトルールが指定されていて、フォールバック IP が提供されていない場合、他のポートでの接続は単に拒否されます。 |
|
| リダイレクトモードで Pod から宛先への DNAT リダイレクトを定義する L4RedirectRules のリスト。 |
|
| L4RedirectRule は、特定のポートから宛先 IP およびポートへの DNAT リダイレクトを定義します。 |
12.1.7. .spec.redirect.redirectRules
- Description
- リダイレクトモードで Pod から宛先への DNAT リダイレクトを定義する L4RedirectRules のリスト。
- タイプ
-
array
12.1.8. .spec.redirect.redirectRules[]
- Description
- L4RedirectRule は、特定のポートから宛先 IP およびポートへの DNAT リダイレクトを定義します。
- タイプ
-
object
- 必須
-
destinationIP
-
port
-
protocol
-
プロパティー | タイプ | Description |
---|---|---|
|
| IP は、リモート宛先の IP アドレスを指定します。IPv4 または IPv6 にすることができます。 |
|
| ポートは、クライアントがリダイレクトされるトラフィックを送信する必要があるポート番号です。 |
|
| プロトコルは、TCP、SCTP、または UDP にすることができます。 |
|
| TargetPort を使用すると、トラフィックのリダイレクト先となるリモート宛先のポート番号を指定できます。指定しない場合は、ポートの値が使用されます。 |
12.1.9. .status
- Description
- EgressRouter の監視ステータス。
- タイプ
-
object
- 必須
-
conditions
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| スロールーターの監視ステータス |
|
| EgressRouterStatusCondition は、スロールーターの管理および監視対象コンポーネントの状態を表します。 |
12.1.10. .status.conditions
- Description
- スロールーターの監視ステータス
- タイプ
-
array
12.1.11. .status.conditions[]
- Description
- EgressRouterStatusCondition は、スロールーターの管理および監視対象コンポーネントの状態を表します。
- タイプ
-
object
- 必須
-
status
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
| `` | LastTransitionTime は、現在のステータスプロパティーが最後に更新された時刻です。 |
|
| メッセージは、現在の状態に関する追加情報を提供します。これは人間によってのみ消費されます。改行文字 (U + 000A) が含まれている場合があり、改行としてレンダリングする必要があります。 |
|
| 理由は、状態の現在のステータスのキャメルケースの理由です。 |
|
| 状態のステータス、True、False、Unknown のいずれか。 |
|
| タイプは、この条件によって報告されるアスペクトを指定します。利用可能、進行中、劣化の 1 つ |