Implementa una aplicación con App Lifecycle Manager

App Lifecycle Manager te permite automatizar la implementación y la administración del ciclo de vida de las aplicaciones de varios componentes, lo que te ayuda a aprovisionar entornos coherentes en Google Cloud. En esta guía de inicio rápido, modelarás una plantilla de aplicación compuesta con Cloud Run y Cloud Storage en Application Design Center y, luego, aprovisionarás una unidad activa.

Antes de comenzar

  1. In the Google Cloud console, on the project selector page, 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the App Lifecycle Manager, Artifact Registry, Cloud Build, Cloud Run, Cloud Storage, Developer Connect, Infrastructure Manager, App Design Center, App Hub, Resource Manager, Identity and Access Management, Cloud Asset Inventory, Cloud Monitoring, Cloud Logging, and Service Health APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. Create a service account:

    1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

    2. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    3. Select your project.

    4. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    5. Click Create and continue.

    6. Grant the Project > Owner role to the service account.

      To grant the role, find the Select a role list, then select Project > Owner.

    7. Click Continue.

    8. Click Done to finish creating the service account.

  5. Otorga los permisos necesarios a la cuenta de servicio de App Lifecycle Manager:

    1. En la consola de Google Cloud , ve a Administrador del ciclo de vida de la app > Descripción general > Comenzar.

      Ir a Comienza a usar App Lifecycle Manager

    2. Si aparece el banner con el mensaje No se otorgaron los permisos necesarios para la cuenta de App Lifecycle Manager, haz clic en Otorgar permisos.

Modelar tu oferta con una plantilla compuesta

Usa App Lifecycle Manager y Application Design Center para modelar una plantilla compuesta (run-storage-quickstart) que conecte un servicio de Cloud Run con un bucket de Cloud Storage.

Configura tu oferta de SaaS

  1. En la consola de Google Cloud , ve a App Lifecycle Manager > Oferta de SaaS.

    Ir a la oferta de SaaS

  2. Haz clic en Crear.

  3. En el campo Nombre de la oferta de SaaS, ingresa run-storage-quickstart-offering.

  4. En la lista Región, selecciona las siguientes regiones y, luego, haz clic en Aceptar:

    • us-central1
    • us-east1
    • us-east5

  5. Haz clic en Crear. La creación de run-storage-quickstart-offering tarda unos minutos.

    Cuando se crea la oferta de SaaS, se abre la página Detalles de la oferta de SaaS.

Crea una plantilla compuesta

  1. En la página Detalles de la oferta de SaaS, haz clic en Crear plantilla nueva.

  2. En la página Crea una nueva plantilla compuesta, configura la plantilla:

    1. En el campo ID de plantilla, ingresa run-storage-quickstart.

    2. Haz clic en Crear Plantilla.

      Cuando App Lifecycle Manager termine de crear la plantilla compuesta, sus detalles aparecerán en la sección Plantilla de aplicación conectada de la página Detalles de la oferta de SaaS.

  3. En la sección Plantilla de aplicación conectada, haz clic en Administrar plantilla y, luego, en Configurar en el lienzo.

    Se abrirá App Design Center en la consola de Google Cloud .

  4. En el área Componentes, agrega los siguientes componentes al lienzo de diseño:

    1. Haz clic en Cloud Run (Service) para agregar un componente de cloud-run-1 al lienzo.
    2. Haz clic en Cloud Storage para agregar un componente cloud-storage-1 al lienzo.

  5. En el lienzo, arrastra desde el componente cloud-run-1 hasta el componente cloud-storage-1 para crear una conexión.

    Cuando se conectan los componentes, se pasa la cuenta de servicio de Cloud Run a la vinculación de IAM del bucket de Cloud Storage con el rol roles/storage.objectAdmin.

  6. En el lienzo, haz clic en el componente cloud-run-1 para abrir el panel Configuración:

    1. En el área Contenedores, expande Contenedor 1.
    2. En el campo Imagen de contenedor, ingresa la imagen de contenedor de muestra pública us-docker.pkg.dev/cloudrun/container/hello:latest.
    3. Haz clic en Guardar.

  7. Haz clic en Continuar > Realizar implementaciones a gran escala con App Lifecycle Manager.

    App Lifecycle Manager se abrirá en la consola de Google Cloud .

  8. En la sección Plantilla de aplicación conectada, haz clic en Actualizar revisión de plantilla.

  9. En la página Actualizar revisión de plantilla, selecciona r-2 en la lista Revisión y, luego, haz clic en Actualizar.

    En la sección Plantilla de aplicación conectada, se muestra Importando plantilla de aplicación. Cuando finalice la importación, en la pestaña Tipos de unidades, se mostrará el tipo de unidad u-native-components generado.

