Documentazione dell'infrastruttura Oracle Cloud

Creare e configurare job di build di produzione

È necessario impostare alcuni processi di creazione package e distribuzione prima di poter distribuire applicazioni visive nell'istanza di produzione di Visual Builder. Questo argomento spiega come farlo.

Suggerimento:

Se preferisci, VB Studio può creare e abilitare automaticamente i job di build e la pipeline. Nell'editor delle impostazioni dell'applicazione visiva, in Creazione e pubblicazione, selezionare la diramazione di produzione, quindi fare clic su Crea pipeline CI/CD. È quindi possibile modificare i job di build appena creati in base alle esigenze (vedere le istruzioni riportate di seguito per ulteriori passi di configurazione). Ad esempio, nel job di distribuzione, la destinazione di distribuzione è sempre l'ambiente associato all'area di lavoro, pertanto sarà necessario modificare l'istanza di destinazione nell'istanza di produzione.

Prima di configurare i job di build di produzione, tenere presente quanto riportato di seguito.

  • Nel processo di confezionamento di produzione, utilizzare il ramo di produzione del repository Git per generare gli artifact di produzione.
  • Nel processo di creazione package di sviluppo, se si modificano i nomi file predefiniti dei file artifact di archivio, ottenere i nuovi nomi e i relativi percorsi. Ne avrai bisogno quando configuri il lavoro di confezionamento di produzione.
  • Se il job di packaging di sviluppo è stato configurato in modo da sovrascrivere la versione dell'applicazione definita in visual-application.json, ottenere la nuova versione. Ne avrai bisogno quando configuri il lavoro di confezionamento di produzione.
  • Durante la configurazione dei job di build di distribuzione, è possibile specificare se includere la versione dell'applicazione nel relativo URL. Un'applicazione visiva senza la versione nel suo URL è chiamata applicazione live. In genere, si distribuisce un'applicazione attiva in un'istanza di produzione.
  • Se si distribuisce una versione di un'applicazione visiva mai distribuita, VB Studio sovrascrive l'ultima versione distribuita con la nuova versione.

    VB Studio non annulla la distribuzione della versione distribuita in precedenza dall'istanza di produzione. Continua a rimanere nell'istanza di destinazione, ma non è accessibile.

  • Se si desidera ridistribuire un'applicazione attiva o una versione distribuita in precedenza, annullare prima la distribuzione, altrimenti la build di distribuzione non riesce. Per annullare la distribuzione di una versione dell'applicazione visiva distribuita in precedenza, configurare un job di build di cui annullare la distribuzione ed eseguirlo. Non è possibile annullare la distribuzione manualmente dalla pagina Ambienti.
  • Se si sta distribuendo un'applicazione in un URL personalizzato, è necessario configurare il job di distribuzione da distribuire nell'ambiente che ospita l'URL personalizzato. È possibile distribuire l'applicazione solo utilizzando l'autenticazione di autenticazione di base, quindi sarà necessario confermare che le credenziali necessarie per la connessione e la distribuzione nell'ambiente sono corrette.
  • Se è stato creato un profilo applicazione per la produzione, recuperarne il nome. Ne avrai bisogno quando configuri il job di distribuzione della produzione.

Creare un job di build per il packaging di produzione

Il job di creazione package di produzione genera un artifact dell'applicazione visiva pronto per la distribuzione.

  1. Nel navigator a sinistra fare clic su Build Build.
  2. Nella scheda Job fare clic su + Crea job.
  3. Nella finestra di dialogo Nuovo job, in Nome, immettere un nome univoco.
  4. In Descrizione, immettere la descrizione del job.
  5. In Modello selezionare il modello Impostazione predefinita sistema OL7 per Visual Builder.
  6. Fare clic su Crea.
  7. Fare clic su Configura Build.
  8. Fare clic sulla scheda Git.
  9. Dall'elenco Aggiungi Git, selezionare Git.
  10. In Repository selezionare il repository Git. In Diramazione o tag selezionare la diramazione di produzione.
  11. Fare clic sulla scheda Passi.
  12. In Aggiungi passo, selezionare Applicazione visiva, quindi selezionare Pacchetto.
  13. Per impostazione predefinita, i job di build riducono il codice sorgente dell'applicazione prima di eseguire la build. Se non si desidera minificare i file di origine, deselezionare la casella di controllo Ottimizza applicazione.
    La minificazione è un processo per rimuovere i caratteri non necessari (ad esempio spazi vuoti, nuove righe e commenti) dal codice sorgente e ridurre le dimensioni dei file, rendendo il trasferimento di file consumare meno larghezza di banda e storage.
  14. Per modificare i nomi predefiniti dei file di archivio, in Nomi file selezionare Usa nomi file personalizzati.
    In Origini, specificare il nome e il percorso del file di archivio di origine dell'applicazione visiva. In Crea artifact, specificare il nome e il percorso del file di archivio dell'artifact build.

    Saranno necessari entrambi i file di archivio per distribuire l'applicazione visiva.

  15. Fare clic sulla scheda Dopo la generazione.
  16. In Aggiungi azione dopo la creazione selezionare Archiviatore artifact.
  17. In File da archiviare, immettere il nome dell'artifact build. È inoltre possibile utilizzare caratteri jolly. Ad esempio, *.zip.
  18. Se si desidera eliminare gli artifact precedenti della build, fare clic su Impostazioni Icona Ingranaggio. Nella scheda Generale selezionare la casella di controllo Elimina vecchie build e specificare le opzioni di eliminazione.
  19. Fare clic su Salva.

Creare un job di build di distribuzione di produzione

Il job di distribuzione di produzione distribuisce l'artifact dell'applicazione visiva generato nel job di packaging di produzione nell'istanza di produzione di Visual Builder. Prima di creare il job, ottenere le credenziali di accesso di un utente che può connettersi e distribuire all'istanza di produzione di Visual Builder.

  1. Nel navigator a sinistra fare clic su Build Build.
  2. Nella scheda Job fare clic su + Crea job.
  3. Nella finestra di dialogo Nuovo job, in Nome, immettere un nome univoco.
  4. In Descrizione, immettere la descrizione del job.
  5. In Modello selezionare il modello Impostazione predefinita sistema OL7 per Visual Builder.
  6. Fare clic su Crea.
  7. Fare clic su Configura Build.
  8. Fare clic sulla scheda Prima della generazione.
  9. In Aggiungi azione prima della build selezionare Copia artifact.
  10. In Da job selezionare il job di creazione package di produzione che ha generato l'artifact dell'applicazione visiva.
  11. In Which Build, selezionare Last Successful Build.
  12. Lasciare gli altri campi con i valori predefiniti o vuoti.
  13. Fare clic sulla scheda Passi.
  14. In Aggiungi passo selezionare Applicazione visiva, quindi selezionare Distribuisci.
  15. In Istanza di destinazione selezionare l'istanza di produzione di Visual Builder.
  16. Nella sezione Autorizzazione specificare il tipo di autorizzazione per eseguire questo passo della build. Se l'opzione Usa OAuth è selezionata per impostazione predefinita, verrà visualizzato il messaggio Authorization is required, che indica che questo passo della build richiede un'autorizzazione una tantum per gestire le richieste OAuth nell'istanza di Visual Builder dell'ambiente. Fare clic su Autorizza e immettere le credenziali per accedere all'istanza di Visual Builder; è inoltre possibile eseguire il job manualmente e immettere le credenziali quando richiesto.

    In entrambi i casi, si consiglia di autorizzare la connessione OAuth durante la configurazione iniziale. Se si salta questo passo, non sarà possibile pubblicare le modifiche dal Designer e sarà necessario completare l'autorizzazione richiesta prima di tentare di distribuire le modifiche.

    Una volta ottenuta l'autorizzazione, viene visualizzato il messaggio Authorization has been provided.

    Nota

    OAuth è il tipo di autorizzazione consigliato. Utilizzare l'autenticazione Basic solo se si verificano problemi durante l'impostazione di una connessione OAuth. Per utilizzare l'autenticazione di base, selezionare Usa base, quindi immettere le credenziali di un utente che può accedere all'istanza di Visual Builder in Nome utente e Password.

    I token OAuth (accesso e aggiornamento) vengono ciclicati durante l'uso regolare. Un token di aggiornamento viene utilizzato per ottenere un token di accesso ogni volta che un utente accede all'istanza di destinazione. Questo token di aggiornamento è in genere valido per sette giorni. L'ora di scadenza del token è impostata nell'applicazione risorsa IDCS e potrebbe essere diversa in base ai requisiti di sicurezza. Se l'utente esegue l'autenticazione con l'istanza di destinazione entro il periodo di sette giorni, il token di aggiornamento attivo genera un nuovo token di accesso e un nuovo token di aggiornamento. Questo ciclo continua indefinitamente finché il token di aggiornamento rimane valido. Se il token di aggiornamento scade durante periodi prolungati di inattività (ad esempio, quando non si è in ferie), fare clic su Rinnova autorizzazione (o eseguire il job manualmente, in modo che venga richiesto di autorizzare eventuali token OAuth scaduti).

  17. Nel processo di creazione package di produzione, se sono stati modificati i nomi file predefiniti dei file artifact di archivio, in Nomi file selezionare Usa nomi file personalizzati.
    In Origini e Genera artifact, immettere gli stessi nomi file (con percorso) specificati nel job di creazione package.

    Se non sono stati modificati i nomi dei file, utilizzare l'opzione predefinita.

  18. (Facoltativo) Se il job di distribuzione sviluppo è stato configurato in modo da sovrascrivere la versione predefinita dell'applicazione, specificare la stessa versione in Versione applicazione. Lasciare vuoto per utilizzare la versione definita nel file visual-application.json dell'applicazione.
    Se la versione è già stata distribuita, annullarne prima la distribuzione.
  19. Deselezionare la casella di controllo Includi la versione dell'applicazione nell'URL.
    Quando si esegue la distribuzione in un'istanza di produzione, non includere la versione dell'applicazione nell'URL dell'applicazione distribuita.
  20. (Facoltativo) In Profilo applicazione specificare il profilo dell'applicazione di produzione. Lasciare vuoto per utilizzare il profilo predefinito dell'applicazione.

    L'applicazione visiva accede ai dati da server diversi per i servizi REST e potrebbe richiedere impostazioni di sicurezza diverse per ambienti diversi, ad esempio sviluppo e produzione. Utilizzando i profili dell'applicazione, è possibile definire diverse combinazioni di server e impostazioni di sicurezza per ciascun ambiente e utilizzarle durante la distribuzione dell'applicazione in un ambiente. Ciò semplifica la gestione dell'applicazione visiva durante il passaggio dallo sviluppo alla produzione. Per ulteriori informazioni, vedere Informazioni sui profili applicazione.

  21. Per utilizzare un database pulito per l'applicazione, in Gestione dati selezionare Usa database pulito.
  22. Fare clic su Salva.

