Instala la entrega de Knative en VMware

Aprende a instalar la entrega de Knative en tus clústeres de GKE fuera de Google Cloud. La entrega de Knative ahora usa Anthos Service Mesh y las flotas de GKE Enterprise. Descubre las novedades y los cambios de las instalaciones de flota de servicio de Knative.

Advertencia: Si realizas los pasos de esta página, se realizará una instalación nueva de Knative entrega en VMware y se reemplazará de forma irreversible tu instalación anterior que no es de flota. No continúes con los siguientes pasos en los clústeres para los que habilitaste la entrega de Knative con anterioridad.

Para las instalaciones de “prueba gratuita” anteriores de la entrega de Knative, primero debes actualizar la entrega de Knative en VMware para usar flotas de GKE Enterprise.

Sigue los pasos que se indican en esta página para configurar una instalación nueva o actualizar una instalación de flota existente de entrega de Knative.

Antes de comenzar

Debes asegurarte de cumplir con los requisitos de instalación.

Configura tu recurso personalizado de CloudRun

Para configurar la instalación, debes crear y configurar los recursos personalizados CloudRun de forma manual.

A fin de crear de forma manual un recurso personalizado CloudRun para clústeres de GKE fuera de Google Cloud, sigue estos pasos:

  1. Debes crear una cuenta de servicio o tener una existente a la que se le haya otorgado la función de escritor de métricas de Monitoring (monitoring.metricWriter). requerida.

    • Para crear una cuenta de servicio nueva y descargar la clave, consulta Usa cuentas de servicio.

    • Si tienes una cuenta de servicio existente con los permisos necesarios, busca la clave que descargaste cuando creaste esa cuenta.

  2. Asegúrate de que Cloud Monitoring esté habilitado en GKE en VMware.

  3. Crea el espacio de nombres knative-serving:

    kubectl create namespace knative-serving

  4. Crea un Secret en el espacio de nombres knative-serving que contenga la cuenta de servicio con permisos monitoring.metricWriter:

    kubectl create secret -n knative-serving generic SECRET_NAME --from-file=PATH_TO_KEY_FILE/SECRET_KEY

    Reemplaza lo siguiente:

    • SECRET_NAME por el nombre que elijas para el Secret
    • SECRET_KEY por el nombre del archivo que incluye tus credenciales Ejemplo: key.json
    • PATH_TO_KEY_FILE por la ruta de acceso al directorio de SECRET_KEY

    Consulta la referencia de kubectl create secret para obtener más información, incluidas las marcas opcionales.

  5. Crea un archivo YAML con los siguientes atributos, por ejemplo, cloudrunanthos.yaml:

    apiVersion: operator.run.cloud.google.com/v1alpha1
kind: CloudRun
metadata:
  name: cloud-run
spec:
  metricscollector:
    stackdriver:
      projectid: PROJECT_ID
      gcpzone: CLUSTER_LOCATION
      clustername: CLUSTER_NAME
      secretname: SECRET_NAME
      secretkey: SECRET_KEY

    Reemplaza lo siguiente:

    • PROJECT_ID por el ID del proyecto de Google Cloud.
    • CLUSTER_LOCATION por la región o zona en la que se encuentra el clúster.
    • CLUSTER_NAME por el ID del clúster o el identificador completamente calificado del clúster.
    • SECRET_NAME por el nombre del Secret de la cuenta de servicio del espacio de nombres knative-serving

    • SECRET_KEY por la clave del Secret de la cuenta de servicio del espacio de nombres knative-serving Por ejemplo: key.json

      Para obtener detalles sobre las cuentas de servicio, consulta lo siguiente:

    Ejemplo

    En este recurso personalizado CloudRun de ejemplo, los detalles de configuración de Cloud Monitoring se especifican para usar el Secret my-gcp-logging-secret y la clave key.json:

     apiVersion: operator.run.cloud.google.com/v1alpha1
 kind: CloudRun
 metadata:
   name: cloud-run
 spec:
   metricscollector:
     stackdriver:
       projectid: my-gcp-project-id
       gcpzone: us-central1-c
       clustername: my-anthos-cluster-name
       secretname: my-gcp-logging-secret
       secretkey: key.json
 ```

Habilita y, luego, instala la entrega de Knative

Habilita el componente de entrega de Knative en tu flota de GKE Enterprise y, luego, implementa tu recurso personalizado CloudRun:

  1. Habilita la entrega de Knative en tu flota:

    gcloud container fleet cloudrun enable --project=PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

    Para obtener detalles y opciones adicionales, consulta la referencia de gcloud container fleet cloudrun enable.

  2. Verifica que el componente de función de entrega de Knative esté habilitado (opcional):

    Console

    Observa si el componente de entrega de Knative está Habilitado en la consola de Google Cloud:

    Ir a Funciones de GKE Enterprise

    Línea de comandos

    Comprueba si el estado appdevexperience es ACTIVE:

    gcloud container fleet features list  --project=PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

    Para obtener detalles y opciones adicionales, consulta la referencia de gcloud container fleet features list.

    Resultado:

    NAME               STATE
appdevexperience   ACTIVE

  3. En cada clúster de GKE Enterprise en el que desees instalar la entrega de Knative, debes implementar tu recurso personalizado CloudRun:

    gcloud

    gcloud container fleet cloudrun apply --kubeconfig=KUBECONFIG --context=CONTEXT --config=CONFIG_FILE

    Reemplaza lo siguiente:

    • KUBECONFIG por la ruta de acceso absoluta al archivo de configuración kubectl.
    • CONTEXT por el nombre del contexto en tu archivo de configuración de kubectl que usarás para conectarte.
    • CONFIG_FILE por la ruta de acceso relativa al nombre de archivo del recurso personalizado cloudRun. Ejemplo cloudrunanthos.yaml

    Para obtener detalles y opciones adicionales, consulta la referencia de gcloud container fleet cloudrun apply.

    kubectl

    kubectl apply --kubeconfig=KUBECONFIG --filename CONFIG_FILE

    Reemplaza lo siguiente:

    • KUBECONFIG por la ruta de acceso absoluta al archivo de configuración kubectl.
    • CONFIG_FILE por la ruta de acceso relativa al nombre de archivo del recurso personalizado cloudRun. Ejemplo cloudrunanthos.yaml

    Para obtener detalles y opciones adicionales, consulta la referencia de kubectl apply.

  4. Verifica que se haya habilitado la entrega de Knative en tu clúster:
    1. Abre la consola de Google Cloud:

      Ir a Clústeres de GKE Enterprise

    2. Haz clic en el nombre de tu clúster para abrir el panel de detalles.

    3. Ejecuta este comando para verificar si puedes ver los detalles de la versión de entrega de Knative: kubectl get namespace knative-serving -o 'go-template={{index .metadata.labels "serving.knative.dev/release"}}'
    4. Verifica que todas las implementaciones específicas de Knative que se entregan estén en estado de ejecución en los espacios de nombres knative-serving y appdevexperience.

¿Qué sigue?

Configura la instalación de la entrega de Knative.