Crear y desplegar una aplicación web en un contenedor

Aprende a crear una aplicación web en un contenedor con el editor de Cloud Shell, pruébala localmente y, a continuación, despliégala en un clúster de Google Kubernetes Engine (GKE).

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Antes de empezar

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Crear una aplicación web

Usa el editor de Cloud Shell como entorno para crear tu aplicación. El editor ya tiene cargadas las herramientas necesarias para el desarrollo en Cloud.

Para crear tu aplicación, haz lo siguiente:

  1. Abre el editor de Cloud Shell.

  2. Si se te pide que autorices a Cloud Code para que use tus credenciales y haga una llamada a la API de Google Cloud, haz clic en Autorizar.

  3. Abre el menú Cloud Code desde la barra de estado.

  4. Selecciona Nueva aplicación.

  5. Selecciona Aplicación de Kubernetes como tipo de aplicación de ejemplo.

  6. En la lista de aplicaciones de ejemplo de Kubernetes, selecciona Go:Hello World (Go:Hola, mundo).

  7. Selecciona la carpeta donde se ubicará tu aplicación y haz clic en Crear aplicación.

El editor de Cloud Shell carga la aplicación en un nuevo espacio de trabajo. Una vez que se vuelva a cargar, podrás acceder a tu aplicación desde la vista del explorador.

Probar una aplicación en un clúster local

Ahora que has creado tu aplicación, puedes ejecutarla en un clúster local de Kubernetes en Cloud Shell:

  1. Para abrir una terminal de Cloud Shell, haz clic en Terminal > Nueva terminal.

  2. Para iniciar tu clúster minikube local, en el símbolo del sistema del terminal, ejecuta el siguiente comando:

    minikube start

    Puede que tarde un minuto en configurarse el clúster de minikube.

  3. Si se te pide que autorices a Cloud Shell para que pueda hacer llamadas a la API de Cloud, haz clic en Autorizar.

    Una vez que hayas configurado el clúster, aparecerá un mensaje similar al siguiente:

    Done! kubectl is now configured to
use "minikube" cluster...

Una vez configurado el clúster local, compila y ejecuta esta aplicación:

  1. Abre el menú de Cloud Code desde la barra de estado.
  2. Selecciona Ejecutar en Kubernetes.

  3. Si se te pide, confirma que quieres usar el contexto de minikube actual.

    Este proceso tarda unos minutos y puedes ver el estado del despliegue en la vista Sesiones de desarrollo.

    Al hacer clic en los distintos nodos de la vista Sesiones de desarrollo, se muestran fragmentos de registro relacionados con la fase de implementación seleccionada.

  4. Una vez que se haya compilado y desplegado tu aplicación, busca el nodo de reenvío de puertos de tu servicio. En la vista Sesiones de desarrollo, expande URLs de reenvío de puertos > servicio > go-hello-world-external.

  5. Para iniciar la aplicación, coloca el puntero sobre go-hello-world-external y, a continuación, haz clic en Abrir URL.

Editar una aplicación

Para entender los componentes de la aplicación Hello World, consulta el diagrama del archivo readme.md de la aplicación. A grandes rasgos, la aplicación consta de lo siguiente:

  • Una aplicación web go-hello-world básica, main.go, que devuelve una respuesta con plantilla "It's running!" a todas las solicitudes que recibe.
  • Un servicio de balanceador de carga go-hello-world-external, hello.service.yaml, que expone la aplicación describiendo un servicio de Kubernetes.

Para modificar la aplicación, sigue estos pasos:

  1. Modifica el archivo main.go para que imprima "Se ha vuelto a desplegar". El archivo se guarda automáticamente.

  2. Espera un minuto a que tu aplicación termine de compilarse y desplegarse, y monitoriza su progreso mientras se vuelve a compilar en la vista Sesiones de desarrollo.

  3. Una vez que la aplicación se haya compilado y desplegado, busca el nodo de reenvío de puertos de tu servicio: Sesiones de desarrollo > URLs de reenvío de puertos > servicio > go-hello-world-external.

  4. Para iniciar la aplicación, coloca el puntero sobre go-hello-world-external y haz clic en Abrir URL.

