Como gerenciar serviços

Nesta página, descrevemos a criação de um serviço e a visualização de informações sobre ele. Os serviços são os principais recursos do Cloud Run. Cada serviço tem um URL exclusivo e permanente que não mudará ao longo do tempo à medida que você implantar novas revisões nele.

O domínio permanente do serviço consiste no nome do serviço e em um hash.

Como criar um serviço

Você cria um novo serviço por meio da implantação de uma imagem de contêiner para ele pela primeira vez. A implantação de um novo serviço tem mais instruções.

Como ver a lista de serviços no projeto

É possível ver uma lista dos serviços disponíveis no projeto usando o Console do Cloud ou a linha de comando gcloud:

Console

Para visualizar a lista de serviços, realize as etapas a seguir:

  1. Acessar o Cloud Run

  2. Examine a lista de serviços exibidos para seu projeto:

    lista de serviços

Linha de comando

Para listar os serviços no projeto, use este código:

gcloud run services list

Observe que cada serviço tem um URL associado.

É possível filtrar essa lista por propriedades da definição de serviço, como um rótulo atribuído.

Cloud Code

Para ver a lista de serviços com o Cloud Code, leia os guias do explorador do Cloud Run para IntelliJ e Visual Studio Code.

Como copiar um serviço

É possível fazer uma cópia de um serviço atual usando o Console do Cloud ou o YAML. Você pode alterar o que quiser na cópia, incluindo o nome e a região.

Console

Para copiar um serviço:

  1. Acessar o Cloud Run

  2. Selecione o serviço a ser copiado na lista exibida de serviços do seu projeto:

    lista de serviços

    1. Clique em Copiar.

    2. Na página de cópia do serviço, defina ou altere os valores que você quer alterar, como região etc. Se você mantiver a mesma região, forneça um novo nome para o serviço.

    3. Clique em Criar para fazer uma cópia e implantá-la usando o novo nome de serviço.

YAML

É possível fazer o download e ver a configuração do serviço atual usando o comando gcloud run services describe --format export, que produz resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run services replace. Modifique os campos somente conforme documentado.

  1. Para ver e fazer o download da configuração:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Faça as alterações de configuração desejadas no serviço, conforme descrito nas várias páginas de configuração.

     apiVersion: serving.knative.dev/v1
     kind: Service
     metadata:
       annotations:
         ...
       name: SERVICE
       ...
     spec:
       template:
         metadata:
           annotations:
           ...
           name: REVISION-NAME
    
    • Se você não for implantar a cópia em uma região diferente, substitua SERVICE pelo nome que você quer usar para a cópia. Se você for implantar a cópia em uma região diferente, poderá usar o nome antigo.
    • Certifique-se de que o valor de REVISION-NAME comece com o nome do serviço (SERVICE). Por exemplo, se o novo nome de serviço for mynewfoo, o nome da revisão precisará estar no formato mynewfoo-whatever. Se preferir, exclua o valor inteiro, e um novo nome de revisão será criado automaticamente.
  3. Copie o serviço usando o seguinte comando:

    gcloud run services replace service.yaml

    Use a sinalização --region para implantar a cópia em uma região diferente.

Como ver mais detalhes sobre um serviço

A seguir, saiba como ver mais detalhes sobre um serviço.

Console

Para ver os detalhes de um serviço, realize as etapas a seguir:

  1. Acessar o Cloud Run

  2. Clique no serviço pretendido na lista exibida para abrir a visualização de detalhes do serviço:

    lista de revisão

  3. Observe as guias REVISÕES, REGISTROS e DETALHES. A guia "Revisões" mostra a lista de revisões, a guia "Registros" mostra os registros de serviços e a guia "Detalhes" mostra as configurações atuais de autenticação ou conectividade.

Linha de comando

Para ver detalhes sobre um serviço, realize as etapas a seguir:

gcloud run services describe SERVICE
Substitua SERVICE pelo nome do serviço.

É possível usar a sinalização --format para formatar a saída. Por exemplo, como YAML:

gcloud run services describe SERVICE --format yaml

É possível usar --format export para exportar como YAML sem rótulos ou status gerados automaticamente:

gcloud run services describe SERVICE --format export

Também é possível usar a sinalização --format para ver o URL do serviço:

gcloud run services describe SERVICE --format='value(status.url)'

Cloud Code

Para ver os detalhes de um serviço com o Cloud Code, leia os guias do explorador do Cloud Run para IntelliJ e Visual Studio Code.

Para mais detalhes sobre revisões de serviço, consulte Como gerenciar revisões.

Como desativar um serviço atual

O Cloud Run não oferece uma maneira direta de fazer um serviço parar de exibir tráfego, mas é possível alcançar um resultado semelhante ao revogar a permissão para invocar o serviço das identidades que o invocam. Se o serviço for "público", remova allUsers do papel Chamador do Cloud Run (roles/run.invoker).

Como excluir serviços atuais

As considerações a seguir se aplicam à exclusão de um serviço:

  • A exclusão de um serviço exclui todos os recursos relacionados a ele, incluindo todas as revisões, sem importar se estão ou não processando tráfego.
  • A exclusão de um serviço não remove automaticamente as imagens de contêiner do Container Registry. Para excluir imagens de contêiner usadas pelas revisões excluídas do Container Registry, consulte Como excluir imagens.
  • A exclusão de um serviço com um ou mais acionadores do Eventarc não exclui automaticamente esses acionadores. Para excluí-los, consulte Gerenciar acionadores.
  • Após a exclusão, o serviço permanece visível no Console do Google Cloud e na interface de linha de comando até que a exclusão seja totalmente concluída. No entanto, não é possível atualizar o serviço.
  • A exclusão de um serviço é permanente: não há como desfazer ou restaurar. No entanto, se após a exclusão de um serviço você implantar um novo com o mesmo nome na mesma região, ele terá o mesmo URL do endpoint.

Console

Para excluir um serviço, realize as etapas a seguir:

  1. Acessar o Cloud Run

  2. Localize o serviço que você quer excluir na lista de serviços e clique na caixa de seleção para marcá-lo.

  3. Clique em EXCLUIR. Isso exclui todas as revisões do serviço.

Linha de comando

Para excluir um serviço, use o comando:

gcloud run services delete [SERVICE]

Substitua [SERVICE] pelo nome do serviço.