Instalar con istioctl

Esta guía de instalación utiliza la herramienta de línea de comandos istioctl. istioctl, al igual que otros métodos de instalación, expone muchas opciones de personalización. Además, ofrece validación de la entrada del usuario para ayudar a prevenir errores de instalación e incluye muchas herramientas de análisis y configuración posteriores a la instalación.

Usando estas instrucciones, puedes seleccionar cualquiera de los perfiles de configuración integrados de Istio y luego personalizar aún más la configuración para tus necesidades específicas.

El comando istioctl admite la API completa de IstioOperator a través de opciones de línea de comandos para configuraciones individuales, o pasando un archivo YAML que contiene un recurso personalizado de IstioOperator .

Prerrequisitos

Antes de comenzar, comprueba los siguientes prerrequisitos:

1. Descarga la versión de Istio.
2. Realiza cualquier configuración específica de la plataforma necesaria.

Instalar o actualizar las CRD de la API de Gateway de Kubernetes

Ten en cuenta que las CRD de la API de Gateway de Kubernetes no vienen instaladas por defecto en la mayoría de los clusteres de Kubernetes, así que asegúrate de que estén instaladas antes de usar la API de Gateway:

$ kubectl get crd gateways.gateway.networking.k8s.io &> /dev/null || \
  kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.3.0/standard-install.yaml

Instalar Istio usando el perfil ambient

istioctl admite una serie de perfiles de configuración que incluyen diferentes opciones predeterminadas, y se pueden personalizar para tus necesidades de producción. El soporte para el modo ambient se incluye en el perfil ambient. Instala Istio con el siguiente comando:

$ istioctl install --set profile=ambient --skip-confirmation

Este comando instala el perfil ambient en el cluster definido por tu configuración de Kubernetes.

Configurar y modificar perfiles

La API de instalación de Istio está documentada en la referencia de la API de IstioOperator. Puedes usar la opción --set para istioctl install para modificar parámetros de instalación individuales, o especificar tu propio archivo de configuración con -f.

Los detalles completos sobre cómo usar y personalizar las instalaciones de istioctl están disponibles en la documentación de instalación de sidecar.

Desinstalar Istio

Para desinstalar completamente Istio de un cluster, ejecuta el siguiente comando:

$ istioctl uninstall --purge -y

Alternativamente, para eliminar solo un control plane de Istio específico, ejecuta el siguiente comando:

$ istioctl uninstall <tus opciones de instalación originales>

El namespaces del control plane (por ejemplo, istio-system) no se elimina de forma predeterminada. Si ya no es necesario, usa el siguiente comando para eliminarlo:

$ kubectl delete namespace istio-system

Generar un manifiesto antes de la instalación

Puedes generar el manifiesto antes de instalar Istio usando el subcomando manifest generate. Por ejemplo, usa el siguiente comando para generar un manifiesto para el perfil default que se pueda instalar con kubectl:

$ istioctl manifest generate > $HOME/generated-manifest.yaml

El manifiesto generado se puede usar para inspeccionar qué se instala exactamente, así como para realizar un seguimiento de los cambios en el manifiesto a lo largo del tiempo. Si bien el CR de IstioOperator representa la configuración completa del usuario y es suficiente para realizar un seguimiento, la salida de manifest generate también captura posibles cambios en los charts subyacentes y, por lo tanto, se puede usar para realizar un seguimiento de los recursos instalados reales.