Documentazione di Oracle Cloud Infrastructure

Crea e configura job di build produzione

È necessario impostare alcuni job di creazione package e distribuzione prima di poter distribuire applicazioni Visual nell'istanza di produzione di Visual Builder. Questo argomento spiega come eseguire questa operazione.

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

  • Nel job di packaging di produzione, utilizzare il ramo di produzione del repository Git per generare gli artifact di produzione.
  • Nel job di creazione package di sviluppo, se sono stati modificati i nomi file predefiniti dei file artifact di archivio, ottenere i nuovi nomi e i relativi percorsi. Ne avrai bisogno quando configuri il processo di confezionamento di produzione.
  • Se è stato configurato il job di creazione package di sviluppo per sovrascrivere la versione dell'applicazione definita in visual-application.json, ottenere la nuova versione. Ne avrai bisogno quando configuri il processo di confezionamento di produzione.
  • Durante la configurazione dei job di build della 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 che non è mai stata 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. L'istanza 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 annullamento della 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 per la distribuzione nell'ambiente che ospita l'URL personalizzato. È possibile distribuire l'applicazione solo utilizzando l'autenticazione di autenticazione di base, pertanto sarà necessario confermare che le credenziali necessarie per connettersi e distribuire all'ambiente sono corrette.
  • Se è stato creato un profilo applicazione per la produzione, recuperarne il nome. Ne avrai bisogno quando configuri il job di distribuzione di produzione.

Creare un job di creazione package 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, immettere un nome univoco in Nome.
  4. In Descrizione, immettere la descrizione del job.
  5. In Modello selezionare il modello Valore predefinito di sistema OL7 per Visual Builder.
  6. Fare clic su Crea.
  7. Fare clic su Configura Build.
  8. Fare clic sulla scheda Git.
  9. Nell'elenco Aggiungi Git, selezionare Git.
  10. In Repository, selezionare il repository Git. In Diramazione o tag, selezionare il ramo di produzione.
  11. Fare clic sulla scheda Steps.
  12. In Aggiungi passo, selezionare Applicazione visiva, quindi Pacchetto.
  13. Per impostazione predefinita, i job di build riducono il codice di origine dell'applicazione prima di eseguire la build. Se non si desidera ridurre i file di origine, deselezionare la casella di controllo Ottimizza applicazione.
    La minimizzazione è un processo per rimuovere i caratteri non necessari (come spazi vuoti, nuove righe e commenti) dal codice sorgente e ridurre le dimensioni dei file, rendendo il trasferimento dei file richiede meno larghezza di banda e spazio di archiviazione.
  14. Per modificare i nomi predefiniti dei file dell'archivio, in nomi dei file selezionare Usa nomi di file personalizzati.
    In Origini specificare il nome e il percorso del file di archivio dell'origine dell'applicazione visiva. In Genera artifact specificare il nome e il percorso del file di archivio dell'artifact della build.

    Per distribuire l'applicazione visiva sono necessari entrambi i file di archivio.

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

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 creazione package di produzione nell'istanza di produzione di Visual Builder. Prima di creare il job, ottenere le credenziali di accesso di un utente in grado di 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, immettere un nome univoco in Nome.
  4. In Descrizione, immettere la descrizione del job.
  5. In Modello selezionare il modello Valore predefinito di sistema OL7 per Visual Builder.
  6. Fare clic su Crea.
  7. Fare clic su Configura Build.
  8. Fare clic sulla scheda Prima della build.
  9. In Aggiungi azione prima della generazione, selezionare Copia artifact.
  10. In Dal job selezionare il job di creazione package di produzione che ha generato l'artifact dell'applicazione Visual.
  11. In Quale build è riuscita selezionare Ultima build riuscita.
  12. Lasciare gli altri campi con i relativi valori predefiniti o vuoti.
  13. Fare clic sulla scheda Steps.
  14. In Aggiungi passo, selezionare Applicazione visiva, quindi 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. Con 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 all'istanza di Visual Builder dell'ambiente in uso. 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 autorizzato, 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 Basic, selezionare Usa Basic, 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 attivati 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 delle risorse IDCS e può 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 a tempo indeterminato finché il token di aggiornamento rimane valido. Se il token di aggiornamento scade durante lunghi periodi di inattività (ad esempio, quando si è in vacanza), fare clic su Rinnova autorizzazione (oppure eseguire il job manualmente, quindi viene richiesto di autorizzare eventuali token OAuth scaduti).

  17. Nel job 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 Crea artifact, immettere gli stessi nomi di file (con percorso) specificati nel job di packaging.

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

  18. (Facoltativo) Se il job di distribuzione sviluppo è stato configurato per 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, prima annullare la distribuzione.
  19. Deselezionare la casella di controllo Includi la versione dell'applicazione nell'URL.
    Durante 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 applicazione, è possibile definire diverse combinazioni di server e impostazioni di sicurezza per ciascuno degli ambienti 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 suSalva.

Configura impostazioni privacy di un job di produzione

Contrassegnare un job come privato per limitare gli utenti che possono 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 Navigator a sinistra, fare clic su Amministrazione progetto Amministrazione del progetto.
  2. Fare clic su Build.
  3. Fare clic sulla scheda Protezione job.
  4. Nell'elenco di job selezionare un job di produzione.
  5. Selezionare l'opzione Privato.
  6. In Utenti autorizzati, aggiungere se stessi.
    Quindi, per aggiungere altri utenti, selezionarli singolarmente o, 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 suSalva.

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

Crea e configura 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 i job Aggiungi nuovo avvio.
  7. Fare clic nel campo Seleziona nuovo/i job riusciti, selezionare il job di packaging 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/i job riusciti, selezionare il job di distribuzione e fare clic su Salva.

    Ecco un esempio della pipeline finalizzata:


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

  10. Fare clic suSalva.

Esegui 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 verrà trovato 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 Genera log.