Gerir ciclos de vida dos serviços

Esta página descreve como gerir os ciclos de vida dos serviços geridos através dos comandos da Google Cloud CLI gcloud endpoints services.

Para exemplos de utilização avançados, pode usar a API Service Management para gerir serviços de forma programática. Para mais informações, consulte o artigo Introdução à API Service Management

Introdução

Um serviço gerido é um recurso simples que representa logicamente um serviço integrado com a infraestrutura de serviços, como a API Gmail e a API Spanner. Um serviço gerido em si mesmo tem apenas duas propriedades imutáveis, um nome do serviço e um projeto produtor, mas a implementação de um serviço gerido pode oferecer uma vasta gama de funcionalidades. Por exemplo, a API Cloud Storage oferece armazenamento de objetos à escala planetária para milhões de programadores e empresas.

Um serviço gerido tem um conjunto de consumidores de serviços, um histórico de configurações de serviços imutáveis e um histórico de implementações de serviços> imutáveis. As configurações de serviço referenciadas pela implementação de serviço mais recente representam o estado atual do serviço, que abrange todos os aspetos do serviço, desde o nome a apresentar às definições de métricas e aos limites de taxa. Para ver a especificação, consulte google.api.Service.

Nesta página, descrevemos como criar e gerir os ciclos de vida dos seus serviços. Para mais informações sobre a gestão de serviços, consulte os guias de instruções.

Criar um serviço

Para criar um serviço, tem de concluir os seguintes passos.

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

  2. Crie um projeto de produtor dedicado para alojar o seu serviço. Um projeto dedicado oferece a melhor segurança e isolamento para o seu serviço. Também lhe permite transferir a propriedade do seu serviço para outra equipa ou até mesmo outra empresa.

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

  4. Ative o Cloud Billing para o seu projeto. Para integrar o seu serviço com a infraestrutura de serviços, vai 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 ficheiro YAML de configuração de serviço simples para o seu serviço da seguinte forma:

    # 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 o seu serviço implementando uma configuração de serviço em branco:

    gcloud endpoints services deploy endpointsapis.yaml

O processo de criação do serviço demora cerca de um minuto. Depois disso, deve conseguir ver o seu serviço listado na página Endpoints na Google Cloud Console.

Serviços de fichas

Para listar os serviços num projeto, pode usar o seguinte comando:

gcloud endpoints services list --project endpointsapis

Descrever um serviço

Para descrever um serviço e a respetiva configuração, pode usar o seguinte comando:

gcloud endpoints services describe endpointsapis.appspot.com

Eliminar um serviço

Se já não precisar de um serviço, pode eliminá-lo através do seguinte comando:

gcloud endpoints services delete endpointsapis.appspot.com

NOTA: todos os serviços têm um período de retenção de eliminação obrigatório de 30 dias.

Anular a eliminação de um serviço

Pode anular a eliminação de um serviço dentro do respetivo período de retenção através do seguinte comando:

gcloud endpoints services undelete endpointsapis.appspot.com

Passos seguintes

A API Service Management usa um modelo declarativo para a gestão de serviços. Depois de criar o serviço, tem de enviar configurações de serviço imutáveis e implementações de serviço para alcançar o estado pretendido do serviço. As configurações do seu serviço são usadas para configurar os serviços de infraestrutura do Google Cloud de modo a suportar o seu serviço, incluindo o Cloud Billing, o Cloud Logging, o Cloud Monitoring e a gestão de identidade e acesso.

Para mais informações sobre as configurações de serviços, consulte o artigo Gerir configurações de serviços. Para mais informações sobre implementações de serviços, consulte o artigo Gerir implementações de serviços.