Exibindo Solicitações de Serviço

Descubra como exibir as operações do Kubernetes Engine (OKE) como solicitações de serviço.

Muitas solicitações de serviço do Kubernetes Engine não entram em vigor imediatamente. Por exemplo, a criação de um pool de nós não é concluída até que todos os nós obrigatórios estejam ativos. Nesses casos, a solicitação é atendida de forma assíncrona e seu andamento é rastreado por uma solicitação de serviço associada. Solicitação de serviço é um log de atividades que fornece visibilidade de operações assíncronas em andamento, permitindo rastrear cada etapa do andamento da operação. Cada solicitação de serviço tem um OCID que permite interagir com ela de forma programática e usá-la para automação.

As solicitações de serviço incluem informações sobre o horário em que a solicitação foi iniciada e concluída. Se uma operação falhar, uma solicitação de serviço poderá ajudá-lo a determinar qual etapa do processo teve um erro. Algumas operações afetam vários recursos. Por exemplo, a criação de um pool de nós também afeta os nós. Uma solicitação de serviço fornece uma lista dos recursos que uma operação afeta.

Para obter mais informações, consulte Solicitações de Serviço e a API de Solicitações de Serviço.

Solicitações de Serviço do Pool de Nós

Os recursos gerenciados pelo Kubernetes Engine só podem suportar uma solicitação de serviço por vez. As solicitações de serviço iniciadas enquanto outra solicitação de serviço está em andamento falharão e retornarão um conflito. Como algumas operações dependem da conclusão de outras operações, você deve monitorar a solicitação de serviço de cada operação e confirmar que ela foi bem-sucedida antes de passar para a próxima operação. Uma solicitação de serviço criar pool de nós tem um status Bem-sucedida quando o workflow cria com sucesso um nó e o nó é registrado com um status Ativo.

Status da Solicitação de Serviço

A tabela seguinte lista os estados da solicitação de trabalho:

Status	Descrição
Aceito	A solicitação está na fila de solicitações de serviço para ser processada.
Em Andamento	Existe um registro de solicitação de serviço para a solicitação especificada, mas nenhum registro WORK_COMPLETED associado existe.
Com sucesso	Existe um registro de solicitação de serviço para essa solicitação e um registro WORK_COMPLETED associado está no estado Bem-sucedido.
Falhou	Existe um registro de solicitação de serviço para essa solicitação e um registro WORK_COMPLETED associado está no estado Com falha.
Cancelando	A solicitação de serviço está no processo de cancelamento.
Cancelado	A solicitação de serviço foi cancelada.

Política Obrigatória do Serviço IAM para Exibir Solicitações de Serviço

Para usar o Oracle Cloud Infrastructure, você deve receber de um administrador o acesso de segurança em uma política . Esse acesso será necessário se você estiver usando a Console ou a API REST com um SDK, uma CLI ou outra ferramenta. Caso receba uma mensagem de que você não tem permissão ou de que não está autorizado, verifique com o administrador o tipo de acesso que você tem e em qual compartimento trabalhar.

Para administradores: As solicitações de serviço herdam as permissões da operação que gera a solicitação de serviço. Para permitir que os usuários exibam as solicitações de serviço, os logs e as mensagens de erro para uma operação, grave uma política que conceda permissão de usuários para executar a operação. Por exemplo, para permitir que os usuários vejam as solicitações de serviço associadas à inicialização de instâncias, grave uma política que permita aos usuários iniciar instâncias.

Para permitir que os usuários listem todas as solicitações de serviço em uma tenancy, use a seguinte política:

Allow group SupportTeam to inspect work-requests in tenancy

Se você não estiver familiarizado com as políticas, consulte Conceitos Básicos de Políticas e Políticas Comuns.

Obtendo Detalhes da Solicitação de Serviço

Obtenha os detalhes de uma solicitação de serviço para um recurso de cluster ou pool de nós.

Use um dos métodos a seguir para obter os detalhes de uma solicitação de serviço para um recurso de cluster ou pool de nós selecionado.

Para obter os detalhes de uma solicitação de serviço usando a Console

