Obtén información para configurar tu instalación de Knative serving.
Antes de comenzar
Debes tener Knative serving instalado en tu clúster de GKE. Consulta la guía de instalación para obtener detalles sobre los requisitos del clúster de GKE y cómo instalar Knative serving.
Configura la autenticación con Workload Identity Federation for GKE
Puedes usar Workload Identity Federation for GKE para autenticar los servicios de Knative serving en las APIs y los servicios de Google Cloud. Debes configurar la federación de identidades para cargas de trabajo para GKE antes de implementar los servicios en el clúster; de lo contrario, cada servicio que exista en el clúster antes de habilitar Workload Identity Federation for GKE para GKE debe migrarse. Obtén más información para usar Workload Identity Federation for GKE.
Habilita métricas con Workload Identity Federation for GKE
Para habilitar las métricas, como el recuento de solicitudes de informes o la latencia de las solicitudes a Google Cloud Observability, debes configurar de forma manual los permisos de escritura de Cloud Monitoring. Para obtener más información, consulta Habilita métricas con Workload Identity Federation for GKE.
Configura HTTPS y dominios personalizados
Para habilitar HTTPS y configurar un dominio personalizado, consulta las siguientes páginas:
Configura Cloud Service Mesh
Si deseas configurar las opciones de Cloud Service Mesh para Knative serving, consulta las Opciones del plano de control en el clúster, incluido cómo configurar una red privada interna.
Configura una red privada interna
Implementar servicios en una red interna es útil para las empresas que proporcionan apps internas a su personal y para servicios que usan los clientes y se ejecutan fuera del clúster de Knative serving. Esta configuración permite que otros recursos de la red se comuniquen con el servicio mediante una dirección IP privada interna (RFC 1918) a la que el público no puede acceder.
A fin de crear tu red interna, configura Cloud Service Mesh para que use el balanceo de cargas de TCP/UDP interno, en lugar de un balanceador de cargas de red externo y público. A continuación, podrás implementar los servicios de Knative serving en una dirección IP interna dentro de la red de VPC.
Antes de comenzar
- Debes tener permisos
admin
en el clúster. - Si configuraste un dominio personalizado, debes inhabilitar la función de TLS administrada, ya que la TLS administrada en Knative serving no es compatible con el balanceador de cargas interno.
- Solo se admiten las versiones 310.0 o posteriores de Google Cloud CLI. Para obtener detalles sobre la configuración de las herramientas de línea de comandos, consulta
Para configurar el balanceador de cargas interno, haz lo siguiente:
Habilita la característica del balanceador de cargas interno en Cloud Service Mesh.
El balanceador de cargas interno es una función opcional que puedes configurar durante la instalación de Cloud Service Mesh o mediante la actualización de tu instalación existente.
Sigue los pasos de Habilita funciones opcionales en el plano de control en el clúster y asegúrate de incluir la opción de secuencia de comandos
--option internal-load-balancer
.Cuando especificas la opción
--option internal-load-balancer
, la secuencia de comandos recupera de forma automática el recurso personalizado Habilitar un balanceador de cargas interno de GitHub. Si necesitas modificar el recurso personalizado, sigue las instrucciones para usar la opción--custom_overlay
en su lugar.Ejecuta el siguiente comando para ver las actualizaciones en el clúster de GKE:
kubectl -n INGRESS_NAMESPACE get svc istio-ingressgateway --watch
Reemplaza INGRESS_NAMESPACE por el espacio de nombres del servicio de entrada de Cloud Service Mesh. Especifica
istio-system
si instalaste Cloud Service Mesh mediante su configuración predeterminada.- Anota la anotación
cloud.google.com/load-balancer-type: Internal
. - Busca el valor de la
IP
en el balanceador de cargas de Ingress para cambiar a una dirección IP privada. - Presiona
Ctrl+C
para detener las actualizaciones cuando veas una dirección IP privada en el campoIP
.
- Anota la anotación
Para los clústeres privados en Google Cloud, debes abrir los puertos. Para obtener más información, consulta Abre puertos en tu clúster privado en la documentación de Cloud Service Mesh.
Para verificar la conectividad interna después de realizar los cambios, sigue estos pasos:
Implementa un servicio llamado
sample
en Knative serving en el espacio de nombresdefault
:gcloud run deploy sample \ --image gcr.io/knative-samples/helloworld \ --namespace default --platform gke
Crea una máquina virtual (VM) de Compute Engine en la misma zona que el clúster de GKE:
VM=cloudrun-gke-ilb-tutorial-vm gcloud compute instances create $VM
Almacena la dirección IP privada de la puerta de enlace de entrada de Istio en una variable de entorno llamada
EXTERNAL_IP
y un archivo llamadoexternal-ip.txt
:export EXTERNAL_IP=$(kubectl -n INGRESS_NAMESPACE get svc istio-ingressgateway \ -o jsonpath='{.status.loadBalancer.ingress[0].ip}' | tee external-ip.txt)
Reemplaza INGRESS_NAMESPACE por el espacio de nombres del servicio de entrada de Cloud Service Mesh. Especifica
istio-system
si instalaste Cloud Service Mesh mediante su configuración predeterminada.Copia el archivo que contiene la dirección IP en la VM:
gcloud compute scp external-ip.txt $VM:~
Conéctate a la VM mediante SSH:
gcloud compute ssh $VM
Mientras estás en la sesión SSH, prueba el servicio de muestra:
curl -s -w'\n' -H Host:sample.default.nip.io $(cat external-ip.txt)
Este es el resultado:
Hello World!
Sal de la sesión de SSH:
exit
Configura un entorno de multiusuario
En casos prácticos de multiusuario, deberás implementar y administrar los servicios de Knative serving en un clúster de Google Kubernetes Engine que esté fuera de tu proyecto actual. Para obtener más información sobre la arquitectura multiusuario de GKE, consulta Clúster de multiusuarios.
Si deseas obtener información sobre cómo configurar multiusuarios para Knative serving, consulta Multiusuario entre proyectos.