Implementa una instancia de MySQL con App Lifecycle Manager

Implementa una instancia de MySQL con App Lifecycle Manager

Aprende a implementar una instancia de Cloud SQL con App Lifecycle Manager.

Antes de comenzar

Accede a tu Cuenta de Google.

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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the App Lifecycle Manager, Artifact Registry, Cloud Build, Cloud Storage, Developer Connect, Infrastructure Manager, Design Center, App Hub, Cloud Resource Manager, Identity and Access Management, Cloud Asset Inventory, Cloud Monitoring, Cloud Logging, and Service Health APIs.

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

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.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
7. Click Continue.

8. Click Done to finish creating the service account.

Instala Google Cloud CLI.

Nota: Si ya instalaste gcloud CLI, ejecuta gcloud components update para asegurarte de tener la versión más reciente.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the App Lifecycle Manager, Artifact Registry, Cloud Build, Cloud Storage, Developer Connect, Infrastructure Manager, Design Center, App Hub, Cloud Resource Manager, Identity and Access Management, Cloud Asset Inventory, Cloud Monitoring, Cloud Logging, and Service Health APIs.

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

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.

   Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles. Instead, grant a predefined role or custom role that meets your needs.
7. Click Continue.

8. Click Done to finish creating the service account.

Instala Google Cloud CLI.

Nota: Si ya instalaste gcloud CLI, ejecuta gcloud components update para asegurarte de tener la versión más reciente.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

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

   1. Navega a App Lifecycle Manager > Overview Get started.
      

      Ir a Comienza a usar App Lifecycle Manager

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

Crea un modelo de tu oferta de Cloud SQL con una plantilla compuesta

En esta sección, usarás App Lifecycle Manager para modelar una plantilla compuesta (sql-quickstart-template) que consta de una instancia de Cloud SQL con App Design Center.

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, escribe my-sql-quickstart-saas-offering.

4. En el menú desplegable Región, selecciona las siguientes regiones:

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

   Haz clic en Aceptar.

5. Haz clic en Crear. La creación de my-sql-quickstart-saas-offering puede tardar unos minutos.

   Se abrirá la página Detalles de la oferta de SaaS.

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

7. En la página Crea una nueva plantilla compuesta, haz lo siguiente:

   1. En el cuadro ID de plantilla, ingresa sql-quickstart-template.

   2. Haz clic en Crear Plantilla. App Lifecycle Manager tardará unos minutos en crear la plantilla compuesta.

      Cuando App Lifecycle Manager haya creado la plantilla correctamente, verás sus detalles en la sección Plantilla de aplicación conectada de la página Detalles de la oferta de SaaS.

8. En la sección Connected application template, ve a Manage template > Configure in canvas.

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

9. En el área Components, busca y haz clic en la plantilla Cloud SQL (My SQL).

   Se agrega un componente de Cloud SQL (MySQL) al lienzo.

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

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

11. En la sección Connected application template, haz clic en Update template revision.

12. En la página Update template revision, selecciona r-2 en el menú desplegable Revision.

13. Haz clic en Actualizar. En la sección Connected application template, se muestra Importing Application Template.

    Es posible que App Lifecycle Manager tarde unos minutos en importar la revisión de la plantilla. Cuando finalice la importación de la revisión, verás la lista de tipos de unidades propagada en la pestaña Tipos de unidades.

Aprovisiona una instancia de Cloud SQL con App Lifecycle Manager

En esta sección, crearás y aprovisionarás una unidad (my-sql-quickstart-unit) con una instancia de Cloud SQL en la región us-central1.

1. En la página Detalles de la oferta de SaaS de my-sql-quickstart-saas-offering, haz clic en Aprovisionar.

   Se abrirá una página de Provision.

2. En la página Provision, selecciona us-central1 en el menú desplegable Region.

   Haz clic en Agregar para agregar una unidad a tu oferta de SaaS.

3. En el panel Agregar unidad para aprovisionar, haz lo siguiente:

   1. En el cuadro Nombre de la unidad, escribe my-sql-quickstart-unit-1.
   2. En el menú desplegable Tipo de unidad, selecciona el tipo de unidad sql-quickstart-template.
   3. En el menú desplegable Release, selecciona (r-3).
   4. En el menú desplegable Cuenta de servicio, selecciona la cuenta de servicio que creaste en la sección Antes de comenzar.

4. Haz clic en Agregar variables del proyecto de usuario.

   1. Selecciona tu proyecto para aprovisionar tus recursos.

5. En la sección Otras variables de entrada del panel Agregar unidad para aprovisionar, haz lo siguiente:

   1. Haz clic en el menú desplegable sql-my-sql-1_database_version.

      • En el cuadro Valor de variable, escribe MYSQL_8_0.

      Haz clic en Listo.

   2. Haz clic en el menú desplegable sql-my-sql-1_name.

      • En el cuadro Valor de variable, escribe my-sql-db-1.

      Haz clic en Listo.

   3. Haz clic en el menú desplegable sql-my-sql-1_project_id.

      • En el cuadro Valor de la variable, escribe el ID de tu proyecto.

      Haz clic en Listo.

   4. Haz clic en el menú desplegable sql-my-sql-1_region.

      • En el cuadro Valor de variable, escribe us-central1.

      Haz clic en Listo.

   Haz clic en Agregar. Verás my-sql-quickstart-unit-1 en la tabla Unidades que se aprovisionarán.

6. Haz clic en Provision para aprovisionar el my-sql-quickstart-unit-1, que creará una instancia activa de Cloud SQL en tu oferta de SaaS.

   Es posible que el Administrador del ciclo de vida de la app tarde unos minutos en aprovisionar my-sql-quickstart-unit-1.

   Nota: Puedes repetir este proceso para cada una de las regiones que seleccionaste cuando creaste la oferta de SaaS para implementar la instancia de Cloud SQL en varias regiones.

Visualiza la instancia de Cloud SQL implementada

Ahora usaste App Lifecycle Manager para implementar una instancia de Cloud SQL.

Para ver la instancia de Cloud SQL que implementaste en esta guía de inicio rápido, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página App Lifecycle Manager > Units > Unit details.

   Ir a Unidades

2. Haz clic en el nombre de tu unidad: my-sql-quickstart-unit-1.

3. En la página Detalles de la unidad, haz lo siguiente:

   1. Comprueba que el Estado sea el siguiente:

      • Ready si se aprovisionó la instancia de Cloud SQL.
      • Provisioning si la operació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 la instancia de Cloud SQL en un proyecto Google Cloud nuevo y ya no lo necesitas, sigue estos pasos para borrarlo:

Precaución: Si borras un proyecto, todos los recursos del proyecto se borrarán de forma permanente.

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?

• Para obtener más información sobre App Lifecycle Manager, consulta la descripción general de App Lifecycle Manager.
• Para comenzar a usar App Lifecycle Manager, comienza con Create a SaaS offering.
• Para comprender cómo se usan las cuentas de servicio y cómo otorgar los permisos necesarios para estas cuentas, consulta Cuentas de servicio de App Lifecycle Manager.
• Para conocer los pasos para actualizar la versión, consulta Lanza una versión.