Aprovisiona la aplicación con App Lifecycle Manager

  1. En la página Detalles de la oferta de SaaS de run-storage-quickstart-offering, haz clic en Aprovisionar.

    Se abrirá la página Aprovisionar.

  2. En la página Aprovisionar, selecciona us-central1 en la lista Región y, luego, haz clic en Agregar.

  3. En el panel Agregar unidad para aprovisionar, configura la unidad:

    1. En el campo Nombre de la unidad, ingresa run-storage-quickstart-unit-1.
    2. En la lista Tipo de unidad, selecciona el tipo de unidad u-native-components.
    3. En la lista Versión, selecciona la versión generada para la revisión de tu plantilla.
    4. En la lista Cuenta de servicio, selecciona la cuenta de servicio de ejecución de acciones que creaste en la sección Antes de comenzar.

  4. Haz clic en Agregar variables del proyecto de usuario y, luego, selecciona tu proyecto, que se usará para aprovisionar los recursos.

  5. En el área Otras variables de entrada, haz clic en Agregar variable de entrada y, luego, ingresa los valores para las siguientes variables de entrada del componente:

    • Nombre: cloud-run-1_project_id, Tipo de variable: String y Valor de la variable: el ID de tu proyecto
    • Nombre: cloud-run-1_location, Tipo de variable: String y Valor de la variable: us-central1
    • Nombre: cloud-run-1_service_name, Tipo de variable: String y Valor de la variable: quickstart-web
    • Nombre: cloud-storage-1_project_id, Tipo de variable: String y Valor de la variable: el ID de tu proyecto
    • Nombre: cloud-storage-1_location, Tipo de variable: String y Valor de la variable: us-central1
    • Nombre: cloud-storage-1_name, Tipo de variable: String y Valor de la variable: un nombre de bucket único a nivel global, como PROJECT_ID-quickstart-bkt

  6. Haz clic en Agregar. La unidad run-storage-quickstart-unit-1 aparece en la tabla Unidades que se aprovisionarán.

  7. Haz clic en Aprovisionar para implementar run-storage-quickstart-unit-1.

    El servicio de Cloud Run y Cloud Storage se aprovisionan después de unos minutos.

  8. Para aprovisionar unidades adicionales en otras regiones, selecciona la región de la lista Región y, luego, haz clic en Agregar.

Visualiza la unidad implementada

Verifica que App Lifecycle Manager haya aprovisionado tu unidad y sus recursos.

  1. En la consola de Google Cloud , ve a la página Administrador del ciclo de vida de la app > Unidades.

    Ir a Unidades

  2. Haz clic en run-storage-quickstart-unit-1 para abrir la página Detalles de la unidad.

  3. En la página Detalles de la unidad, verifica el campo Estado:

    • Listo: Se aprovisionan el servicio de Cloud Run y el bucket de Cloud Storage.
    • Aprovisionamiento: La operación de implementación aún está en curso.

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Borra el proyecto

Si implementaste los recursos de la aplicación en un proyecto de Google Cloud nuevo y ya no lo necesitas, sigue estos pasos para borrarlo:

  1. En la Google Cloud consola, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
  3. Cuando se te solicite, escribe el ID del proyecto y, luego, haz clic en Cerrar.

¿Qué sigue?