Sistema de Desligamento Unix

• Tipo de tarefa: ssh_shutdownsystem

Descrição

A tarefa Sistema de Desligamento Unix permite executar o desligamento do sistema operativo numa máquina local (modo Padrão) ou num servidor remoto através de SSH, enviando um comando de desligamento.

É utilizada para automatizar o desligamento de máquinas físicas ou virtuais no final de processos em lote, para atividades de manutenção ou para procedimentos de gestão do sistema.

Configuração

A configuração define os detalhes da ligação SSH, os tempos de desligamento e a mensagem de notificação para os utilizadores. Os campos de configuração da Tarefa podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

Ligação ao Servidor

• Modo de ligação: Define a origem das credenciais utilizadas para a ligaçã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 ligação SSH.
• Ambiente: Utiliza um ambiente de ligação pré-configurado. Neste modo, é exibido um menu que lista as ligaçõ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 ligação SSH.
• Palavra-passe: Palavra-passe associada ao utilizador de ligação.
• Porta: Porta utilizada para a ligaçã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 ligaçã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 Desligamento

• Timeout (Minutos): Especifica quantos minutos após a execução da Tarefa o servidor será efetivamente desligado. Este não é um timeout de ligação, mas sim o tempo de espera antes do desligamento.
• Mensagem: A mensagem de notificação que será enviada a todos os utilizadores atualmente ligados ao servidor através do terminal para os avisar do iminente paragem do sistema.

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 Fluxo de Trabalho.

• 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 de desligamento. Um valor de 0 indica que o comando foi agendado com sucesso.

Notas Importantes

A tarefa estabelece uma ligação SSH com o servidor remoto e executa o comando de reinicialização do servidor conforme 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 ligação SSH principal.