4.2. Istio アンビエントモードのインストール
必要な Gateway API カスタムリソース定義 (CRD) を使用して、OpenShift Container Platform 4.19 以降および Red Hat OpenShift Service Mesh 3.1.0 以降に Istio アンビエントモードをインストールできます。
前提条件
- クラスターを OpenShift Container Platform 4.19 以降にデプロイしている。
- OpenShift Container Platform クラスターに OpenShift Service Mesh Operator 3.1.0 以降がインストールされている。
-
インストール方法に応じて、
cluster-adminロールを持つユーザーとして Web コンソールを使用するか、またはoc loginコマンドを使用して OpenShift Container Platform クラスターにログインしている。 -
Cluster Network Operator の
gatewayConfig仕様でroutingViaHostフィールドをtrueに設定して、OVN-Kubernetes Container Network Interface (CNI) がローカルゲートウェイモードを使用するように設定した。詳細は、「ゲートウェイモードの設定」を参照してください。
手順
Istio コントロールプレーンをインストールします。
次のコマンドを実行して、
istio-systemnamespace を作成します。oc create namespace istio-system
$ oc create namespace istio-systemCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次の例のように、
istio.yamlという名前のIstioリソースを作成します。設定例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 重要profileフィールドをambientに設定し、.spec.values.pilot.trustedZtunnelNamespace値を、ZTunnelリソースがインストールされる namespace と一致するように設定する必要があります。次のコマンドを実行して、
Istioカスタムリソース (CR) を適用します。oc apply -f istio.yaml
$ oc apply -f istio.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、Istio コントロールプレーンに
Readyステータス条件が含まれるまで待ちます。oc wait --for=condition=Ready istios/default --timeout=3m
$ oc wait --for=condition=Ready istios/default --timeout=3mCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Istio Container Network Interface (CNI) をインストールします。
次のコマンドを実行して、
istio-cninamespace を作成します。oc create namespace istio-cni
$ oc create namespace istio-cniCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次の例のように、
istio-cni.yamlという名前のIstioCNIリソースを作成します。設定例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow profileフィールドをambientに設定します。次のコマンドを実行して、
IstioCNICR を適用します。oc apply -f istio-cni.yaml
$ oc apply -f istio-cni.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、
IstioCNIPod にReadyステータス条件が含まれるまで待ちます。oc wait --for=condition=Ready istios/default --timeout=3m
$ oc wait --for=condition=Ready istios/default --timeout=3mCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Ztunnel プロキシーをインストールします。
次のコマンドを実行して、Ztunnel プロキシーの
ztunnelnamespace を作成します。oc create namespace ztunnel
$ oc create namespace ztunnelCopy to Clipboard Copied! Toggle word wrap Toggle overflow ztunnelプロジェクトの namespace 名は、Istio 設定のtrustedZtunnelNamespaceパラメーターと一致する必要があります。次の例のように、
ztunnel.yamlという名前のZtunnelリソースを作成します。設定例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、
ZtunnelCR を適用します。oc apply -f ztunnel.yaml
$ oc apply -f ztunnel.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、
ZtunnelPod にReadyステータス条件が含まれるまで待ちます。oc wait --for=condition=Ready ztunnel/default --timeout=3m
$ oc wait --for=condition=Ready ztunnel/default --timeout=3mCopy to Clipboard Copied! Toggle word wrap Toggle overflow