Guía de inicio rápido: Implementa en Cloud Run for Anthos en Google Cloud

Aprende a crear un clúster habilitado para Cloud Run for Anthos en Google Cloud (antes conocido como “Cloud Run for Anthos”) y, luego, implementa un contenedor de muestra compilado previamente en ese clúster.

En cambio, si tienes una cuenta de demostración, puedes seguir esta guía de inicio rápido en Qwiklabs.

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir a la página del selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. Para asegurarte de tener la última versión del SDK de Cloud, instala o actualiza el SDK de Cloud:
    • Instala e inicializa el SDK de Cloud.
    • Si ya instalaste el SDK de Cloud, actualiza los componentes instalados:
      gcloud components update
    • Instala el componente beta:
      gcloud components install beta

Configura el entorno de la línea de comandos y habilita las API necesarias

Completa los siguientes pasos a fin de configurar el entorno de la línea de comandos para Cloud Run for Anthos y habilitar las API obligatorias:

  1. Configura la herramienta de línea de comandos de gcloud para usar el ID del proyecto de Cloud de forma predeterminada:

    gcloud config set project PROJECT-ID

    Reemplaza PROJECT-ID por el ID del proyecto.

  2. Establece la zona en la que deseas que se implemente el clúster nuevo. Puedes usar cualquier zona que admita GKE. Por ejemplo:

    gcloud config set compute/zone ZONE

    Reemplaza ZONE por la zona deseada.

  3. Ejecuta el comando gcloud services para habilitar las siguientes API en tu proyecto de Cloud:

    • API de Google Kubernetes Engine: Crea clústeres de GKE.
    • API de Cloud Build: Compila contenedores.
    • API de Container Registry: Publica contenedores en Container Registry.
    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com

    Este proceso puede tomar varios segundos en completarse. Una vez que se habilitan las API, la línea de comandos muestra un mensaje similar al siguiente:

    Operation "operations/..." finished successfully.

Crea un clúster de GKE con Cloud Run for Anthos habilitado

Completa los siguientes pasos a fin de crear un clúster y habilitarlo para Cloud Run for Anthos:

  1. Crea un clúster nuevo mediante el siguiente comando:

    gcloud container clusters create CLUSTER_NAME \
      --addons=HttpLoadBalancing,CloudRun \
      --machine-type=n1-standard-2 \
      --enable-stackdriver-kubernetes

    Reemplaza CLUSTER_NAME por el nombre que deseas para el clúster.

  2. Espera a que termine de crearse el clúster. Durante el proceso de creación, deberías ver mensajes similares a los siguientes:

    Creating cluster my-cluster...done.
    Created [https://container.googleapis.com/v1beta1/ \
    projects/my-project/zones/us-central1-b/clusters/my-cluster].
    

    En el ejemplo anterior, my-project es el ID de tu proyecto de Cloud y my-cluster es el clúster que acabas de crear.

  3. Establece los valores predeterminados de gcloud para tus recursos de Cloud Run for Anthos en el nombre del clúster nuevo y su ubicación. Puedes establecer estos valores predeterminados para evitar especificarlos cada vez que uses la herramienta de línea de comandos de gcloud.

    gcloud config set kuberun/cluster CLUSTER_NAME
    gcloud config set kuberun/cluster_location ZONE

    Reemplaza CLUSTER_NAME y ZONE por los mismos valores que usaste para crear tu clúster nuevo.

Implementa un contenedor de muestra

Usa Google Cloud Console para implementar un contenedor de muestra y crear un servicio en el clúster:

  1. En Cloud Console, ve a la página Cloud Run for Anthos.

    Ir a Cloud Run for Anthos

  2. Haz clic en Crear servicios para abrir el formulario Crear servicios:

  3. En el menú desplegable de clústeres disponibles, selecciona el clúster que acabas de crear.

  4. Deja default ingresado como nombre del espacio de nombres.

  5. Ingresa un nombre de servicio, como hello.

  6. Haga clic en Next.

  7. Selecciona Implementar una revisión desde una imagen de contenedor y, luego, selecciona hello en el menú desplegable de contenedores de demostración.

  8. Haga clic en Next.

  9. Selecciona Externa en Conectividad para que puedas invocar el servicio.

  10. Haz clic en Crear para implementar la imagen en Cloud Run for Anthos y espera a que se complete la implementación.

Felicitaciones Acabas de implementar un servicio en un clúster habilitado para Cloud Run for Anthos.

Accede al servicio implementado

Ahora que el servicio está en ejecución, puedes enviarle solicitudes. En esta sección, se usa cURL para demostrar cómo acceder al servicio y verificar que funcione:

  1. En Cloud Console, ve a la página Cloud Run for Anthos.

    Ir a Cloud Run for Anthos

  2. Haz clic en el nombre de tu servicio nuevo de Cloud Run for Anthos para ir a la página Detalles del servicio.

  3. Haz clic en Información , a la derecha de la URL del servicio.

  4. Haz clic en Invocar en Cloud Shell para ejecutar el comando cURL generado para el servicio en Cloud Shell.

La solicitud cURL muestra el código fuente del contenedor de muestra que ejecuta el servicio. Ya verificaste que el servicio está manejando las solicitudes.

Realiza una limpieza

Puedes inhabilitar Cloud Run for Anthos o puedes borrar el clúster y el servicio de Cloud Run for Anthos a fin de evitar que se generen costos por ejecutar estos recursos.

Inhabilita Cloud Run for Anthos

Para inhabilitar Cloud Run for Anthos y mantener tu clúster, sigue estos pasos:

  1. En Cloud Console, ve a la página Google Kubernetes Engine.

    Ir a Google Kubernetes Engine

  2. Haz clic en el clúster en el que deseas inhabilitar Cloud Run for Anthos.

  3. Haz clic en Editar.

  4. Desplázate hacia abajo hasta Características de Anthos y, en el menú desplegable Cloud Run for Anthos en Google Cloud, selecciona Inhabilitar.

  5. Haz clic en Guardar.

Borra Cloud Run for Anthos

Para borrar de forma permanente el clúster de GKE, incluido el servicio de Cloud Run for Anthos y todos sus recursos, sigue estos pasos:

  1. En Cloud Console, ve a la página Google Kubernetes Engine.

    Ir a Google Kubernetes Engine

  2. Selecciona el clúster que deseas borrar.

  3. Haz clic en Borrar. Luego, haz clic en Borrar de nuevo en la ventana emergente.

Próximos pasos

Para obtener información sobre cómo compilar un contenedor desde el código fuente, enviar a Container Registry y, luego, implementar, consulta el siguiente vínculo:

Si quieres obtener una descripción general de la arquitectura de Cloud Run for Anthos que abarque los cambios de la instalación de Cloud Run for Anthos en Google Cloud como un complemento para tu clúster de Google Kubernetes Engine, consulta los siguientes vínculos: