Eliminación de otras instalaciones Istio de un clúster

Si anteriormente instalaste Istio en el clúster utilizando el gráfico Helm de IBM o mediante otro método, elimina esa instalación de Istio antes de habilitar el complemento gestionado Istio.

Antes de empezar: Compruebe que Istio ya está instalado en el clúster. Ejecute kubectl get namespaces y busque el espacio de nombres istio-system en el resultado.

Para eliminar otras instalaciones de Istio:

• Si ha instalado Istio utilizando el diagrama de Helm de Istio de IBM Cloud,

  1. Desinstale el despliegue de Helm de Istio.

      helm del istio --purge
      ```
  2. Si ha utilizado Helm 2.9 o anterior, suprima el recurso de trabajo adicional.
  ```sh {: pre}
      kubectl -n istio-system delete job --all
      ```
  3. El proceso de desinstalación puede durar hasta 10 minutos. Antes de instalar el complemento gestionado de Istio en el clúster, ejecute `kubectl get namespaces` y verifique que el espacio de nombres `istio-system` se ha eliminado.
  
  

• Si has instalado Istio manualmente o has utilizado el gráfico Helm de la comunidad Istio, consulta la documentación sobre desinstalación en Istio.

• Si ha instalado anteriormente BookInfo en el clúster, limpie estos recursos.

  1. Cambie el directorio a la ubicación de archivo de Istio.

      cd <filepath>/istio-1.29.5
      ```
  2. Suprima todos los servicios, pods y despliegues de BookInfo del clúster.
  ```sh {: pre}
      samples/bookinfo/platform/kube/cleanup.sh
      ```
  3. El proceso de desinstalación puede durar hasta 10 minutos. Antes de instalar el complemento gestionado de Istio en el clúster, ejecute `kubectl get namespaces` y verifique que el espacio de nombres `istio-system` se ha eliminado.
  
  
  
  

Instalación del complemento de Istio

En lugar de la comunidad Istio, puede instalar el complemento gestionado Istio.

Antes de empezar

• Asegúrate de tener el rol de acceso al servicio IAM IBM Cloud de tipo Writer o Manager para IBM Cloud Kubernetes Service.

• Cree un clúster de Kubernetes estándar con al menos 3 nodos trabajadores con 4 núcleos y 16 GB de memoria (b3c.4x16) o más cada uno.

• No puede ejecutar Istio de comunidad al mismo tiempo que el complemento gestionado de Istio en el clúster. Si utiliza un clúster existente y ha instalado previamente Istio en el clúster mediante el diagrama de Helm de IBM o con otro método, limpie la instalación de Istio.

• Clústeres multizona clásicos: Asegúrese de habilitar un Virtual Routing and Forwarding(VRF) para la cuenta de infraestructura de IBM Cloud. Para habilitar VRF, consulte Habilitación de VRF. Para comprobar si un VRF ya está habilitado, utilice el mandato ibmcloud account show. Si no puede o no desea habilitar VRF, habilite Expansión de VLAN. Para realizar esta acción, necesitas el permiso Gestionar la infraestructura de VLAN de red, o bien puedes solicitar al propietario de la cuenta que te lo habilite. Para comprobar si la extensión de VLAN ya está activada, utiliza el. ibmcloud ks vlan spanning get --region REGIONcomando

Personalización de la instalación de Istio

Puede personalizar un conjunto de opciones de configuración de Istio editando el recurso de mapa de configuración managed-istio-custom. Estos valores incluyen un control adicional sobre la supervisión, el registro y la red en el plano de control y la red de servicios.

1. Describe el recurso ConfigMapmanaged-istio-custom para revisar su contenido y la documentación integrada.

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

2. Edite el recurso de mapa de configuración managed-istio-custom.

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

3. En la sección data, añada el par <key>: "<value>" de una o varias de las siguientes opciones de configuración.

istio-components-pilot-requests-cpu

Valor predeterminado: "500m" :
Configura la solicitud de CPU en CPU milli para el pod del componente istiod . Tenga cuidado al cambiar este valor. Si este valor se establece demasiado bajo, esto podría impedir que el plano de control funcionara correctamente y, si se establece demasiado alto, podría impedir la planificación del pod istiod.

istio-global-logging-level

Valor predeterminado: "default:info" : Defina el ámbito de los registros y el nivel de los mensajes de registro de los componentes del plano de control. Un ámbito representa un área funcional dentro de un componente del plano de control y cada ámbito da soporte a niveles de información de registro específicos. El ámbito de registro predeterminado (default), que es para mensajes de registro no categorizados, se aplica a todos los componentes del plano de control en el nivel de información (info) básico.

Para especificar niveles de registro para ámbitos de componentes individuales, incluya una lista separada por comas de ámbitos y niveles, como "<scope>:<level>,<scope>:<level>". Para consultar una lista de los ámbitos de cada componente del plano de control y el nivel de información de los mensajes de registro, véase la documentación sobre el registro de componentes de Istio. Para cambiar el nivel de registro del plano de datos, utiliza el comando istioctl proxy-config log <pod> --level <level>.

istio-global-outboundTrafficPolicy-mode

Valor predeterminado: "ALLOW_ANY" : De forma predeterminada, se permite todo el tráfico de salida de la malla de servicios. Para bloquear el tráfico de salida de la red de servicios a cualquier host que no esté definido en el registro de servicios o que no tenga una ServiceEntry dentro de la red de servicios, establezca REGISTRY_ONLY.

