Skip to main content

Unix Update Package

Unix Update Package | Sybot Documentation

UNIX UPDATE PACKAGE

  • Task type: ssh_updatepackage

Descrizione​

Il Task Unix Update Package consente di aggiornare un singolo pacchetto software su un sistema, eseguendo l’operazione sulla macchina locale (modalità Default) o su un host remoto tramite SSH.

Il Task gestisce in modo trasparente il gestore di pacchetti del sistema operativo, semplificando l’esecuzione delle operazioni di aggiornamento all’interno del workflow.

Configurazione

La configurazione definisce la modalità di esecuzione (locale o remota) e le opzioni relative al gestore di pacchetti utilizzato per l’aggiornamento. I campi di configurazione possono essere compilati manualmente oppure valorizzati dinamicamente tramite parametri e variabili del workflow.

Connessione al Server​

  • Modalità connessione: Definisce l’origine delle credenziali utilizzate per la connessione. Può assumere tre modalità operative:
  • Default: il comando viene eseguito dalla macchina locale.
  • Manuale: Consente l’inserimento manuale dei parametri di connessione SSH.
  • Environment: Utilizza un ambiente di connessione preconfigurato. In questa modalità viene visualizzato un menu che elenca le connessioni disponibili in base al ruolo associato al Workflow.
  • Indirizzo IP: Indirizzo IP del server remoto.
  • Hostname: Nome host del server remoto.
  • Utente: Nome utente utilizzato per stabilire la connessione SSH.
  • Password: Password associata all'utente di connessione.
  • Porta: Porta utilizzata per la connessione SSH (il valore predefinito è 22).

Esegui comando come altro utente​

Attivando questa checkbox, è possibile eseguire la ricerca con un utente diverso da quello utilizzato per la connessione SSH.

  • Utente: Nome dell'utente con cui verrà eseguito il comando.
  • Password: Password dell’utente utilizzato per l’esecuzione del comando.

Dettagli dell'Aggiornamento​

  • Package manager: Menu che consente di selezionare il gestore di pacchetti appropriato per il sistema operativo del server di destinazione. La scelta del gestore corretto è essenziale per il buon esito dell’operazione.
  • yum: Da utilizzare per le distribuzioni basate su Red Hat (come CentOS, Fedora, RHEL).
  • apt: Da utilizzare per le distribuzioni basate su Debian (come Ubuntu, Debian).
  • Pacchetto: Il nome esatto del pacchetto software che si desidera aggiornare (es. openssl, httpd, nginx).

Parametri di Output

Al termine dell'esecuzione, il Task espone i seguenti parametri di output:

  • result: Contiene un messaggio testuale che descrive l'esito dell'operazione o un messaggio di errore (es. “Missing server address”).
  • resultJson: Rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.
  • exitStatus: Restituisce il codice di uscita del comando di aggiornamento. Un valore di 0 indica che l'aggiornamento è stato completato con successo.

Esempio parametro resultJson​

{
 "id": 19876,
 "name": "Unix Update Package",
 "description": "",
 "type": "ssh_updatepackage",
 "type_name": "Unix Update Package",
 "type_description": "Aggiornamento Pacchetti",
 "config": {
 "operation": "updatepackage",
 "package": "",
 "package_manager": "yum",
 "connection": {
 "connection_mode": "default",
 "env_connection_name": "---",
 "ip": "",
 "hostname": "",
 "port": "",
 "user": "",
 "use_password": "N",
 "password": "",
 "hidden_task_pwd": "0"
 }
 },
 "run_info": {
 "run_id": 1509980,
 "start_datetime": "2026-04-28 10:43:16",
 "end_datetime": "2026-04-28 10:43:16",
 "start_epoch": 1777372996.480685,
 "end_epoch": 1777372996.608734,
 "duration": 0,
 "status": "Completed",
 "cmd_text": "",
 "run_result": "Failed",
 "result_text": "Failed: pacchetto da aggiornare non configurato",
 "full_result_text": ""
 },
 "output_parameters": {
 "exitStatus": "1"
 }
}

Note Importanti​

  • Permessi: Il task stabilisce una connessione SSH con il server remoto ed esegue il comando di aggiornamento del package configurato. Se si utilizza l’autenticazione tramite chiavi SSH, è necessario che la chiave pubblica sia registrata sul server remoto. Se l’opzione “Esegui comando come altro utente” è abilitata, il comando viene eseguito con un utente diverso da quello della connessione SSH principale.
  • Connettività Internet: Il server remoto deve avere accesso a Internet per poter contattare i repository software da cui scaricare l'aggiornamento.