Documentazione di Oracle Cloud Infrastructure

Aggiunta di una fase di build gestita

Aggiungere una fase di build gestita nella pipeline di build.

È necessario aggiungere repository di codici in questa fase per la build. Prima di aggiungere la fase Build gestita, è necessario configurare i repository. Per creare i repository, vedere Gestione dei repository di codici.

Prima di aggiungere una fase, è necessario disporre di una pipeline di build.

Per accedere a DevOps utilizzando la console di Oracle Cloud, l'API REST e l'interfaccia CLI, vedere Accesso a DevOps.

    1. Aprire il menu di navigazione e fare clic su Servizi per sviluppatori. In DevOps fare clic su Progetti.
    2. Selezionare un progetto e una pipeline di build.
    3. Per aggiungere una fase alla pipeline, fare clic sull'icona + e selezionare Aggiungi fase.
    4. Per il tipo di fase, selezionare Build gestito, quindi fare clic su Avanti.
    5. Immettere un nome e una descrizione per lo stadio. L'aggiunta di una descrizione è facoltativa.
    6. Selezionare la forma del motore di esecuzione build.

      È possibile selezionare la forma predefinita (opzione di avvio rapido) oppure personalizzare selezionando il numero richiesto di OCPU e la quantità di memoria (in GB). Il provisioning della personalizzazione richiede più tempo.

    7. Selezionare Oracle Linux 7 come immagine del contenitore di base.
    8. (Opzionale) Per accedere alla rete virtuale privata:
      1. Selezionare una rete cloud virtuale (VCN) e una subnet regionale nella tenancy.
      2. (Facoltativo) Per limitare l'accesso alla VCN, è possibile selezionare i gruppi di sicurezza di rete (NSG) nelle VCN.

      La risoluzione DNS (Domain Name System) interna delle reti VCN non è supportata per l'accesso privato. Utilizzare gli IP per comunicare con i servizi ospitati nella rete privata.

    9. (Facoltativo) Immettere il percorso per il file di specifica della build.

      La specifica di build contiene i passi e le impostazioni di build utilizzati dalla pipeline di build per eseguire una build.

      Nota

      Questo passo è necessario solo se il file di specifica della build, build_spec.yaml, non si trova nella directory radice del repository di codici primario.
    10. Selezionare il repository di codici primario per la build.
      • Selezionare il tipo di connessione e una connessione per il repository. Di seguito sono riportati i tipi di connessione supportati.

        Solo le connessioni esterne già configurate sono disponibili per la selezione. Se non esistono connessioni, fare clic sul collegamento Crea una connessione.

      • Se si seleziona GitHub o GitLab, selezionare un repository.
      • Se si seleziona Bitbucket Cloud, selezionare un'area di lavoro e un repository.
      • Se si seleziona Visual Builder Studio (VBS), selezionare un progetto VBS esterno e un repository.
      • Se si seleziona Server Bitbucket o Server GitLab, immettere l'URL del repository che contiene l'origine build.
      • Selezionare o immettere una diramazione per il repository di codici selezionato.

        La build viene eseguita nella diramazione che attiva l'esecuzione della build e non dalla diramazione configurata durante l'aggiunta della fase di build. La diramazione configurata può essere utilizzata quando l'esecuzione della build viene attivata manualmente tramite OCI Console.

      • Per Nome origine build, immettere un nome univoco per la cartella in cui viene scaricato il codice sorgente sul motore di esecuzione build. Esempi: Source1, Source2.
      • Salvare le modifiche.
    11. Per aggiungere altri repository di codici, fare clic su Aggiungi origine build e selezionare i repository.
    12. (Facoltativo) Immettere un valore di timeout (in secondi) per la fase.
    13. (Facoltativo) Per aggiungere tag alla fase, fare clic su Mostra opzioni di applicazione tag. L'applicazione di tag è un sistema di metadati che consente di organizzare e tenere traccia delle risorse nella tenancy.

      Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per aggiungervi tag in formato libero.

      Per aggiungere una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag.

      Per ulteriori informazioni, vedere Tag delle risorse.

    14. Per aggiungere lo stadio alla pipeline, fare clic su Aggiungi.

      Un'anteprima fase fornisce uno snapshot della configurazione.

    È possibile aggiungere le fasi seguenti in sequenza o in parallelo alla pipeline:
    • Distribuisci artifact: memorizza le applicazioni software create dalla fase Build gestita nei repository OCI (Oracle Cloud Infrastructure) Artifact Registry o OCI Container Registry.
    • Attiva distribuzione: avvia una pipeline di distribuzione per distribuire l'output dalla pipeline di build.
    • Attendi: sospende una durata specifica per il test della pipeline di build.

    È possibile eseguire la build manualmente o attivare automaticamente un'esecuzione della build quando si eseguono il commit delle modifiche nel repository di codici. L'esecuzione manuale utilizza il commit più recente nel repository di codici. È possibile eseguire la build in base a un commit specifico annotando i dettagli del commit.

  • Per creare una pipeline di build, eseguire il comando create:

    oci devops build-pipeline create --project-id

    Per aggiungere una fase di build gestita per la pipeline, eseguire il comando create-build-stage:

    oci devops build-pipeline-stage create-build-stage

    I parametri obbligatori sono i seguenti:

    • --build-pipeline-id
    • --build-source-collection
    • --image
    • --stage-predecessor-collection

    Il parametro facoltativo per la configurazione della forma del motore di esecuzione build è:

    --build-runner-config

    Per ottenere tutti i comandi per build-pipeline e build-pipeline-stage:

    oci devops build-pipeline -h
    oci devops build-pipeline-stage -h

    Per ottenere assistenza per il comando create-build-stage:

    oci devops build-pipeline-stage create-build-stage -h

  • Per creare una pipeline di build, utilizzare l'operazione CreateBuildPipeline.

    Per aggiungere una fase di build gestita per la pipeline, utilizzare l'operazione CreateBuildPipelineStage. Per l'attributo buildPipelineStageType, specificare il valore come BUILD.

    Oltre alla richiesta CreateBuildStageDetails, è necessario aggiungere uno degli attributi specificati per personalizzare la forma del motore di esecuzione della build:

    .buildRunnerShapeConfig(CustomBuildRunnerShapeConfig.builder().ocpus(<no_of_ocpus>).memoryInGBs(<memory_in_gbs>).build())
    .buildRunnerShapeConfig(DefaultBuildRunnerShapeConfig.builder().build())