クラスタから他の Istio インストールを削除する

以前に「 IBM 」の「 Helm 」チャート、またはその他の方法を使用してクラスターに Istio をインストールしていた場合は、マネージド Istio アドオンを有効にする前に、その Istio のインストールをクリーンアップしてください。

始める前に Istio、クラスタにすでにインストールされていることを確認する。 kubectl get namespaces を実行し、出力で istio-system 名前空間を探す。

他の Istio のインストールを削除する：

• IBM Cloud Istio Helm チャートを使用して Istio をインストールした場合は、以下のようにします。

  1. Istio Helm デプロイメントをアンインストールします。

      helm del istio --purge
      ```
  2. Helm 2.9 以前を使用した場合は、さらにジョブ・リソースを削除します。
  ```sh {: pre}
      kubectl -n istio-system delete job --all
      ```
  3. アンインストール処理には、最大 10 分かかります。 Istio マネージド・アドオンをクラスターにインストールする前に、`kubectl get namespaces` を実行して、`istio-system` 名前空間が削除されたことを確認します。
  
  

• Istio を手動でインストールした場合、または Istio コミュニティの Helm チャートを使用した場合は、「 Istio のアンインストール」に関するドキュメントを参照してください。

• 以前にクラスター内に BookInfo をインストールした場合は、それらのリソースをクリーンアップします。

  1. ディレクトリーを Istio ファイルの場所に切り替えます。

      cd <filepath>/istio-1.29.5
      ```
  2. クラスター内の BookInfo サービス、ポッド、デプロイメントをすべて削除します。
  ```sh {: pre}
      samples/bookinfo/platform/kube/cleanup.sh
      ```
  3. アンインストール処理には、最大 10 分かかります。 Istio マネージド・アドオンをクラスターにインストールする前に、`kubectl get namespaces` を実行して、`istio-system` 名前空間が削除されたことを確認します。
  
  
  
  

Istio アドオンのインストール

コミュニティ Istio の代わりに、マネージド Istio アドオンをインストールすることができます。

開始前に

• IBM Cloud Kubernetes Service 用の「 作家 または、 マネージャー IBM Cloud IAM サービスのアクセスロール 」がインストールされていることを確認してください。

• それぞれが 4 コアと 16 GB のメモリー (b3c.4x16) 以上を備えた、少なくとも 3 つのワーカー・ノードのある標準 Kubernetes クラスターを作成します。

• クラスターにおいて管理対象 Istio アドオンと同時にコミュニティー Istio を実行することはできません。 既存のクラスターを使用している場合に、IBM Helm チャートまたは別の方法を使用して、そのクラスターに Istio を既にインストールしている場合は、その Istio インストール済み環境をクリーンアップしてください。

• クラシック・マルチゾーン・クラスター: IBM Cloud インフラストラクチャー・アカウントに対して Virtual Routing and Forwarding(VRF) を有効にしていることを確認します。 VRF を有効にするには、VRF の有効化を参照してください。 VRF が既に有効になっているかどうかを確認するには、ibmcloud account show コマンドを使用します。 VRF を有効にできない、または有効にしない場合は、VLAN スパンニングを有効にします。 この操作を実行するには、「 ネットワーク VLAN スパンニングの管理 」インフラストラクチャ権限が必要です。または、 アカウントこの権限を有効にするよう依頼することもできます。 VLANスパンニングがすでに有効になっているかどうかを確認するには、 ibmcloud ks vlan spanning get --region REGION コマンド を使用します。

Istio インストール済み環境のカスタマイズ

managed-istio-custom 構成マップ・リソースを編集することによって、一連の Istio 構成オプションをカスタマイズできます。 これらの設定には、コントロール・プレーンおよびサービス・メッシュのモニタリング、ロギング、およびネットワーキングに対する追加の制御が含まれます。

1. managed-istio-custom ConfigMap リソースについて説明し、その内容とインラインドキュメントを確認してください。

   kubectl describe cm managed-istio-custom -n ibm-operators
   

2. managed-istio-custom 構成マップ・リソースを編集します。

   kubectl edit cm managed-istio-custom -n ibm-operators
   

3. data セクションで、以下の 1 つ以上の構成オプションの <key>: "<value>" ペアを追加します。

istio-components-pilot-requests-cpu

デフォルト値: "500m"