Ver registros de aplicaciones

Para analizar tu aplicación mientras se ejecuta, usa el visualizador de registros para monitorizar sus registros:

  1. Para abrir el visualizador de registros, abre la paleta de comandos (a la que se puede acceder mediante Ctrl/Cmd+Shift+P o Ver > Paleta de comandos) y, a continuación, ejecuta Cloud Code: View Logs (Cloud Code: Ver registros).

    En esta vista, puedes filtrar los registros de tu aplicación y desplazarte por ellos.

  2. Especifica los filtros de Despliegue para ver los registros de tu aplicación, go-hello-world.

  3. Cambia a la pestaña de tu aplicación que muestra el mensaje "Se ha vuelto a desplegar". Vuelve a cargar la página en el navegador y, a continuación, vuelve a la pestaña de Cloud Shell.

  4. Para ver los registros recién generados en el visor de registros, haz clic en Actualizar.

Crear un clúster de Google Kubernetes Engine

Para crear un clúster de Google Kubernetes Engine en el que desplegar tu aplicación, sigue estos pasos:

  1. Haz clic en Icono de Cloud Code Cloud Code y, a continuación, despliega la sección Kubernetes.

  2. Haz clic en Añadir un clúster a KubeConfig y, a continuación, en Google Kubernetes Engine en el menú Selección rápida.

  3. Cuando se te pida que habilites container.googleapis.com, haz clic en Sí.

  4. Haz clic en + Crear un clúster de GKE.

  5. Elige Estándar como tipo de clúster.

  6. Haz clic en Abrir para permitir que Cloud Shell abra la consolaGoogle Cloud .

  7. En la consola de Google Cloud , usa el proyecto que has creado, define la zona como us-central1-a y asigna el nombre my-first-cluster al clúster.

  8. Haz clic en Crear. La creación del clúster tarda unos minutos.

  9. Una vez creado el clúster, en el menú Selección rápida, haga clic en Actualizar la vista del clúster de Kubernetes Actualizar.

  10. Cuando aparezca el nombre del nuevo clúster en la lista, haz clic en él. El nuevo clúster se añade a la configuración y se configura como contexto activo.

Desplegar una aplicación en un clúster de GKE

Para desplegar tu aplicación en el nuevo clúster, sigue estos pasos:

  1. En el menú Cloud Code, al que se accede desde la barra de estado, selecciona Ejecutar en Kubernetes.

  2. Confirma que el clúster que has creado es el contexto de tu aplicación.

  3. Confirma la opción predeterminada de tu registro de imágenes.

  4. Espera un minuto a que tu aplicación termine de compilarse y desplegarse, y monitoriza su progreso mientras se vuelve a compilar en la vista Sesiones de desarrollo.

  5. Una vez que se haya compilado y desplegado tu aplicación, busca el nodo de reenvío de puertos de tu servicio. En la vista Sesiones de desarrollo, expande URLs de reenvío de puertos > servicio > go-hello-world-external.

  6. Para iniciar la aplicación, mantén el puntero sobre go-hello-world-external y haz clic en Abrir URL.

Eliminar los recursos utilizados

Para eliminar solo el clúster que has creado para esta guía de inicio rápido, haz lo siguiente:

  1. Coloca el cursor sobre el nombre del clúster y haz clic en Icono de abrir en la consola Google Cloud Abrir en la Google Cloud consola.
  2. Haz clic en Eliminar y, a continuación, en Eliminar.

Para eliminar tu proyecto (y los recursos asociados, incluidos los clústeres), sigue estos pasos:

  1. Ve a la página Proyectos de la Google Cloud consola:

    Ir a la página Proyectos

  2. Selecciona el proyecto que has creado para esta guía de inicio rápido y haz clic en Eliminar.

  3. Escribe el ID del proyecto para confirmar la acción y, a continuación, haz clic en Cerrar.

    De esta forma, se cierra el proyecto y se programa su eliminación.

Siguientes pasos