第1章 ルート

前提条件

• OpenShift CLI (oc) がインストールされている。
• 管理者としてログインしている。
• あるポートを公開する Web アプリケーションと、そのポートでトラフィックをリッスンする TCP エンドポイントがあります。

検証

• 作成した route リソースを確認するには、次のコマンドを実行します。

  $ oc get routes -o yaml hello-openshift

  作成したセキュアでないルートの YAML 定義例

  apiVersion: route.openshift.io/v1
  kind: Route
  metadata:
    name: hello-openshift
  spec:
    host: www.example.com
    port:
      targetPort: 8080
    to:
      kind: Service
      name: hello-openshift

  ここでは、以下のようになります。

  host

  サービスを指すエイリアス DNS レコードを指定します。このフィールドには、www.example.com などの有効な DNS 名を指定できます。DNS 名は DNS952 サブドメイン規則に従う必要があります。指定しない場合は、ルート名が自動的に生成されます。

  targetPort

  このルートが指すサービスによって選択される Pod のターゲットポートを指定します。

  注記

  デフォルトの Ingress ドメインを表示するには、以下のコマンドを実行します。

  $ oc get ingresses.config/cluster -o jsonpath={.spec.domain}

• spec.host: パスベースのルートのパス属性を指定します。

• アノテーションが存在しません (デフォルト):Operator は、Ingress リソースから Route リソースにラベルを同期しません。ルート 上に既存の標識はすべて保存されます。
• アノテーションが有効になっています (route.openshift.io/reconcile-labels: "true"): Operator がラベルの伝播を有効にします。次のリコンシリエーション (Ingress の 作成または更新イベントによってトリガーされる) で、Operator は生成された Route リソース上のすべてのラベルを Ingress リソースのラベルに置き換えます。
• アノテーションが無効になっています (削除されたか、値が true 以外に設定されています):Operator はラベルの伝播を無効にします。Route リソースに現在存在するラベルはそのまま保持されますが、Operator はそれらを Ingress リソースと同期しなくなります。
• アノテーションが再び有効になりました:Operator は伝播を再開します。これにより、Route リソース上のすべてのラベルが、Ingress リソースの現在のラベルに再度置き換えられます。

前提条件

• Red Hat OpenShift Service on AWS クラスターにアクセスできます。
• あなたは cluster-admin ロール、またはプロジェクト内で Ingress リソースを作成および編集するための権限を持っています。