Remoção de outras instalações do Istio de um cluster

Se você já instalou o Istio no cluster usando o gráfico IBM Helm ou por outro método, remova essa instalação do Istio antes de habilitar o complemento gerenciado Istio.

Antes de Iniciar: Verifique se o site Istio já está instalado no cluster. Execute kubectl get namespaces e procure o namespace istio-system na saída.

Para remover outras instalações do Istio:

• Se você instalou o Istio usando o diagrama IBM Cloud Istio Helm,

  1. Desinstale a implementação do Istio Helm.

      helm del istio --purge
      ```
  2. Se você usou o Helm 2.9 ou anterior, exclua o recurso de tarefa extra.
  ```sh {: pre}
      kubectl -n istio-system delete job --all
      ```
  3. O processo de desinstalação pode levar até 10 minutos. Antes de instalar o complemento gerenciado do Istio no cluster, execute `kubectl get namespaces` e verifique se o namespace `istio-system` foi removido.
  
  

• Se você tiver instalado o Istio manualmente ou usado o gráfico do Helm da comunidade do Istio, consulte a Documentação de desinstalação do Istio.

• Se você instalou o BookInfo anteriormente no cluster, limpe esses recursos.

  1. Mude o diretório para o local do arquivo Istio.

      cd <filepath>/istio-1.29.5
      ```
  2. Exclua todos os serviços, pods e implementações do BookInfo no cluster.
  ```sh {: pre}
      samples/bookinfo/platform/kube/cleanup.sh
      ```
  3. O processo de desinstalação pode levar até 10 minutos. Antes de instalar o complemento gerenciado do Istio no cluster, execute `kubectl get namespaces` e verifique se o namespace `istio-system` foi removido.
  
  
  
  

Instalando o complemento do Istio

Em vez do Istio da comunidade, você pode instalar o complemento Istio gerenciado.

Antes de Iniciar

• Assegure-se de que você tenha a função de acesso de serviço Gravador ou Gerenciador do IBM Cloud IAM para o IBM Cloud Kubernetes Service.

• Crie um cluster Kubernetes padrão com pelo menos 3 nós do trabalhador, sendo cada um com 4 núcleos e 16 GB de memória (b3c.4x16) ou mais.

• Não é possível executar a comunidade Istio simultaneamente com o complemento Istio gerenciado no cluster. Se você usar um cluster existente e tiver instalado anteriormente o Istio no cluster usando o gráfico do IBM Helm ou por meio de outro método, limpe a instalação do Istio.

• Clusters clássicos multizona: assegure-se de ativar um Virtual Routing and Forwarding (VRF) para sua conta de infraestrutura IBM Cloud. Para ativar o VRF, consulte Ativando o VRF. Para verificar se um VRF já está ativado, use o comando ibmcloud account show. Se não puder ou não quiser ativar a VRF, ative a Ampliação de VLAN. Para realizar essa ação, você precisa da permissão de infraestrutura “ Gerenciar a extensão de VLANs na rede ” ou pode solicitar ao proprietário da conta que a habilite. Para verificar se o spanning de VLAN já está habilitado, use o comando ibmcloud ks vlan spanning get --region REGION .

Customizando a instalação do Istio

É possível customizar um conjunto de opções de configuração do Istio editando o recurso configmap managed-istio-custom. Essas configurações incluem controle extra sobre monitoramento, criação de log e redes em seu plano de controle e sua malha de serviço.

1. Descreva o recurso managed-istio-custom ConfigMap para analisar seu conteúdo e a documentação integrada.

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

2. Edite o recurso de mapa de configuração managed-istio-custom.

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

3. Na seção data, inclua o par <key>: "<value>" de uma ou mais das opções de configuração a seguir.

istio-components-pilot-requests-cpu

Valor padrão: "500m"

Configure a solicitação de CPU no milli para o pod do componente istiod . Tenha cuidado ao mudar esse valor. Configurar esse valor muito baixo pode impedir que o plano de controle funcione adequadamente e configurar esse valor muito alto pode impedir que o pod istiod seja planejado.

istio-global-logging-level

Valor padrão: "default:info" : Defina o escopo de logs e o nível de mensagens de log para componentes do plano de controle. Um escopo representa uma área funcional dentro de um componente do plano de controle e cada escopo suporta níveis específicos de informações de log. O escopo de criação de log default, destinado a mensagens de log não categorizadas, é aplicado a todos os componentes no plano de controle no nível info básico.

Para especificar níveis de log para escopos de componentes individuais, insira uma lista separada por vírgula de escopos e níveis, como "<scope>:<level>,<scope>:<level>". Para obter uma lista dos escopos para cada componente do plano de controle e o nível de informações de mensagens de log, consulte a Documentação de criação de log do componente Istio. Para mudar o nível de log do plano de dados, use o comando istioctl proxy-config log <pod> --level <level>.

istio-global-outboundTrafficPolicy-mode