「 milli 」の CPU 設定で、 istiod コンポーネントのポッドに対する CPU リクエストを設定します。 この値を変更するときには注意してください。 この値を低く設定しすぎると、コントロールプレーンが正常に動作しなくなる可能性があります。また、この値を高く設定しすぎると、 istiod ポッドがスケジューリングされなくなる可能性があります。

istio-global-logging-level

デフォルト値: "default:info" : コントロール・プレーン・コンポーネントに対してログ・スコープとログ・メッセージ・レベルを定義します。 スコープは、コントロール・プレーン・コンポーネント内の機能領域を表します。各スコープは特定のログ情報レベルをサポートします。 カテゴリー化されていないログ・メッセージ用の default ロギング・スコープは、基本の info レベルのコントロール・プレーンのすべてのコンポーネントに適用されます。

個々のコンポーネント・スコープのログ・レベルを指定するには、スコープとレベルのコンマ区切りリストを入力します (例: "<scope>:<level>,<scope>:<level>")。 各コントロールプレーンコンポーネントの適用範囲およびログメッセージの情報レベルの詳細については、『 Istio 』のコンポーネントログに関するドキュメントを参照してください。 データプレーンのログレベルを変更するには、 istioctl proxy-config log <pod> --level <level> コマンドを使用します。

istio-global-outboundTrafficPolicy-mode

デフォルト値: "ALLOW_ANY" : デフォルトでは、サービス・メッシュからのアウトバウンド・トラフィックがすべて許可されます。 サービス・レジストリー内に定義されていないホスト、またはサービス・メッシュ内に ServiceEntry が含まれないホストへのサービス・メッシュからのアウトバウンド・トラフィックをブロックするには、REGISTRY_ONLY に設定します。

istio-global-proxy-accessLogFile

デフォルト値: "" : Envoy プロキシーはアクセス情報を標準出力に出力します。 これらのログは、Ingress または Egress に関する問題をデバッグする際に役立ちます。 Envoy コンテナーに対して kubectl logs コマンドを実行するときにこのアクセス情報を表示するには、"/dev/stdout" に設定します。

istio-monitoring-telemetry

デフォルト値: "true" : デフォルトでは、テレメトリー・メトリックおよび Prometheus サポートは有効になっています。 テレメトリー・メトリックに関連するすべてのパフォーマンス問題を削除し、すべてのモニタリングを無効にするには、"false" に設定します。

istio-meshConfig-enableTracing

デフォルト値: "true" : デフォルトでは、Istio は 100 個の要求ごとに 1 個の要求に対してトレース・スパンを生成します。 トレース・スパンを無効にするには、"false" に設定します。

istio-pilot-traceSampling

デフォルト値: "1.0"

デフォルトでは、 Istio は100件のリクエストごとに1件についてトレーススパンを生成します。これは、サンプリング率が1%に相当します。 より多くのトレース・スパンを生成するには、パーセンテージ値を増やします。

istio-components-pilot-hpa-maxReplicas

デフォルト値: "5"

デフォルトでは、 Istio により、 istiod のデフォルトの水平ポッドオートスケーラー（HPA）の最大ポッド数が 5 に設定されます。 大規模なサービスメッシュを運用しており、 istiod が設定の更新にさらなるリソースを必要とする場合を除き、この値を増やさないでください。

例えば、構成マップは以下の例のようになります。

apiVersion: v1
data:
  istio-ingressgateway-zone-1: dal10
  <key: value> # such as istio-egressgateway-public-1-enabled: "false"
kind: ConfigMap
metadata:
  name: managed-istio-custom
  namespace: ibm-operators

構成マップにこの表のオプションがありませんか? 構成マップにユーザー定義の値が含まれているため、時間経過に伴いリリースされるオプションに照らして構成マップが更新されていません。 ここでは、構成マップのコピーをバックアップし、クラスターからその構成マップを削除できます。 約 5 分経過すると、新しいオプションが含まれるデフォルトの構成マップがクラスターに作成されます。 その後、以前に構成した設定をバックアップからこのデフォルト構成マップにコピーし、新しい設定を構成し、変更を適用できます。

4. 構成ファイルを保存して閉じます。

