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 Knative serving.

criar um serviço

Para criar um novo serviço e a revisão dele, implante uma imagem de contêiner nele pela primeira vez. Consulte Como implantar um novo serviço para saber mais sobre como criar serviços.

Como ver a lista de serviços no projeto

É possível visualizar uma lista dos serviços disponíveis no projeto usando o console do Google Cloud ou a Google Cloud CLI:

Console

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

  1. Acesse o Knative serving no console do Google Cloud:

    Acessar o Knative serving

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

Linha de comando

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

gcloud run services list

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

Como copiar um serviço

É possível fazer uma cópia de um serviço atual usando o console do Google 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. Acesse o Knative serving no console do Google Cloud:

    Acessar o Knative serving

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

    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

Faça o download da configuração de um serviço existente para um arquivo YAML com o comando gcloud run services describe usando a sinalização --format=export. Em seguida, modifique o arquivo YAML e implante essas alterações com o comando gcloud run services replace. Modifique apenas os atributos especificados.

  1. Faça o download da configuração do serviço em um arquivo chamado service.yaml no espaço de trabalho local:

    gcloud run services describe SERVICE --format export > service.yaml

    Substitua SERVICE pelo nome do serviço de veiculação do Knative serving.

  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ê estiver implantando a cópia no mesmo cluster do Kubernetes, substitua SERVICE pelo nome que você quer usar para a cópia. Se você estiver implantando a cópia em outro cluster do Kubernetes, será possível usar o mesmo nome.

    • 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. Acesse o Knative serving no console do Google Cloud:

    Acessar o Knative serving

  2. Clique no serviço pretendido na lista exibida para abrir a visualização de detalhes do serviç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)'

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

Como alterar as configurações de conectividade do serviço

Um serviço do Knative serving pode ter uma destas duas opções de conexão:

  • Externa: permite acesso externo ao seu serviço.

  • Interna: restringe o acesso apenas a outros serviços no cluster.

Use o Console ou a Google Cloud CLI para alterar as configurações.

Console

Para alterar as configurações de conectividade de serviço, realize as etapas a seguir:

  1. Acesse o Knative serving no console do Google Cloud:

    Acessar o Knative serving

  2. Clique no serviço que você quer na lista exibida para abrir a visualização de detalhes do serviço.

  3. Clique na guia Gatilhos.

  4. Selecione a configuração que você quer e clique em Salvar.

Linha de comando

Para alterar as configurações de conectividade do serviço, atualize o serviço com a configuração de conectividade pretendida:

gcloud run services update [SERVICE] --connectivity=[OPTION]

  • Substitua [SERVICE] pelo nome do serviço que você está atualizando. É possível omitir inteiramente esse parâmetro, mas será solicitado o nome do serviço, se você omiti-lo.

  • Substitua [OPTION] por internal ou external.

Como excluir serviços atuais

A exclusão de um serviço exclui todos os recursos relacionados a ele, incluindo todas as revisões desse serviço, independentemente de estarem veiculando tráfego ou não.

Ao excluir um serviço, as imagens do contêiner usadas pelas revisões excluídas não são excluídas automaticamente do Container Registry. Para excluir imagens de contêiner do Container Registry, consulte Como excluir imagens.

Observe que 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 serviço com o mesmo nome no mesmo cluster, ele terá o mesmo URL do endpoint.

Console

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

  1. Acesse o Knative serving no console do Google Cloud:

    Acessar o Knative serving

  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.