istio-global-proxy-accessLogFile

Valor predeterminado: "" : Los proxies de Envoy muestran información de acceso a su salida estándar. Estos registros son útiles al depurar problemas de entrada o de salida. Para ver esta información de acceso al ejecutar mandatos kubectl logs para los contenedores de Envoy, establezca "/dev/stdout".

istio-monitoring-telemetry

Valor predeterminado: "true" : De forma predeterminada, se habilita la métrica de telemetría y el soporte de Prometheus. Para eliminar cualquier problema de rendimiento asociado con las métricas de telemetría e inhabilitar todas las funciones de supervisión, establézcalo en "false".

istio-meshConfig-enableTracing

Valor predeterminado: "true" : De forma predeterminada, Istio genera intervalos de rastreo para 1 de cada 100 solicitudes. Para inhabilitar los intervalos de rastreo, establezca el valor en "false".

istio-pilot-traceSampling

Valor predeterminado: "1.0"

De forma predeterminada, Istio genera tramos de seguimiento para 1 de cada 100 solicitudes, lo que supone una tasa de muestreo del 1 %. Para generar más intervalos de rastreo, aumente el valor de porcentaje.

istio-components-pilot-hpa-maxReplicas

Valor predeterminado: "5" :
Por defecto,Istio establece en istiod 5 el número máximo de pods del escalador automático horizontal (HPA) predeterminado. No aumentes este valor a menos que tengas una malla de servicios de gran tamaño en la que se necesiten istiod más recursos para actualizar las configuraciones.

Por ejemplo, el mapa de configuración puede tener un aspecto similar al siguiente.

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

¿No ve una opción de esta tabla en el mapa de configuración? Dado que el mapa de configuración contiene valores definidos por el usuario, el mapa de configuración no se actualizará con ninguna opción que se añada con el tiempo. En su lugar, puede realizar una copia de seguridad de una copia del mapa de configuración y suprimir el mapa de configuración del clúster. Después de unos 5 minutos, se crea un mapa de configuración predeterminado que contiene las nuevas opciones en el clúster. A continuación, puede copiar los valores configurados anteriormente de la copia de seguridad en este mapa de configuración predeterminado, configurar todos los nuevos valores y aplicar los cambios.

4. Guarde y cierre el archivo de configuración.

5. Si ha modificado los valores istio-global-logging-level o istio-global-proxy-accessLogFile, debe reiniciar los pods del plano de datos para aplicarles los cambios.

   1. Obtenga la lista de todos los pods del plano de control que no están en el espacio de nombres istio-system.

       istioctl version --short=false | grep "data plane version" | grep -v istio-system
       ```
       Salida de ejemplo
   
       ```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. Reinicie cada pod suprimiéndolo. En la salida del paso anterior, el nombre del pod y el espacio de nombres se listan en cada entrada como `data plane version: version.ProxyInfo{ID:"<pod_name>.<namespace>", IstioVersion:"1.29.5"}`.
   ```sh {: pre}
       kubectl delete pod <pod_name> -n <namespace>
       ```
   

¿Quieres cambiar una configuración de ConfigMap?

Si desea cambiar un valor añadido al mapa de configuración, puede utilizar un script de parche. Por ejemplo, si ha añadido el valor istio-global-proxy-accessLogFile: "/dev/stdout" y, más adelante, quiere cambiarlo de nuevo a "", puede ejecutar kubectl patch cm managed-istio-custom -n ibm-operators --type='json' -p='[{"op": "add", "path": "/data/istio-global-proxy-accessLogFile", "value":""}]'.

¿Necesitas depurar tu configuración de personalización en 1.24 o posterior?

Compruebe el helm value.yaml y los registros de resultados del helm en el configmap managed-istio-istiod-control-plane-values en el espacio de nombres ibm-operators. La página value.yaml le mostrará si su cambio ha sido añadido. Los resultados del timón le mostrarán si hubo algún error de sintaxis.

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!

¿Necesitas depurar la configuración de tu personalización en 1.23?

Compruebe los registros del pod addon-istio-operator ( Istio versión 1.10 a 1.23 ) ejecutando kubectl logs -n ibm-operators -l name=managed-istio-operator. El operador de Istio valida y concilia los cambios de Istio personalizados que realice.

Si inhabilita el complemento de Istio, el mapa de configuración managed-istio-custom no se elimina durante la desinstalación. Al volver a habilitar el complemento de Istio, se aplica el mapa de configuración personalizado durante la instalación. Si no desea volver a utilizar los valores personalizados en una instalación posterior de Istio, debe suprimir el mapa de configuración después de inhabilitar el complemento de Istio ejecutando kubectl delete cm -n ibm-operators managed-istio-custom. Cuando vuelva a habilitar el complemento de Istio, se aplicará el mapa de configuración predeterminado durante la instalación.

Migración del complemento Istio a la comunidad Istio

Si está utilizando el complemento gestionado Istio versiones 1.21 a 1.23, puede migrar a una versión posterior de la comunidad Istio en su lugar.

Antes de empezar: Si ya no necesita Istio, puede desinstalar el complemento sin instalar la comunidad Istio en lugar de seguir estos pasos.

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

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

Desinstalación del complemento Istio

Si ya ha terminado de trabajar con Istio, puede limpiar los recursos de Istio de su clúster y desinstalar los complementos de 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