Pular para o conteúdo principal

Controlo de Serviço Unix

Configuração atual da tarefa Unix Service Control no Workflow Designer
  • Tipo de Tarefa: ssh_checkservice

Descrição​

A Tarefa Controlo de Serviço Unix permite gerir o estado de um serviço ou demónio numa máquina local (modo Padrão) ou num servidor remoto através de SSH.

Permite a execução de operações padrão em serviços, como iniciar, parar e verificar o estado, sem a necessidade de especificar manualmente os comandos do sistema operativo.

Configuração​

A configuração define o modo de execução (local ou remoto) e o serviço a ser gerido. 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 e o tipo de execução. Pode assumir três modos operacionais:
  • Padrão: Os comandos são executados na máquina local, sem conexão SSH.
  • 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 Workflow.
  • 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 o comando de gestão do serviço com um utilizador diferente daquele usado para a conexão SSH.

  • Utilizador: O nome de utilizador com o qual o comando será executado (ex. root).
  • Palavra-passe: A palavra-passe do utilizador especificado acima.

Detalhes da Operação​

  • Operação: Um menu para selecionar a ação a ser executada no serviço:
  • Status: Verifica o estado atual do serviço (ex. ativo, inativo, a carregar).
  • Start: Inicia o serviço.
  • Stop: Para o serviço.
  • Nome do Serviço: O nome do serviço sobre o qual agir, tal como é conhecido pelo sistema operativo (ex. httpd, apache2, postgresql, sshd).

Parâmetros de Saída​

Ao concluir a execução, a tarefa disponibiliza os seguintes Parâmetros de Saída, utilizáveis como entrada em tarefas subsequentes do Workflow.

  • result: Contém uma mensagem de texto que descreve o resultado da operação ou uma mensagem de erro (ex. “Missing server address”).
  • 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 executado. Um valor de 0 indica tipicamente que a operação foi executada com sucesso. Códigos diferentes podem indicar vários estados (ex. "serviço já parado" ou "serviço não encontrado").

Notas​

A tarefa estabelece uma conexão SSH com o servidor remoto e executa o comando de stop/start/status do serviço especificado no servidor 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 será executado com um utilizador diferente da conexão SSH principal.