Creazione di un task

Creare un task runbook per eseguire operazioni del ciclo di vita su una flotta in Fleet Application Management.

Nota

I task creati mediante questa procedura sono task condivisi e possono essere utilizzati da qualsiasi runbook.
    1. Nella pagina di elenco Task, selezionare Crea task. Per assistenza nella ricerca della pagina di elenco, vedere Elenco dei task del runbook.
    2. Nella pagina Crea task immettere le informazioni riportate di seguito.
      • Nome: immettere un nome univoco per il task. Il nome non deve essere univoco, ma non può essere modificato nella console. Tuttavia, puoi modificarlo con l'API. Evitare di fornire informazioni riservate.
      • Descrizione: immettere una descrizione appropriata per il task.
      • Crea nel compartimento: selezionare il compartimento nel quale si desidera creare il task del runbook.
      • Compartimento delle operazioni del ciclo di vita: selezionare un compartimento in cui esiste l'operazione specifica del ciclo di vita. Per informazioni sulle varie operazioni del ciclo di vita, vedere Operazione del ciclo di vita in Fleet Application Management.
      • Operazione del ciclo di vita: selezionare un'operazione del ciclo di vita, ad esempio patch, ricerca automatica, provisioning o qualsiasi operazione personalizzata.
      • Per le operazioni del ciclo di vita di patch o ricerca automatica, immettere le informazioni riportate di seguito.
        • Compartimento stack prodotto/prodotto: selezionare il compartimento in cui si trova il prodotto o lo stack di prodotti.
        • Pila prodotto/prodotto: selezionare uno stack di prodotti o prodotti a cui appartiene il task dal compartimento.
      • Tipo azione: selezionare una delle opzioni riportate di seguito.
        • Eseguire uno script: collegare uno script dallo storage degli oggetti o aggiungere lo script in linea in Comando. Per l'aggiunta di uno script in linea, vedere il punto n.
        • Esegui un terrenoform: utilizza un pacchetto Terraform per eseguire il provisioning delle risorse. Saltare al passo 4.
    3. Se è stato selezionato Esegui uno script, immettere le seguenti informazioni in Dettagli script in base alle esigenze.
      1. Per Tipo di sistema operativo, selezionare una piattaforma supportata su cui viene eseguito il task.
      2. Se il task è destinato alla ricerca automatica delle destinazioni:
        1. Attivare l'opzione Contrassegna questo task come task di output di ricerca automatica. Questa azione consente a Fleet Application Management di raccogliere informazioni sull'inventario software dal task al termine dell'operazione.
        2. In Aggiungi script, selezionare Scarica modello di output di ricerca automatica per assicurarsi che l'output del task corrisponda al formato del modello di ricerca automatica. Utilizzare il modello di ricerca automatica scaricato come guida per la codifica dello script di ricerca automatica. Per informazioni sugli attributi del modello, vedere Informazioni sul modello di output di ricerca automatica.
          Nota

          Il successo dell'esecuzione degli script di ricerca automatica o di applicazione delle patch dipende dai comandi utilizzati dallo scriptwriter e dal fatto che questi comandi siano supportati nell'istanza in uso. Se alcuni comandi non riescono, assicurarsi di configurare l'host con le installazioni necessarie prima di utilizzare i comandi. Ad esempio, utilizzando comandi come mlocate o locate per trovare file.
      3. Se il task prevede l'applicazione di patch, attivare il pulsante di attivazione/disattivazione Questo task richiede l'esecuzione di patch. Quando è attivata, Fleet Application Management inserisce i dettagli delle patch consigliate per il task. I dettagli sono disponibili nel file patches.json. Lo script può leggere il file patches.json per ottenere tutte le patch e utilizzare la variabile di ambiente DATA_DIR per conoscere la posizione della patch scaricata da Fleet Application Management nell'istanza di computazione.
      4. Per aggiungere lo script per l'esecuzione dei task, selezionare una delle opzioni riportate di seguito.
        • Carica o seleziona da uno storage degli oggetti: opzione per caricare lo script dal file system o dal bucket di storage degli oggetti. Passa al passaggio secondario e.
        • Seleziona da catalogo: opzione per scegliere lo script dall'elemento catalogo privato. Passa al sottopasso i.
      5. Se l'aggiunta dello script avviene tramite lo storage degli oggetti, selezionare Sfoglia accanto a Seleziona script dallo storage degli oggetti.
        Nella pagina Seleziona file selezionare una delle opzioni riportate di seguito.
        • Effettua una selezione da un bucket di storage degli oggetti: selezionare uno script dallo storage degli oggetti, se è già stato caricato, quindi passare al passo secondario f.
        • Carica un file: selezionare uno script caricandolo nello storage degli oggetti e passare al passaggio secondario g.
      6. Se hai selezionato Seleziona da un bucket di storage degli oggetti:
        1. Selezionare il compartimento che contiene il bucket di storage degli oggetti con lo script, quindi selezionare il bucket.
        2. Selezionare un file di script dal bucket, quindi selezionare Seleziona. Passa al passaggio secondario h.
      7. Se è stato selezionato Carica un file:
        1. Trascinare un file dal file system nella casella Trascina e rilascia oppure cercare il file.
        2. Selezionare il compartimento che contiene il bucket di storage degli oggetti in cui si desidera caricare il file, quindi selezionare il bucket.
        3. Selezionare il file di script come richiesto.
        4. Per Prefisso nome oggetto, specificare un prefisso per il file caricato per identificarlo facilmente durante la selezione dallo storage degli oggetti.
        5. Selezionare Carica e seleziona per memorizzare lo script nel bucket e selezionare lo script per il task.
      8. Attivare l'opzione Salva come elemento del catalogo se lo script deve essere memorizzato come elemento del catalogo. Specificare quindi il nome dell'elemento catalogo memorizzato.
      9. Se l'aggiunta dello script avviene tramite un catalogo privato nel passo secondario d, selezionare il compartimento che contiene l'elemento del catalogo, quindi selezionare l'elemento del catalogo o utilizzare il comando in linea. Per l'uso del comando, vedere il punto n.
      10. Attivare l'opzione Crea eseguibile script per abilitare l'esecuzione automatica del file di script.
      11. Attivare il pulsante di attivazione/disattivazione Blocca script per impedire l'esecuzione dello script quando viene aggiornato nel bucket di storage degli oggetti.
      12. Attivare l'opzione Aggiungi variabili di input se il task richiede variabili di input, quindi immettere i dettagli riportati di seguito.
        1. Inserire un nome univoco e la descrizione per la variabile. Evitare di fornire informazioni riservate.
        2. Per Tipo, selezionare la stringa o la variabile di output. Ad esempio, selezionare il tipo come variabile di output se si desidera che il valore della variabile venga utilizzato come variabile di input per un altro task.

        Aggiungere altre variabili di input in base alle esigenze.

      13. Attivare l'opzione Aggiungi variabili di output se il task genera variabili di output. quindi immettere un nome univoco per la variabile; Aggiungere altre variabili di output in base alle esigenze.
      14. (Facoltativo) Se l'esecuzione dei task si basa su più file, nella casella Comando fornire il comando per avviare l'esecuzione. Fornire il comando per informare Fleet Application Management su come eseguire lo script. Lo script può essere un file ZIP, un file JAR, un file EXE o qualsiasi altro programma che può essere eseguito sull'istanza. Le variabili definite per il task possono essere passate allo script come argomenti place o argomenti key-value. Quando si passa una variabile come argomento, anteponila a "$". Ad esempio, per utilizzare i file ZIP e JAR:
        • Immettere il comando unzip zippedfile.zip per decomprimere il file contenente tutti i file, quindi immettere il comando ./main.sh per iniziare l'esecuzione.
        • Per passare le variabili al comando, fornire le variabili come argomenti della riga di comando. Vedere i seguenti tipi di argomenti della riga di comando. Vedere i seguenti tipi di argomenti della riga di comando:
          • Per gli argomenti statici, fornirli direttamente come argomenti (ad esempio, se lo script di task prevede un valore di timeout), l'argomento può essere il seguente: ./main.sh 10s
          • Per gli argomenti dinamici basati su quelli configurati nel task (ad esempio, se si prevede timeout e backuptype), l'argomento può essere il seguente: ./main.sh $timeout $backuptype
          • Per una combinazione di argomenti statici e dinamici, l'argomento può essere il seguente: ./main.sh 10s $backuptype
        • Immettere il seguente comando JAR per gli argomenti dinamici (backuptype e timeout):
          java -jar ApplicationBackup.jar $backuptype $timeout
      15. (Facoltativo) Selezionare un compartimento delle credenziali e i nomi delle credenziali creati in Vault se non definiti per lo stack di prodotti o prodotti.
        Importante

        Se il task richiede una credenziale, è necessario crearla in Gestione metadati e fornire i relativi dettagli per una flotta, una risorsa o una credenziale di destinazione. Fleet Application Management passa quindi questi dettagli per l'esecuzione del task del runbook.
    4. Se nel passo 2 è stata selezionata l'opzione Esegui un terreno, immettere le informazioni riportate di seguito in Dettagli Terraform in base alle esigenze.
      1. Selezionare un elemento catalogo Marketplace o Terraform privato esistente dal compartimento specifico.
      2. Se è stato selezionato un package Marketplace( OCI Core Landing Zone) esistente da un compartimento specifico nel passo a, creare un elemento catalogo privato per il tipo "Pacchetto Terraform" per creare un package Terraform personalizzato.
        1. Creare un elemento catalogo privato del tipo di pacchetto CONFIG_FILE contenente un esempio di config.json.
        2. Carica config.json in un bucket di storage degli oggetti e crea un collegamento URL PAR per tale bucket.
        3. Per Selezionare il file di configurazione dal catalogo, selezionare l'elemento di catalogo del package Terraform corrispondente che contiene il collegamento dell'URL PAR al file config.json come indicato nel passo precedente.

          Di seguito è riportato un esempio di file config.json.

          {
              "service_label": "cisbasic",
              "network_admin_email_endpoints": ["email.address@example.com"],
              "security_admin_email_endpoints": ["email.address@example.com"],
              "enable_cloud_guard": true
          }

          Per informazioni su tutte le variabili di configurazione dell'elemento catalogo OCI Core Landing Zone, vedere Variabili OCI Core Landing Zone.

      3. Se è stato selezionato un elemento catalogo privato di configurazione esistente da un compartimento specifico nel passo a, creare un elemento catalogo privato per il tipo "package Terraform" per creare un package di configurazione personalizzato.
      4. Selezionare un compartimento di destinazione in cui risiedono le istanze di computazione, le risorse del database, i volumi a blocchi o le risorse di rete create dopo l'esecuzione del package Terraform.
        Nota

        L'allocazione di compartimenti diversi per risorse diverse rende le risorse più sicure, gestibili e scalabili.
      5. Attivare il pulsante di attivazione/disattivazione Variabile di output lettura per consentire la lettura e l'utilizzo delle variabili di output generate dall'esecuzione di Terraform come input per il task successivo.
    5. In Proprietà task, immettere i dettagli riportati di seguito.
      • Numero massimo di nuovi tentativi in caso di errore: specificare un valore per il numero di nuovi tentativi di un task in caso di errore.
      • Timeout: specificare un valore di timeout per un task in secondi quando non riesce.

      Vedere Proprietà task.

    6. Per creare una copia del task nella libreria di task, attivare Eseguire una copia di questo task nella libreria. Questo task fa quindi parte della libreria di task ed è possibile riutilizzare e aggiornare questo task della libreria.
    7. Selezionare Crea.
  • Utilizzare il comando oci fleet-apps-management fleet-apps-management-runbooks task-record create e i parametri necessari per creare un task runbook:

    oci fleet-apps-management fleet-apps-management-runbooks task-record create --compartment-id <compartment_OCID> --details <json_file_or_string> -display-name <text> [OPTIONS]

    Per un elenco completo dei flag e delle opzioni variabili per i comandi CLI di Fleet Application Management, vedere la sezione CLI for Fleet Application Management.

  • Eseguire l'operazione CreateTaskRecord per creare un task runbook.