Instalar con Istioctl

lectura de 6 minutos prueba de página

Sigue esta guía para instalar y configurar un mesh de Istio para evaluación detallada o uso en producción. Si eres nuevo en Istio, y solo quieres probarlo, sigue las instrucciones de inicio rápido en su lugar.

Esta guía de instalación usa la herramienta de línea de comandos istioctl para proporcionar una rica personalización del control plane de Istio y de los sidecars para el data plane de Istio. Tiene validación de entrada del usuario para ayudar a prevenir errores de instalación y opciones de personalización para sobrescribir cualquier aspecto de la configuración.

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

El comando istioctl soporta la IstioOperator API completa a través de opciones de línea de comandos para configuraciones individuales o para pasar un archivo yaml que contiene un recurso personalizado (CR) IstioOperator.

Prerrequisitos

Antes de comenzar, verifica los siguientes prerrequisitos:

Descarga la versión de Istio.
Realiza cualquier configuración específica de la plataforma (/es/docs/setup/platform-setup/).
Verifica los Requisitos para Pods y Servicios.

Instalar Istio usando el perfil por defecto

La opción más simple es instalar el perfil default de Istio perfil de configuración usando el siguiente comando:

$ istioctl install

Este comando instala el perfil default en el clúster definido por tu configuración de Kubernetes. El perfil default es un buen punto de partida para establecer un entorno de producción, a diferencia del perfil demo más grande que está destinado a evaluar un amplio conjunto de características de Istio.

Varias configuraciones pueden modificarse para modificar las instalaciones. Por ejemplo, para habilitar los registros de acceso:

$ istioctl install --set meshConfig.accessLogFile=/dev/stdout

Muchos de los ejemplos de esta página y en la documentación en su totalidad están escritos usando --set para modificar los parámetros de instalación, en lugar de pasar un archivo de configuración con -f. Esto se hace para hacer los ejemplos más compactos. Los dos métodos son equivalentes, pero -f es fuertemente recomendado para producción. El comando anterior se escribiría de la siguiente manera usando -f:

$ cat <<EOF > ./my-config.yaml
apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    accessLogFile: /dev/stdout
EOF
$ istioctl install -f my-config.yaml

Instalar desde gráficos externos

Por defecto, istioctl usa gráficos compilados para generar el manifiesto de instalación. Estos gráficos se lanzan juntos con istioctl para propósitos de auditoría y personalización y se pueden encontrar en el archivo tar de la versión en el directorio manifests. istioctl también puede usar gráficos externos en lugar de los compilados. Para seleccionar gráficos externos, establece la bandera manifests a un camino de sistema de archivos local:

$ istioctl install --manifests=manifests/

Si estás usando el binario de istioctl 1.29.0, este comando resultará en la misma instalación que istioctl install solo, porque apunta a los mismos gráficos que los compilados. Aparte de para experimentar con o probar nuevas características, recomendamos usar los gráficos compilados en lugar de externos para asegurar la compatibilidad del binario de istioctl con los gráficos.

Instalar un perfil diferente

Otros perfiles de configuración de Istio pueden instalarse en un clúster pasando el nombre del perfil en la línea de comandos. Por ejemplo, el siguiente comando puede usarse para instalar el perfil demo:

$ istioctl install --set profile=demo

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 puede ser instalado con kubectl:

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

El manifiesto generado puede usarse para inspeccionar exactamente qué se ha instalado así como para rastrear cambios en el manifiesto a lo largo del tiempo. Mientras que el CR IstioOperator representa la configuración completa del usuario y es suficiente para rastrearlo, la salida de manifest generate también captura posibles cambios en los gráficos subyacentes y, por lo tanto, puede usarse para rastrear los recursos realmente instalados.

Si estás intentando instalar y gestionar Istio usando istioctl manifest generate, por favor ten en cuenta los siguientes advertencias:

El espacio de nombres de Istio (istio-system por defecto) debe crearse manualmente.
La validación de Istio no estará habilitada por defecto. A diferencia de istioctl install, el comando manifest generate no creará la configuración de webhook de validador de istiod-default-validator a menos que values.defaultRevision esté establecido:
```
$ istioctl manifest generate --set values.defaultRevision=default
```
Los recursos pueden no instalarse con la misma secuenciación de dependencias que istioctl install.
Este método no está probado como parte de las versiones de Istio.
Mientras que istioctl install detectará automáticamente las configuraciones específicas del entorno de tu contexto de Kubernetes, manifest generate no puede hacerlo porque se ejecuta en línea, lo que puede llevar a resultados inesperados. En particular, debes asegurarte de que sigas estos pasos si tu entorno de Kubernetes no soporta tokens de cuenta de servicio de terceros. Se recomienda añadir --cluster-specific a tu comando istio manifest generate para detectar el entorno del clúster objetivo, lo que incluirá esos ajustes de entorno específicos del clúster en los manifiestos generados. Esto requiere acceso a red a tu clúster en ejecución.
kubectl apply del manifiesto generado puede mostrar errores transitorios debido a recursos no disponibles en el orden correcto en el clúster.
istioctl install automáticamente poda cualquier recurso que debería ser eliminado cuando la configuración cambia (por ejemplo, si eliminas un gateway). Esto no ocurre cuando usas istio manifest generate con kubectl y estos recursos deben ser eliminados manualmente.

Consulta Personalizar la configuración de la instalación para obtener más información sobre la personalización de la instalación.

Desinstalar Istio

Para desinstalar completamente Istio de un clúster, ejecuta el siguiente comando:

$ istioctl uninstall --purge

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

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

$ istioctl manifest generate <tus opciones de instalación originales> | kubectl delete --ignore-not-found=true -f -

El espacio de nombres del plan de control (por ejemplo, istio-system) no se elimina por defecto. Si ya no es necesario, usa el siguiente comando para eliminarlo:

$ kubectl delete namespace istio-system

Ver también

Diagnose your Configuration with Istioctl Analyze

Shows you how to use istioctl analyze to identify potential issues with your configuration.

Understand your Mesh with Istioctl Describe

Shows you how to use istioctl describe to verify the configurations of a pod in your mesh.

Verifying Istio Sidecar Injection with Istioctl Check-Inject

Learn how to use istioctl check-inject to confirm if Istio sidecar injection is properly enabled for your deployments.

Application Requirements

Requirements of applications deployed in an Istio-enabled cluster.

Before you begin

Initial steps before configuring locality load balancing.

Before you begin

Initial steps before installing Istio on multiple clusters.