Configurare l'impostazione della privacy di un job di produzione

Contrassegnare un job come privato per limitare chi può visualizzare o modificare la configurazione di un job o eseguirne la build.

Un job privato deve essere eseguito manualmente. Non verrà eseguito se un utente non autorizzato tenta di eseguire il job direttamente, tramite un trigger SCM/periodico o una pipeline.
  1. Nel navigatore a sinistra fare clic su Amministrazione progetto Amministrazione progetto.
  2. Fare clic su Build.
  3. Fare clic sulla scheda Protezione job.
  4. Selezionare un job di produzione dall'elenco dei job.
  5. Selezionare l'opzione Privato.
  6. In Utenti autorizzati, aggiungere se stessi.
    Quindi, per aggiungere altri utenti, selezionarli singolarmente oppure, in Gruppi, selezionare un gruppo (o gruppi) di utenti.
  7. Ripetere i passi da 4 a 6 per il job di produzione di distribuzione.
  8. Fare clic su Salva.

Un job privato mostra un'icona Blocca Blocca nella lista dei job sul lato destro della pagina Protezione job, nella scheda Job della pagina Build e nelle pipeline.

Creare e configurare una pipeline

Per garantire che il job di distribuzione di produzione venga eseguito automaticamente dopo il job di creazione package di produzione, creare una pipeline e impostare la dipendenza.

  1. Nel navigator a sinistra fare clic su Build Build.
  2. Fare clic sulla scheda Pipeline.
  3. Fare clic su + Crea pipeline.
  4. Nella finestra di dialogo Crea pipeline immettere un nome e una descrizione univoci in Nome e Descrizione.
  5. Fare clic su Crea.
  6. Nella pagina Configurazione pipeline, fare clic con il pulsante destro del mouse sul nodo Avvia e selezionare Aggiungi nuovo inizio.
  7. Fare clic nel campo Seleziona nuovo job in caso di operazione riuscita, selezionare il job di creazione package e fare clic su Salva.
  8. Fare clic con il pulsante destro del mouse sul job di creazione package e selezionare Aggiungi, quindi Aggiungi nuovi job in caso di operazione riuscita.
  9. Fare clic nel campo Seleziona nuovo job in caso di operazione riuscita, selezionare il job di distribuzione e fare clic su Salva.

    Di seguito è riportato un esempio di pipeline finalizzata.


    Segue la descrizione dell'immagine visualapp-prod-pipeline3.png
    Descrizione dell'illustrazione visualapp-prod-pipeline3.png

  10. Fare clic su Salva.

Esecuzione della pipeline

Quando si è pronti a distribuire l'applicazione visiva nell'istanza di produzione, eseguire la pipeline di produzione.

  1. Nel navigator a sinistra fare clic su Build Build.
  2. Fare clic sulla scheda Pipeline.
  3. Nella riga della pipeline di sviluppo, fare clic sul menu Azioni Azioni e selezionare Esegui pipeline.

Dopo una build riuscita, il collegamento dell'applicazione distribuita si trova nella scheda Distribuzioni della pagina Ambienti.

Per visualizzare il log build più recente di un job, aprire la pagina Build, fare clic sul nome del job, quindi fare clic su Log build.