Implantar uma instância do MySQL com o App Lifecycle Manager

Implantar uma instância do MySQL com o App Lifecycle Manager

Saiba como implantar uma instância do Cloud SQL usando o App Lifecycle Manager.

Antes de começar

Faça login na Conta do Google.

Se você ainda não tiver uma, inscreva-se agora.

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, 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

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.

Install the Google Cloud CLI.

Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

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, 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

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.

Install the Google Cloud CLI.

Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

1. Conceda à conta de serviço App Lifecycle Manager as permissões necessárias:

   1. Acesse App Lifecycle Manager > Visão geral Começar.
      

      Acessar "Começar a usar o App Lifecycle Manager"

   2. No banner com a mensagem As permissões necessárias para a conta do App Lifecycle Manager não foram concedidas, clique em Conceder permissões.

Modele sua oferta do Cloud SQL usando um modelo composto

Nesta seção, você vai usar o App Lifecycle Manager para modelar um modelo composto (sql-quickstart-template) que consiste em uma instância do Cloud SQL usando o Application Design Center.

1. No Google Cloud console, acesse App Lifecycle Manager > Oferta de app.

   Acessar "Oferta de app"

2. Clique em Criar.

3. No campo Nome da oferta de app, digite: my-sql-quickstart-saas-offering.

4. No menu suspenso Região, selecione as regiões:

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

   Clique em OK.

5. Clique em Criar. Pode levar alguns minutos para criar my-sql-quickstart-saas-offering.

   A página Detalhes da oferta de app é aberta.

6. Na página Detalhes da oferta de app, clique em Criar modelo.

7. Na página Criar um modelo composto:

   1. Na caixa ID do modelo, insira sql-quickstart-template.

   2. Clique em Criar modelo. O App Lifecycle Manager vai levar alguns minutos para criar o modelo composto.

      Quando o App Lifecycle Manager criar o modelo, os detalhes dele vão aparecer na seção Modelo de aplicativo conectado da página Detalhes da oferta de app.

8. Na seção Modelo de aplicativo conectado, acesse Gerenciar modelo > Configurar na tela.

   O Application Design Center é aberto na janela do Google Cloud console.

9. Na área Componentes, encontre e clique no modelo Cloud SQL (My SQL).

   Um componente Cloud SQL (My SQL) é adicionado à tela.

10. Clique em Continuar > Implantar em grande escala com o App Lifecycle Manager.

    O App Lifecycle Manager é aberto na janela do Google Cloud console.

11. Na seção Modelo de aplicativo conectado, clique em Atualizar revisão do modelo.

12. Na página Atualizar revisão do modelo, selecione r-2 no menu suspenso Revisão.

13. Clique em Atualizar. A seção Modelo de aplicativo conectado mostra Importando modelo de aplicativo.

    Pode levar alguns minutos para o App Lifecycle Manager importar a revisão do modelo. Quando a importação da revisão terminar, a lista de tipos de unidade será preenchida na guia Tipos de unidade.

Provisionar uma instância do Cloud SQL usando o App Lifecycle Manager

Nesta seção, você vai criar e provisionar uma unidade (my-sql-quickstart-unit) com uma instância do Cloud SQL na região us-central1.

1. Na página Detalhes da oferta de app de my-sql-quickstart-saas-offering, clique em Provisionar.

   Uma página Provisionar é aberta.

2. Na página Provisionar, selecione us-central1 no menu suspenso Região.

   Clique em Adicionar para adicionar uma unidade à sua oferta de app.

3. No painel Adicionar unidade para provisionamento:

   1. Na caixa Nome da unidade, digite my-sql-quickstart-unit-1.
   2. No menu suspenso Tipo de unidade, selecione o tipo de unidade sql-quickstart-template.
   3. No menu suspenso Versão, selecione (r-3).
   4. No menu suspenso Conta de serviço, selecione a conta de serviço que você criou na seção Antes de começar.

4. Clique em Adicionar variáveis do projeto de locatário.

   1. Selecione seu projeto para provisionar os recursos.

5. Na seção Outras variáveis de entrada do painel Adicionar unidade para provisionamento:

   1. Clique no menu suspenso sql-my-sql-1_database_version.

      • Na caixa Valor da variável, digite MYSQL_8_0.

      Clique em Concluído.

   2. Clique no menu suspenso sql-my-sql-1_name.

      • Na caixa Valor da variável, digite my-sql-db-1.

      Clique em Concluído.

   3. Clique no menu suspenso sql-my-sql-1_project_id.

      • Na caixa Valor da variável, digite o ID do projeto.

      Clique em Concluído.

   4. Clique no menu suspenso sql-my-sql-1_region.

      • Na caixa Valor da variável, digite us-central1.

      Clique em Concluído.

   Clique em Adicionar. my-sql-quickstart-unit-1 vai aparecer na tabela Unidades a serem provisionadas.

6. Clique em Provisionar para provisionar a my-sql-quickstart-unit-1, que vai criar uma instância do Cloud SQL ativa na sua oferta de app.

   Pode levar alguns minutos para o App Lifecycle Manager provisionar my-sql-quickstart-unit-1.

   Observação: repita esse processo para cada uma das regiões selecionadas ao criar a oferta de app para implantar a instância do Cloud SQL em várias regiões.

Conferir a instância do Cloud SQL implantada

Você usou o App Lifecycle Manager para implantar uma instância do Cloud SQL.

Para conferir a instância do Cloud SQL que você implantou neste guia de início rápido:

1. No Google Cloud console, acesse a página App Lifecycle Manager > Unidades > Detalhes da unidade.

   Acessar "Unidades"

2. Clique no nome da unidade: my-sql-quickstart-unit-1.

3. Na página Detalhes da unidade:

   1. Confira se o Estado é:

      • Pronto se a instância do Cloud SQL estiver provisionada.
      • Provisionando se a operação ainda estiver em andamento.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

Excluir o projeto

Se você implantou a instância do Cloud SQL em um novo Google Cloud projeto e, se não for mais usar o projeto, exclua-o seguindo estas etapas:

**Atenção**: se você excluir um projeto, todos os recursos no projeto serão permanentemente excluídos.

1. No Google Cloud console, acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir.
3. No prompt, digite o ID do projeto e clique em Encerrar.

A seguir

• Para entender melhor o App Lifecycle Manager, consulte Visão geral do App Lifecycle Manager.
• Para começar a usar o App Lifecycle Manager, comece com Criar uma oferta de app.
• Para entender como as contas de serviço são usadas e como conceder as permissões necessárias para essas contas, consulte Contas de serviço do App Lifecycle Manager.
• Para conferir as etapas de atualização da versão, consulte Implementar uma versão.