Documentazione di Oracle Cloud Infrastructure

Creazione di un job di applicazione

Creare un job di candidatura in Resource Manager.

Quando crei (esegui) un job di applicazione per uno stack, Terraform esegue il provisioning delle risorse ed esegue le azioni definite nella configurazione Terraform, applicando il piano di esecuzione allo stack associato per creare (o modificare) le risorse Oracle Cloud Infrastructure. Si consiglia di eseguire un job del piano (generando un piano di esecuzione) prima di eseguire un job di applicazione.

Per una panoramica sull'uso dell'interfaccia CLI per il provisioning cloud in una pipeline CI/CD, vedere IaC in the Cloud: Integrating Terraform and Resource Manager in your CI/CD Pipeline - Building With the OCI CLI.

Per le configurazioni memorizzate in un sistema di controllo del codice sorgente, ad esempio GitHub o GitLab, il job utilizza il commit più recente. Il tempo necessario per completare un job di candidatura dipende dal numero e dal tipo di risorse cloud da creare.

    1. Nella pagina della lista Stack selezionare lo stack con cui si desidera lavorare. Se hai bisogno di aiuto per trovare la pagina di elenco o lo stack, vedere Elenco di stack.
    2. Nella pagina dei dettagli dello stack selezionare Applica.
    3. (Facoltativo) Nel pannello Applica modificare il nome predefinito del job. Evitare di inserire informazioni riservate.
    4. (Facoltativo) Per Applica risoluzione piano job, selezionare il nome dell'ultimo job piano generato. È disponibile solo l'ultimo job del piano generato. Se non è stato generato alcun job del piano per questo stack, sarà disponibile solo il valore predefinito (Approvazione automatica). Per ulteriori informazioni sull'approvazione automatica, vedere Opzione di approvazione automatica per il comando di applicazione Terraform.
    5. Per recuperare le versioni più recenti disponibili dall'origine configurata dei provider Terraform, selezionare Mostra opzioni avanzate e selezionare Aggiorna versioni provider.
      Lo stack deve essere Terraform 0.14 o versione successiva e, se è precedente, deve essere aggiornato al registro Terraform. Questo passo è necessario se le versioni del provider nella configurazione Terraform sono state modificate dopo l'ultima esecuzione di un job nello stack. I file di blocco delle dipendenze vengono gestiti automaticamente per gli stack nuovi e aggiornati. I provider vengono aggiornati entro i vincoli di versione della configurazione Terraform.
    6. Per generare contenuto di log dettagliato per il debug, selezionare Mostra opzioni avanzate e selezionare il livello di log desiderato da Livello di log dettagliato.
      Per ulteriori informazioni, vedere Debug di Terraform.
    7. Per adeguare il numero massimo di operazioni concorrenti come Terraform guida il grafico, selezionare Mostra opzioni avanzate e modificare il valore per Numero massimo di operazioni parallele. Il valore predefinito è 10. Utilizzare questa opzione per velocizzare il job.
      Nota

      Un valore elevato potrebbe causare la limitazione delle risorse. Ad esempio, si consideri una configurazione Terraform che definisce centinaia di istanze di computazione. Un job di Applica tenta di creare il maggior numero possibile di istanze contemporaneamente. In questo esempio, il valore 100 potrebbe causare limitazioni da parte del servizio di computazione.
    8. Per recuperare lo stato più recente prima di eseguire il job, selezionare Mostra opzioni avanzate e selezionare Aggiorna stati risorsa prima di controllare le differenze.

      Utilizzare questa opzione per aggiornare prima lo stato. Ad esempio, è possibile utilizzare questa opzione con un job Applica che si desidera eseguire sull'infrastruttura (esistente) aggiornata manualmente.

      Nota

      L'aggiornamento dello stato può influire sulle prestazioni. Se la configurazione include diverse risorse, non utilizzare questa opzione.
    9. (Facoltativo) Aggiungere una o più tag al job: selezionare Mostra opzioni avanzate per visualizzare le opzioni di applicazione tag.
      Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.
    10. Selezionare Applica.

    Il job di applicazione è stato creato. Il nuovo job viene elencato in Job.

  • Utilizzare il comando oci resource-manager job create-apply-job e i parametri richiesti per eseguire un job di applicazione.

    oci resource-manager job create-apply-job [OPTIONS]

    Per un elenco completo dei parametri e dei valori per i comandi CLI, vedere Command Line Reference for Resource Manager.

    Esempi

    Esempio 1: fare riferimento a un job del piano.

    oci resource-manager job create-apply-job --execution-plan-strategy <plan_job_ocid> --stack-id <stack_ocid>

    Esempio 2: approvazione automatica (non fare riferimento a un job del piano).

    oci resource-manager job create-apply-job --execution-plan-strategy AUTO_APPROVED --stack-id <stack_ocid>

  • Utilizzare l'operazione CreateJob per creare un job di applicazione.

    Per un esempio della parte operation della richiesta, vedere CreateApplyJobOperationDetails.

Operazioni successive

A seconda del numero e del tipo di risorse specificate, un job di candidatura specifico può richiedere del tempo.

Dopo aver eseguito un job di applicazione, ottenere i dettagli del job per verificarne lo stato. Facoltativamente, è possibile visualizzare il file di stato Terraform, visualizzare i log e confermare l'esistenza delle risorse di cui è stato eseguito il provisioning.

Monitorare lo stato del job (stato del ciclo di vita) ottenendo i dettagli del job. Riuscito (SUCCEEDED) indica che il job è stato completato. A seconda della complessità del job, l'operazione può richiedere del tempo. Al termine o durante l'esecuzione del job, è possibile ottenere il contenuto dei log dei job.

Per visualizzare il file di stato Terraform (mostra lo stato delle risorse dopo l'esecuzione del job), selezionare il nome del job per visualizzare la pagina Dettagli job, quindi selezionare Visualizza stato in Risorse. Se si desidera, selezionare Mostra modifiche in questa versione.

Per visualizzare i log del job, selezionare il job per aprirne la pagina dei dettagli, quindi selezionare Log in Risorse.

Per confermare l'esistenza delle nuove risorse di cui è stato eseguito il provisioning, ispezionare le risorse nel compartimento.