Documentazione di Oracle Cloud Infrastructure

Distribuzione in un gruppo di istanze

Creare una pipeline per distribuire gli artifact ai gruppi di istanze.

Prerequisiti

Di seguito sono riportati i prerequisiti per distribuire gli artifact a un gruppo di istanze.

  • Disporre di una pipeline di distribuzione, di un ambiente del gruppo di istanze da distribuire e di artifact. Gli artifact possono essere definiti in linea o posizionati nel registro artifact.

    La distribuzione DevOps supporta la distribuzione di più artifact in una fase. Ad esempio, la distribuzione di un gruppo di istanze definisce i comandi ed esegue i passi per scaricare l'artifact del package di applicazioni dal registro artifact specificato e posizionarlo nel file system dell'istanza di computazione di destinazione. Vedere File di configurazione della distribuzione.

  • Il plugin Comando esecuzione istanza di computazione deve essere abilitato nell'istanza e il plugin deve essere in esecuzione. Per abilitare il plugin, seguire questa procedura:
    1. Nella console, aprire il menu di navigazione e fare clic su Computazione. In Calcolo fare clic su Istanze.
    2. Selezionare un'istanza dal gruppo di istanze in cui eseguire la distribuzione.
      Nota

      DevOps supporta solo le distribuzioni dei gruppi di istanze in Oracle Linux e CentOS.
    3. Fare clic sulla scheda Agente Oracle Cloud.

    4. Per il plugin Comando esecuzione istanza di computazione, attivare o disattivare l'opzione Plugin abilitato su Abilitato.

      Per rendere effettiva la modifica occorrono fino a 10 minuti.

      Attenzione

      La funzionalità che dipende dal plugin, ad esempio il monitoraggio, il ridimensionamento automatico, la distribuzione o la gestione del sistema operativo, non funziona quando il plugin è disabilitato.
      Attenzione

      Per distribuire le applicazioni utilizzando il plugin Comando esecuzione istanza di computazione, è necessario configurare e gestire in modo appropriato i criteri con privilegi minimi. Per ulteriori informazioni, vedere Esecuzione dei comandi in un'istanza.

      Per informazioni sulla gestione dei plugin, vedere Gestione dei plugin con l'agente Oracle Cloud. Per la risoluzione dei problemi, vedere Risoluzione dei problemi di Oracle Cloud Agent.

  • Disporre dell'autorizzazione per eseguire comandi sull'istanza. Consulta il criterio IAM (Identity and Access Management) richiesto.

Per creare gruppi dinamici e criteri per le pipeline di distribuzione, vedere Criteri di pipeline di distribuzione. Per ulteriori dettagli, consulta DevOps Criteri IAM.

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 distribuzione.
    3. Per aggiungere una fase alla pipeline, fare clic sull'icona + e selezionare Aggiungi fase.
    4. Per il tipo di fase, selezionare Distribuisci - Gruppo di istanze, quindi fare clic su Successivo.
    5. Immettere un nome e una descrizione per lo stadio. L'aggiunta di una descrizione è facoltativa.
    6. Per Ambiente, selezionare un gruppo di istanze esistente.
    7. Fare clic su Seleziona artifact e selezionare gli artifact di configurazione della distribuzione del gruppo di istanze disponibili da distribuire.

      Il file di configurazione della distribuzione definisce gli artifact da scaricare nell'istanza e la posizione in cui devono essere copiati. Per ulteriori informazioni, vedere File di configurazione della distribuzione.

    8. (Facoltativo) Fare clic su Seleziona artifact per aggiungere altri artifact di cui viene eseguito il download nelle istanze di computazione durante la distribuzione.

      Questi artifact aggiuntivi non devono essere definiti in linea.

    9. (Facoltativo) Fare clic su Seleziona load balancer. Il load balancer deve essere disponibile nella console.
      1. Selezionare l'area e il compartimento del load balancer.
      2. Selezionare un load balancer dalla lista disponibile.

      Il load balancer distribuisce il traffico di produzione durante la distribuzione. Per ulteriori informazioni, vedere Gestione del load balancer.

    10. Per aggiungere un listener al load balancer, fare clic su Seleziona listener.

      I listener controllano la presenza di traffico in entrata nell'indirizzo IP del load balancer. Per ulteriori informazioni, vedere Gestione del listener.

    11. Per eseguire automaticamente il rollback all'ultima versione di release riuscita se la convalida non riesce, selezionare Sì. Per ulteriori informazioni, vedere Ripristino di una distribuzione.
    12. Il criterio di rinnovo controlla la frequenza e il comportamento del rollout dell'istanza nell'ambiente di destinazione. Selezionare una delle opzioni seguenti.
      • Rinnovo per percentuale: inserire una percentuale compresa tra 1 e 100. Questo valore controlla la percentuale massima di istanze distribuite o non in esecuzione alla volta.
      • Rinnovo per conteggio: immettere il valore del conteggio. Questo valore controlla il numero massimo di istanze distribuite o non in esecuzione alla volta.
    13. (Facoltativo) In Ritardo tra batch, immettere una durata in secondi.
    14. (Facoltativo) Il criterio di errore definisce i criteri di errore per una fase. Può essere definito in base al numero di host di computazione con errori in un gruppo di istanze. Selezionare una delle opzioni seguenti.
      • Nessuna.
      • Errore per percentuale: inserire la percentuale tra 1 e 100. Questo valore definisce la percentuale di host di calcolo che non riescono dopo la quale lo stadio non riesce.
      • Errore per conteggio: immettere il valore del conteggio. Questo valore definisce il numero di host di calcolo che non riescono dopo il quale lo stadio non riesce.
    15. (Facoltativo) Per aggiungere tag alla pipeline, 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.

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

      Un'anteprima fase fornisce uno snapshot della configurazione.

    Aggiungere altre fasi in sequenza o in parallelo alla pipeline, se necessario. Per distribuire l'output della build nell'ambiente di destinazione, eseguire la pipeline di distribuzione.

    È possibile aggiungere 100 fasi parallele alla pipeline di distribuzione, ma il plugin Esegui comando supporta solo cinque comandi su un'istanza. È pertanto necessario disporre di istanze sufficienti per eseguire 100 distribuzioni di gruppi di istanze parallele.

    Per attivare automaticamente una distribuzione dalla pipeline di build, è possibile aggiungere una fase di distribuzione del trigger alla pipeline di build.

  • Per creare una fase del gruppo di istanze, eseguire il comando create-deploy-compute-instance-group-stage:

    oci devops deploy-stage create-deploy-compute-instance-group-stage

    Parametri richiesti per il comando create-deploy-compute-instance-group-stage:

    • --compute-instance-group-environment-id
    • --deployment-spec-artifact-id
    • --rollout-policy
    • --pipeline-id
    • --stage-predecessor-collection

    Per ottenere tutti i comandi per deploy-stage:

    oci devops deploy-stage -h

    Per ottenere assistenza per il comando create-deploy-compute-instance-group-stage:

    oci devops deploy-stage create-deploy-compute-instance-group-stage -h

  • Per creare una fase di distribuzione del gruppo di istanze per la pipeline, utilizzare l'operazione CreateDeployStage. Per l'attributo deployStageType, specificare il valore COMPUTE_INSTANCE_GROUP_ROLLING_DEPLOYMENT.