5. istio-global-logging-level または istio-global-proxy-accessLogFile の設定を変更した場合、データ・プレーン・ポッドを再始動して、変更を適用する必要があります。

   1. istio-system 名前空間に含まれていないすべてのデータ・プレーン・ポッドのリストを取得します。

       istioctl version --short=false | grep "data plane version" | grep -v istio-system
       ```
       出力例
   
       ```sh {: screen}
       data plane version: version.ProxyInfo{ID:"test-6f86fc4677-vsbsf.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"rerun-xfs-f8958bb94-j6n89.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"test2-5cbc75859c-jh6bx.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"minio-test-78b5d4597d-hkpvt.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"sb-887f89d7d-7s8ts.default", IstioVersion:"1.29.5"}
       data plane version: version.ProxyInfo{ID:"gid-deployment-5dc86db4c4-kdshs.default", IstioVersion:"1.29.5"}
       ```
   2. 各ポッドを削除して、再始動します。 前のステップの出力では、ポッド名と名前空間が各項目に `data plane version: version.ProxyInfo{ID:"<pod_name>.<namespace>", IstioVersion:"1.29.5"}` としてリストされています。
   ```sh {: pre}
       kubectl delete pod <pod_name> -n <namespace>
       ```
   

ConfigMap の設定を変更したいですか？

configmap に追加した設定を変更したい場合は、パッチ・スクリプトを使用します。 例えば、istio-global-proxy-accessLogFile: "/dev/stdout" 設定を追加した後で、"" に戻す場合は、kubectl patch cm managed-istio-custom -n ibm-operators --type='json' -p='[{"op": "add", "path": "/data/istio-global-proxy-accessLogFile", "value":""}]' を実行します。

1.24 以降でカスタマイズのセットアップをデバッグする必要がありますか？

ibm-operators名前空間のmanaged-istio-istiod-control-plane-values configmapにあるhelm value.yaml とhelmの結果ログを確認してください。 value.yaml に、あなたの変更が追加されたかどうかが表示されます。 helmの結果には、構文エラーがあったかどうかが表示されます。

kubectl get cm -n ibm-operators managed-istio-istiod-control-plane-values -o json | jq -r .data.\"values.yaml\"
kubectl get cm -n ibm-operators managed-istio-istiod-control-plane-values -o json | jq -r .data.\"values.yaml.helm.result\"

Thu, 23 Oct 2025 19:58:48 GMT HELM_SUCCESS: Release "istiod" has been upgraded. Happy Helming!
NAME: istiod
LAST DEPLOYED: Thu Oct 23 19:58:42 2025
NAMESPACE: istio-system
STATUS: deployed
REVISION: 275
TEST SUITE: None
NOTES:
"istiod" successfully installed!

1.23 でのカスタマイズ設定のデバッグが必要ですか？

kubectl logs -n ibm-operators -l name=managed-istio-operator を実行して、 addon-istio-operator ( Istio バージョン 1.10 から 1.23 ) ポッドのログをチェックする。 行われたすべてのカスタム Istio の変更は、Istio オペレーターにより検証および調整されます。

Istio アドオンを無効化する場合、アンインストール中に managed-istio-custom 構成マップが削除されることはありません。 Istio アドオンを再有効化すると、カスタマイズした構成マップがインストール中に適用されます。 Istio を後からインストールするときにカスタム設定を再使用しない場合は、kubectl delete cm -n ibm-operators managed-istio-custom を実行して Istio アドオンを無効にした後で configmap を削除する必要があります。 Istio アドオンを再有効化するときに、インストール中にデフォルトの構成マップが適用されます。

Istio アドオンからコミュニティへの移行 Istio

管理された Istio アドオンのバージョン 1.21 から 1.23 を使用している場合、代わりにコミュニティ Istio の後のバージョンに移行することができます。

始める前に Istio が不要になった場合は、これらの手順を完了する代わりに、 コミュニティ Istio をインストールせずにアドオンをアンインストール することができます。

kubectl scale deployment -n ibm-operators addon-istio-operator --replicas=0

kubectl delete cm -n ibm-operators managed-istio-custom

「 Istio 」アドオンのアンインストール

Istio の使用が終了したら、クラスター内の Istio リソースをクリーンアップし、 Istio のアドオンをアンインストールできます。

kubectl delete deployment -n ibm-operators addon-istio-operator --ignore-not-found=true
kubectl delete serviceaccount -n ibm-operators addon-istio-operator --ignore-not-found=true
kubectl delete clusterrolebinding addon-istio-operator --ignore-not-found=true
kubectl delete clusterrole addon-istio-operator --ignore-not-found=true