Pular para o conteúdo principal

Pacote de Atualização Unix

Configuração atual da tarefa Unix Update Package no Workflow Designer
  • Tipo de Tarefa: ssh_updatepackage

Descrição​

A Tarefa Pacote de Atualização Unix permite atualizar um único pacote de software num sistema, executando a operação na máquina local (modo Padrão) ou num host remoto através de SSH.

A Tarefa gere de forma transparente o gestor de pacotes do sistema operativo, simplificando a execução das operações de atualização dentro do fluxo de trabalho.

Configuração​

A configuração define o modo de execução (local ou remoto) e as opções relativas ao gestor de pacotes utilizado para a atualização. Os campos de configuração podem ser preenchidos manualmente ou valorizados dinamicamente 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 a partir da 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.
  • Usuário: 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 utilizado para a execução do comando.

Detalhes da Atualização​

  • Gestor de pacotes: Menu que permite selecionar o gestor de pacotes apropriado para o sistema operativo do servidor de destino. A escolha do gestor correto é essencial para o bom êxito da operação.
  • yum: Para ser utilizado em distribuições baseadas em Red Hat (como CentOS, Fedora, RHEL).
  • apt: Para ser utilizado em distribuições baseadas em Debian (como Ubuntu, Debian).
  • Pacote: O nome exato do pacote de software que se deseja atualizar (ex. openssl, httpd, nginx).

Parâmetros de Saída​

Ao final da execução, a Tarefa expõe os seguintes parâmetros de saída:

  • 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 atualização. Um valor de 0 indica que a atualização foi concluída com sucesso.

Exemplo de parâmetro resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Notas Importantes​

  • Permissões: A tarefa estabelece uma conexão SSH com o servidor remoto e executa o comando de atualização do pacote 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.
  • Conectividade com Internet: O servidor remoto deve ter acesso à Internet para poder contactar os repositórios de software de onde descarregar a atualização.