Como gerenciar ciclos de vida de serviço

Esta página descreve como gerenciar os ciclos de vida dos serviços gerenciados usando os comandos gcloud endpoints services da Google Cloud CLI.

Para casos de uso avançados, use a API Service Management para gerenciar serviços de maneira programática. Para mais informações, consulte Primeiros passos com a API Service Management

Introdução

Um serviço gerenciado é um recurso simples que representa logicamente um serviço integrado à infraestrutura de serviços, como a API Gmail e a API Spanner. Um serviço gerenciado tem apenas duas propriedades imutáveis, um nome de serviço e um projeto de produtor. No entanto, a implementação de um serviço gerenciado pode fornecer uma ampla variedade de funcionalidades. Por exemplo, a API Cloud Storage fornece armazenamento de objetos em escala global para milhões de desenvolvedores e empresas.

Um serviço gerenciado tem um conjunto de consumidores de serviço, um histórico de configurações de serviço imutáveis e um histórico de implementações de serviço imutáveis. As configurações de serviço referenciadas pela versão mais recente do serviço representam o estado atual do serviço, que abrange todos os aspectos do serviço, desde o nome de exibição até as definições de métricas e as limitações de taxa. Para ver a especificação, consulte google.api.Service.

Descrevemos como criar e gerenciar os ciclos de vida do serviço nesta página. Para mais informações sobre o gerenciamento de serviços, consulte os Guias de instruções.

Como criar um serviço

Para criar um serviço, você precisa concluir as etapas a seguir.

1. Instale e inicialize a CLI gcloud no seu computador.

2. Crie um projeto de produtor dedicado para hospedar o serviço. Um projeto dedicado fornece a melhor segurança e isolamento para seu serviço. Isso também permite transferir a propriedade do serviço para outra equipe ou até mesmo para outra empresa.

3. Ative a API Service Management e a API Service Control para seu projeto.

4. Ative o Faturamento do Cloud para seu projeto. Para integrar seu serviço à infraestrutura de serviços, você dependerá de vários produtos pagos do Google Cloud, incluindo a API Service Control, a API Cloud Logging e a API Cloud Monitoring.

5. Prepare um arquivo yaml simples de configuração de serviço para o serviço da seguinte maneira:

   # Filename: endpointsapis.yaml
   type: google.api.Service
   config_version: 3
   # Update the next line to use your own service name.
   name: endpointsapis.appspot.com
   # Update the next line to use your own producer project id.
   producer_project_id: endpointsapis
   

6. Execute o comando gcloud para criar seu serviço com a implantação de uma configuração de serviço em branco:

   gcloud endpoints services deploy endpointsapis.yaml
   

O processo de criação do serviço leva cerca de um minuto. Depois disso, você vai encontrar o serviço listado na página Endpoints no Console do Google Cloud.

Como listar serviços

Para listar serviços em um projeto, use o seguinte comando:

gcloud endpoints services list --project endpointsapis

Como descrever um serviço

Para descrever um serviço e a configuração dele, use o seguinte comando:

gcloud endpoints services describe endpointsapis.appspot.com

Exclusão de um serviço

Se você não precisar mais de um serviço, exclua-o usando o seguinte comando:

gcloud endpoints services delete endpointsapis.appspot.com

OBSERVAÇÃO: cada serviço tem uma retenção obrigatória de exclusão de 30 dias.

Cancelamento da exclusão de um serviço

É possível cancelar a exclusão de um serviço dentro da janela de retenção usando o seguinte comando:

gcloud endpoints services undelete endpointsapis.appspot.com

A seguir

A API Service Management usa um modelo declarativo para o gerenciamento de serviços. Depois que o serviço é criado, você precisa enviar configurações de serviço imutáveis e implementações de serviços para alcançar o estado desejado do serviço. Suas configurações de serviço são usadas para configurar os serviços de infraestrutura do Google Cloud e oferecer suporte ao seu serviço, incluindo o Cloud Billing, Cloud Logging, Cloud Monitoring e Gerenciamento de identidade e acesso.

Para mais informações sobre configurações de serviço, consulte Como gerenciar configurações de serviço. Para mais informações sobre distribuições de serviço, consulte Como gerenciar lançamentos de serviço.