Pular para o conteúdo principal

Processo de Pesquisa Unix

Configuração atual da tarefa Unix Search Process no Workflow Designer
  • Tipo de Tarefa: ssh_searchprocess

Descrição​

A Tarefa Processo de Pesquisa Unix permite pesquisar um processo em execução e recuperar o seu PID (Process ID), executando a operação na máquina local (modo Padrão) ou num servidor remoto através de SSH.

É utilizada para obter dinamicamente o identificador de um processo, para ser usado em tarefas subsequentes (ex: Processo de Terminação Unix) ou para verificar a sua existência.

Configuração​

A configuração define o modo de execução (local ou remoto) e o nome do processo a ser pesquisado. Os campos de configuração da Tarefa podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

Conexão ao Servidor​

  • Modo de Conexão: Define a origem das credenciais utilizadas para a conexão. Pode assumir três modos operacionais:
  • Padrão: O comando é executado na máquina local.
  • Manual: Permite o preenchimento manual dos parâmetros de conexão SSH.
  • Ambiente: Utiliza um ambiente de conexão pré-configurado. Neste modo, é exibido um menu que lista as conexões disponíveis com base no papel associado ao Fluxo de Trabalho.
  • Endereço IP: Endereço IP do servidor remoto.
  • Hostname: Nome de host do servidor remoto.
  • Utilizador: Nome de utilizador usado para estabelecer a conexão SSH.
  • Palavra-passe: Palavra-passe associada ao utilizador de conexão.
  • Porta: Porta utilizada para a conexão SSH (o valor padrão é 22).

Executar comando como outro utilizador​

Ao ativar esta caixa de seleção, é possível executar a pesquisa com um utilizador diferente daquele utilizado para a conexão SSH.

  • Utilizador: Nome do utilizador com quem o comando será executado.
  • Palavra-passe: Palavra-passe do utilizador usado para a execução do comando.

Detalhes do Processo​

  • Nome do Processo: O nome (ou uma parte significativa do nome) do processo a ser pesquisado.

Parâmetros de Saída​

Ao final da pesquisa, a Tarefa expõe os seguintes parâmetros de saída:

  • pidList: Contém a lista dos Process IDs numéricos encontrados que correspondem ao Nome do Processo especificado. Se for encontrado apenas um processo, conterá um único PID. Se forem encontrados vários processos, poderá conter todos eles (frequentemente separados por uma quebra de linha). Este é o parâmetro principal a ser utilizado em tarefas subsequentes.
  • result: Contém a saída textual completa do comando de pesquisa executado no servidor ou uma mensagem de erro.
  • resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
  • exitStatus: Retorna o código de saída do comando de pesquisa. Um valor de 0 indica que o comando foi executado corretamente (mesmo que não tenha encontrado nenhum processo).

Notas​

A tarefa estabelece uma conexão SSH com o servidor remoto e executa a extração do PID do processo configurado. Se for utilizada autenticação por chaves SSH, é necessário que a chave pública esteja registada no servidor remoto. Se a opção "Executar comando como outro utilizador" estiver ativada, o comando é executado com um utilizador diferente da conexão SSH principal.