Nesta página, descrevemos como gerenciar os ciclos de vida
serviços gerenciados usando a Google Cloud CLI
gcloud endpoints services
comandos
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.
Instalar e inicializar gcloud CLI nas computador.
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.
Ative a API Service Management e a API Service Control para seu projeto.
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.
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
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ê deve estar ver seu 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.