Obtenha os detalhes de uma solicitação de serviço para um recurso de cluster ou pool de nós.

Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Contêineres e Artefatos, clique em Clusters do Kubernetes (OKE).
Selecione o Compartimento na lista.
Na página Lista de Clusters, clique no nome do cluster cujos detalhes da solicitação de serviço você deseja obter.
Se quiser obter detalhes da solicitação de serviço de um pool de nós específico no cluster, clique em Pools de Nós em Recursos e clique no nome do pool de nós.
Para exibir solicitações de serviço, clique em Solicitações de Serviço em Recursos.
Na lista Solicitações de Serviço, localize a solicitação de serviço cujos detalhes você deseja obter. Para cada solicitação de serviço recente, você pode ver o seguinte:
- Tipo de Operação: A operação que está sendo executada pela solicitação de serviço.
- Status: Consulte Status da Solicitação de Serviço para obter uma lista de status e suas descrições.
- ID: OCID da solicitação de serviço.
- Recurso: O nome do recurso.
- Hora de Início: grupo de data e hora baseado em UTC de quando a solicitação de serviço foi iniciada.
- Hora de Término: Grupo de data e hora baseado em UTC em que a solicitação de serviço foi finalizada.
Clique em uma solicitação de serviço específica para ver:
- Mensagens de log: Informações sobre o estágio do workflow e um timestamp para cada estágio.
- Mensagens de erro: Informações sobre erros e o timestamp do erro.
- Recursos associados: O nome, o tipo e o OCID dos recursos afetados pela solicitação de serviço.

Para obter os detalhes de uma solicitação de serviço usando a CLI

Use a CLI (interface de linha de comando) para obter os detalhes de uma solicitação de serviço para um recurso de cluster ou pool de nós.

Informe o seguinte comando:

oci ce work-request get --work-request-id work_request_id [OPTIONS]

Consulte a ajuda on-line da CLI para obter uma lista de opções:

oci ce work-request get --help

Consulte oci ce work-request get para obter uma descrição completa do comando.

Para obter os detalhes de uma solicitação de serviço usando a API

Use a API para obter os detalhes de uma solicitação de serviço para um recurso de cluster ou pool de nós.

Execute o método GetWorkRequest para obter os detalhes de uma solicitação de serviço para um cluster ou pool de nós. Consulte GetWorkRequest para obter uma descrição completa.

Listar Solicitações de Serviço

Liste as solicitações de serviço para um recurso de cluster ou pool de nós.

Use um dos métodos a seguir para exibir uma lista de solicitações de serviço para um recurso de cluster ou pool de nós selecionado.

Para listar as solicitações de serviço usando a Console

Use a Console do OCI para listar as solicitações de serviço de um cluster ou recurso de pool de nós.

Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Contêineres e Artefatos, clique em Clusters do Kubernetes (OKE).
Selecione o Compartimento na lista.
Na página Lista de Clusters, clique no nome do cluster cujas solicitações de serviço você deseja listar.
Se quiser obter detalhes da solicitação de serviço de um pool de nós específico no cluster, clique em Pools de Nós em Recursos e clique no nome do pool de nós.
Clique em Solicitações de Serviço em Recursos.

A lista Solicitações de Serviço mostra solicitações de serviço recentes.

Para listar as solicitações de serviço usando a CLI

Use a CLI (interface de linha de comando) para listar as solicitações de serviço de um recurso de cluster ou pool de nós.

Informe o seguinte comando:

oci ce work-request list --compartment-id compartment-OCID --resource-type CLUSTER|NODEPOOL --cluster-id cluster-OCID --resource-id resource-OCID [OPTIONS]

Consulte a ajuda on-line da CLI para obter uma lista de opções:

oci ce work-request list --help

Consulte oci ce work-request list para obter uma descrição completa do comando.

Para listar as solicitações de serviço usando a API

Use a API para listar as solicitações de serviço de um recurso de cluster ou pool de nós.

Execute o método ListWorkRequests para listar as solicitações de serviço de um recurso de cluster ou pool de nós. Consulte ListWorkRequests para obter uma descrição completa.