Valor padrão: "ALLOW_ANY" : Por padrão, todo o tráfego de saída da malha de serviço é permitido. Para bloquear o tráfego de saída da malha de serviço para qualquer host que não esteja definido no registro de serviço ou que não tenha um ServiceEntry dentro da malha de serviço, configure como REGISTRY_ONLY.

istio-global-proxy-accessLogFile

Valor padrão: "" : Os proxies Envoy imprimem informações de acesso na saída padrão. Esses logs são úteis quando você depura problemas de ingresso ou egresso. Para visualizar essas informações de acesso ao executar os comandos kubectl logs para os contêineres do Envoy, configure como "/dev/stdout".

istio-monitoring-telemetry

Valor padrão: "true" : Por padrão, as métricas de telemetria e o suporte Prometheus estão ativados. Para remover quaisquer problemas de desempenho associados às métricas de telemetria e desativar todo o monitoramento, configure como "false".

istio-meshConfig-enableTracing

Valor padrão: "true" : Por padrão, o Istio gera períodos de rastreio para uam de cada 100 solicitações. Para desativar os períodos de rastreio, configure como "false".

istio-pilot-traceSampling

Valor padrão: "1.0"

Por padrão, o Istio gera intervalos de rastreamento para 1 em cada 100 solicitações, o que corresponde a uma taxa de amostragem de 1%. Para gerar mais períodos de rastreio, aumente o valor de porcentagem.

istio-components-pilot-hpa-maxReplicas

Valor padrão: "5"

Por padrão, o arquivo Istio define o número máximo de pods do autoscaler horizontal (HPA) para o istiod como 5. Não aumente esse valor, a menos que você tenha uma service mesh de grande porte em que o istiod precise de mais recursos para atualizar as configurações.

Por exemplo, o seu configmap pode se parecer com o exemplo a seguir.

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

Não vê uma opção dessa tabela em seu configmap? Como o seu configmap contém valores definidos pelo usuário, o configmap não é atualizado com nenhuma opção que seja liberada ao longo do tempo. Em vez disso, é possível fazer backup de uma cópia de seu configmap e excluí-lo do cluster. Depois de aproximadamente 5 minutos, um configmap padrão que contém as novas opções é criado em seu cluster. Em seguida, é possível copiar suas configurações definidas anteriormente de seu backup para esse configmap padrão, definir novas configurações e aplicar as mudanças.

4. Salve e feche o arquivo de configuração.

5. Ao mudar as configurações istio-global-logging-level ou istio-global-proxy-accessLogFile, deve-se reiniciar os pods de plano de dados para aplicar as mudanças neles.

   1. Obtenha a lista de todos os pods de plano de dados que não estão no namespace istio-system.

       istioctl version --short=false | grep "data plane version" | grep -v istio-system
       ```
       Exemplo de saída
   
       ```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 excluindo-o. Na saída da etapa anterior, o nome do pod e o espaço de nomes são listados em 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>
       ```
   

Quer alterar uma configuração do ConfigMap?

Para mudar uma configuração incluída no configmap, é possível usar um script de correção. Por exemplo, se você incluiu a configuração istio-global-proxy-accessLogFile: "/dev/stdout" e posteriormente desejar retorná-la para "", poderá executar kubectl patch cm managed-istio-custom -n ibm-operators --type='json' -p='[{"op": "add", "path": "/data/istio-global-proxy-accessLogFile", "value":""}]'.

Precisa depurar sua configuração de personalização em 1.24 ou posterior?

Verifique o helm value.yaml e os registros de resultados do helm no configmap managed-istio-istiod-control-plane-values no namespace ibm-operators. O site value.yaml mostrará se a alteração foi adicionada. Os resultados do timão mostrarão se houve algum erro de sintaxe.

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!

Precisa depurar sua configuração de personalização no 1.23?

Verifique os registros do pod addon-istio-operator ( Istio versão 1.10 a 1.23 ) executando kubectl logs -n ibm-operators -l name=managed-istio-operator. O operador Istio valida e reconcilia qualquer mudança customizada do Istio que você fizer.

Se você desativar o complemento Istio, o mapa de configuração managed-istio-custom não será removido durante a desinstalação. Quando você reativa o complemento ISTIO, seu configmap customizado é aplicado durante a instalação. Se não quiser reutilizar configurações customizadas em uma instalação mais recente do Istio, você deverá excluir o configmap após desativar o complemento do Istio executando kubectl delete cm -n ibm-operators managed-istio-custom. Ao ativar novamente o complemento Istio, o mapa de configuração padrão é aplicado durante a instalação.

Migração do complemento Istio para a comunidade Istio

Se você estiver usando as versões gerenciadas do complemento Istio 1.21 a 1.23, poderá migrar para uma versão posterior da comunidade Istio.

Antes de Iniciar: Se você não precisar mais do Istio, poderá desinstalar o complemento sem instalar a comunidade Istio em vez de concluir estas etapas.

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

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

Desinstalando o complemento “ Istio ”

Se você já terminou de trabalhar com o Istio, pode limpar os recursos do Istio em seu cluster e desinstalar os complementos do 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