Guía de inicio rápido para automatizar implementaciones de App Engine con Cloud Build

En este tema, se describe cómo implementar automáticamente una aplicación almacenada en Cloud Source Repositories en App Engine cuando hay una confirmación nueva.

Antes de comenzar

  1. Completa los pasos de la Guía de inicio rápido para crear un repositorio.

    Después de completar la guía rápido, tendrás una aplicación que puedes implementar en App Engine.

  2. Habilita las siguientes API:

Otorga acceso de App Engine a la cuenta de servicio Cloud Build

Cloud Build usa una cuenta de servicio para implementar tu código. Los permisos predeterminados para esta cuenta no permiten ciertas acciones, como la implementación en App Engine.

Puedes habilitar tu cuenta de servicio para implementarla en App Engine y otorgarle funciones de IAM adicionales a la cuenta de servicio de Cloud Build.

Sigue los pasos a continuación para otorgarle acceso a App Engine a la cuenta de servicio de Cloud Build:

  1. Abre la página IAM en la consola.

    Abrir la página IAM

  2. Selecciona tu proyecto y haz clic en Continuar.

  3. En la lista de miembros, busca tu cuenta de servicio de Cloud Build llamada [PROJECT_NUMBER]@cloudbuild.gserviceaccount.com, en la que [PROJECT_NUMBER] es tu número de proyecto del proyecto de GCP.

  4. Haz clic en el ícono de lápiz en esa fila.

  5. Haz clic en Agregar otra función.

  6. En el menú desplegable Selecciona una función, selecciona App Engine y luego Administrador de App Engine.

  7. Haz clic en Guardar.

Implementa tu aplicación

  1. Desde una ventana de terminal, navega al directorio que contiene el repositorio.

    cd hello-world
    
  2. Implementa la aplicación de muestra.

    gcloud app deploy app.yaml
    
  3. Verifica que tu aplicación esté en ejecución.

    gcloud app browse
    

    La ventana del navegador ahora debería decir:

    Hello world!
    

Crea un archivo cloudbuild.yaml

  1. Desde una ventana de terminal, navega al directorio que contiene el repositorio.

    cd hello-world
    
  2. Con un editor de texto, crea un archivo llamado cloudbuild.yaml y pega lo siguiente:

    steps:
    - name: "gcr.io/cloud-builders/gcloud"
      args: ["app", "deploy"]
    timeout: "1600s"
    

Agrega el archivo cloudbuild.yaml a tu repositorio

  1. Agrega el archivo al repositorio.

    git add .
    
  2. Confirma el archivo.

    git commit -m "Add cloudbuild.yaml file"
    
  3. Agrega el contenido del repositorio de Git local a Cloud Source Repositories con el comando de git push:

    git push origin master
    

Crea un activador de compilación

  1. Abre la página Cloud Build en Google Cloud Platform Console.

    Abrir la página Cloud Build

  2. Selecciona tu proyecto y haz clic en Abrir.

  3. Haz clic en Crear activador.

  4. Selecciona Cloud Source Repository.

  5. De la lista de repositorios disponibles, selecciona el repositorio hello-world y haz clic en Continuar.

  6. En el cuadro Nombre, escribe el siguiente:

    App Engine Test
    
  7. En Tipo de activador, selecciona Rama.

  8. En Crear configuración, selecciona cloudbuild.yaml.

  9. En el cuadro de ubicación cloudbuild.yaml, escribe lo siguiente:

    /cloudbuild.yaml
    
  10. Haz clic en Crear activador.

Envía un cambio a tu aplicación

  1. Desde una ventana de terminal, usa un editor de texto a fin de actualizar el archivo main.py para que se lea de la siguiente manera:

    #!/usr/bin/env python
    
    import webapp2
    
    class MainHandler(webapp2.RequestHandler):
        def get(self):
    self.response.write('I update automatically!')
    
    app = webapp2.WSGIApplication([
        ('/', MainHandler)
    ], debug=True)
    
  2. Agrega el archivo a Git.

    git add .
    
  3. Confirma el archivo.

    git commit -m "Update app to demonstrate build triggers"
    
  4. Agrega el contenido del repositorio de Git local a Cloud Source Repositories con el comando de git push:

    git push origin master
    

Consulta tu compilación en progreso

  1. Abre la página de activadores de compilación en Google Cloud Platform Console.

    Abrir la página de activadores de compilación

  2. Selecciona tu proyecto y haz clic en Abrir.

  3. En el panel de navegación izquierdo, haz clic en Historial de compilación.

Se abrirá una lista de todas las compilaciones. En la parte superior hay una entrada nueva que representa la compilación que comenzó después de que enviaras tu cambio a Cloud Source Repositories. Cuando la compilación está lista, aparece una marca de verificación verde junto a la entrada de compilación.

Vuelve a probar tu aplicación

Desde una ventana de terminal, abre tu aplicación:

gcloud app browse

En la ventana del navegador ahora se lee lo siguiente:

I update automatically!

Limpieza

Para evitar que se generen cargos en tu cuenta de GCP por los recursos que usaste en esta guía de inicio rápido, sigue estos pasos:

Borra el activador de compilación

  1. Abre la página de activadores de compilación en Google Cloud Platform Console.

    Abrir la página de activadores de compilación

  2. Selecciona tu proyecto y haz clic en Abrir.

  3. Ubica el activador que creaste.

  4. Haz clic en el botón Más Botón Más que está junto al activador que deseas borrar.

  5. Selecciona Borrar.

Borra el repositorio:

  1. Abre la vista de todos los repositorios de Cloud Source Repositories:

    Abrir Cloud Source Repositories

  2. Desplaza el cursor sobre el repositorio y haz clic en el botón de ajustes.

    Se abrirá la pantalla de configuración general.

  3. Haz clic en Borrar este repositorio.

    Se abrirá la pantalla quitar repositorio.

  4. Escribe el nombre del repositorio que deseas borrar.

  5. Haz clic en Borrar.

Pasos siguientes

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Cloud Source Repositories