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

En esta página, se muestra cómo crear un clúster habilitado para Cloud Run for Anthos en Google Cloud y, luego, implementar un contenedor de muestra ya compilado en el clúster.

También puedes seguir esta guía de inicio rápido con una cuenta de demostración 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 de selección de proyectos de Cloud Console, selecciona o crea un proyecto de Cloud.

    Ir a la página Selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Instala cURL si deseas enviar una solicitud al servicio de muestra implementado.
  5. Configura la línea de comandos de gcloud, que se describe a continuación.

Configura la línea de comandos de gcloud

Si deseas configurar la línea de comandos de gcloud para Cloud Run for Anthos en Google Cloud, haz lo siguiente:

  1. Instala y, también, inicializa el SDK de Cloud.

  2. Configura la plataforma en gke y establece la configuración del proyecto predeterminado para gcloud al que acabas de crear:

    gcloud config set run/platform gke
    gcloud config set project PROJECT-ID

    Reemplaza PROJECT-ID por el ID del proyecto que creaste.

  3. Configura la zona deseada del clúster nuevo. Puedes usar cualquier zona que admita GKE, por ejemplo:

    gcloud config set compute/zone ZONE

    Reemplaza ZONE por la zona.

  4. Habilita las siguientes API para el proyecto, que son necesarias a fin de crear un clúster, y compilar y publicar un contenedor en Google Container Registry:

    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com
  5. Actualiza los componentes de gcloud instalados:

    gcloud components update

Crea un clúster de GKE con Cloud Run habilitado

Para crear un clúster y habilitarlo en Cloud Run for Anthos en Google Cloud, haz lo siguiente:

  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 \
      --zone=ZONE

    Reemplaza los siguientes elementos:

    • CLUSTER_NAME por el nombre que deseas para el clúster.
    • ZONE por la zona que usas para el clúster, por ejemplo, us-central1-a. Puedes usar cualquier zona que admita GKE

    Ten en cuenta que, mediante estas instrucciones, no se habilita el ajuste de escala automático del clúster para cambiar el tamaño de los clústeres según la demanda. Cloud Run for Anthos en Google Cloud escala instancias de forma automática en 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 tu propio ID del proyecto. Acabas de crear un clúster nuevo de Google Kubernetes Engine llamado my-cluster en el proyecto my-project.

  3. Configura los valores predeterminados de gcloud para usar el clúster nuevo y la ubicación del clúster, a fin de evitar tener que especificarlos cuando uses la línea de comandos de gcloud:

    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location us-central1-a

    Reemplaza CLUSTER_NAME por el nombre que usaste para el clúster y, si es necesario, reemplaza us-central1-a por la ubicación de clúster compatible que elijas.

Implementa un contenedor de muestra

Para implementar un contenedor en el clúster que acabas de crear, debes hacer lo siguiente:

  1. Ir a Cloud Run

  2. Hacer clic en Crear servicio para ver el formulario Create service (Crear servicio):

    imagen

    En el formulario, debes hacer lo siguiente:

    1. Selecciona Cloud Run for Anthos en Google Cloud como la plataforma de desarrollo.

    2. En el menú desplegable de clústeres disponibles, selecciona el clúster que acabas de crear en los pasos anteriores.

    3. Usa hello como nombre del servicio. Puedes usar otro nombre, pero si lo haces, asegúrate de usarlo más adelante cuando uses el comando cURL para acceder al servicio. En estas instrucciones, suponemos que usas hello.

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

    5. Haz clic en Siguiente para ir a la segunda página del formulario de creación de servicios:

      imagen

      En el formulario, debes hacer lo siguiente:

      1. Usa gcr.io/cloudrun/hello como imagen de contenedor.

      2. Haz clic en Create (Crear) para implementar la imagen en Cloud Run y espera a que termine la implementación.

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

Accede al servicio implementado

Después de implementar el servicio, puedes usar cURL a fin de enviar una solicitud y verificar que el servicio funcione, mediante la dirección IP externa del servicio de balanceador de cargas que se creó para el controlador de entrada de Istio:

  1. Ve a la página de Google Kubernetes Engine en Cloud Console:

    Ir a Google Kubernetes Engine

  2. Haz clic en Ingress y servicios en el panel de navegación izquierdo para ver una lista de servicios.

  3. Si la versión del clúster es 1.15.3-gke.191.14.3-gke.121.13.10-gke.8 o posteriores, desplázate hacia abajo hasta el servicio istio-ingress. Para ver las demás versiones del clúster, desplázate hacia abajo hasta el servicio istio-ingressgateway.

  4. Copia la dirección IP externa que se muestra junto al balanceador de cargas, sin la configuración de puerto, si la hay. Por ejemplo, si la IP es XX.XXX.XX.XXX:15020, omite el :15020. Ignora las otras direcciones IP enumeradas.

  5. Invoca a cURL y asegúrate de reemplazar hello en la string Host por el nombre de tu servicio, si usaste un nombre distinto de hello:

    curl -v -H "Host: hello.default.example.com" YOUR-IP

    Reemplaza YOUR-IP por la dirección IP que obtuviste en el paso anterior.

Realiza una limpieza

Inhabilita Cloud Run for Anthos en Google Cloud

Para inhabilitar Cloud Run for Anthos en Google Cloud en el clúster, haz lo siguiente:

  1. Ve a la página de Google Kubernetes Engine en Cloud Console:

    Ir a Google Kubernetes Engine

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

  3. Haz clic en Editar.

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

  5. Haz clic en Guardar.

Próximos pasos

Para obtener información sobre cómo compilar un contenedor a partir del código fuente, enviarlo a Container Registry y, además, implementarlo, consulta la siguiente página:

Para obtener una descripción general de la arquitectura de Cloud Run for Anthos en Google Cloud en la que se incluyen los cambios de instalar Cloud Run for Anthos como un complemento para el clúster de Google Kubernetes Engine, consulta esta página: