Passa al contenuto principale
Versione: 2.0

Unix Update Package

Configurazione corrente del task Unix Update Package nel Workflow Designer
  • 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.
  • Autenticazione: seleziona Password oppure Chiave.
  • Password: compare scegliendo Password.
  • Path chiave privata: compare scegliendo Chiave; richiede il path assoluto del file e supporta parametri e variabili del workflow. Sono supportate chiavi RSA ed Ed25519.
  • 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​

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

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.