Esempio di filtro di webhook e richiesta pull Bitbucket per CodeBuild - AWS CodeBuild
PrerequisitiCreazione di un progetto di compilazione con Bitbucket come repository di origine e abilitazione dei webhookAttivazione di una compilazione con un webhook bitbucket

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempio di filtro di webhook e richiesta pull Bitbucket per CodeBuild

AWS CodeBuildsupporta i webhook quando il repository di origine è Bitbucket. Ciò significa che per unCodeBuildSe si crea un progetto il cui codice sorgente è memorizzato in un repository Bitbucket, i webhook possono essere utilizzati per ricostruire il codice sorgente ogni volta che viene inserita una modifica al codice nel repository. Per ulteriori informazioni, consulta Eventi webhook Bitbucket.

Questo esempio mostra come creare una richiesta pull tramite un repository Bitbucket. Mostra anche come utilizzare un webhook Bitbucket per attivare CodeBuild per creare una compilazione di un progetto.

Nota

Quando si utilizzano i webhook, è possibile che un utente attivi una build inaspettata. Per mitigare questo rischio, vediBest practice per l'utilizzo di webhook.

Prerequisiti

Per eseguire questo esempio è necessario connettersi al progetto di AWS CodeBuild con l'account Bitbucket.

Nota

CodeBuild ha aggiornato le sue autorizzazioni con Bitbucket. Se il progetto è stato connesso al Bitbucket prima di queste autorizzazioni e ora si sta riscontrando un errore di connessione Bitbucket, è necessario connetterlo nuovamente per concedere l'autorizzazione ad CodeBuild per gestire i webhook.

Creazione di un progetto di compilazione con Bitbucket come repository di origine e abilitazione dei webhook

Le fasi seguenti descrivono come creare un progetto di AWS CodeBuild con Bitbucket come repository di origine e come abilitare i webhook.

  1. Aprire ilAWS CodeBuildconsole all'indirizzohttps://console.aws.amazon.com/codesuite/codebuild/home.

  2. Se unCodeBuildViene visualizzata la pagina delle informazioni, scegliCrea un progetto di costruzione. Altrimenti, nel riquadro di navigazione, espandiCostruisci, scegliCostruisci progettie poi scegliCrea un progetto di costruzione.

  3. Scegliere Create build project (Crea progetto di compilazione).

  4. In Project configuration (Configuratore progetto):

    Project name (Nome progetto)

    Inserisci un nome per questo progetto di compilazione. I nomi dei progetti di compilazione devono essere univoci per ogni account AWS. Puoi anche includere una descrizione opzionale del progetto di compilazione per aiutare gli altri utenti a capire a cosa serve questo progetto.

  5. In Source (Origine):

    Fornitore di origine

    ScegliBitbucket. Segui le istruzioni per connetterti (o riconnetterti) con Bitbucket e poi scegliAutorizza.

    Repository

    ScegliRepository nel mio account Bitbucket.

    Se non ti sei connesso in precedenza al tuo account Bitbucket, inserisci il nome utente e la password dell'app Bitbucket e selezionaSalva le credenziali Bitbucket.

    Repository Bitbucket

    Inserisci l'URL del tuo repository Bitbucket.

  6. InEventi webhook di origine primaria, seleziona quanto segue.

    Nota

    LaEventi webhook di origine primariala sezione è visibile solo se hai sceltoRepository nel mio account Bitbucketnel passaggio precedente.

    1. Al momento della creazione di un progetto, selezionare Rebuild every time a code change is pushed to this repository (Ricompila ogni volta che viene inviata una modifica del codice a questo repository).

    2. Da Event type (Tipo di evento), selezionare uno o più eventi.

    3. Per applicare un filtro che stabilisce quando un evento avvia una compilazione, in Start a build under these conditions (Avvia una compilazione in queste condizioni) aggiungere uno o più filtri facoltativi.

    4. Per applicare un filtro che stabilisce quando un evento non avvia una compilazione, in Don't start a build under these conditions (Non avviare una compilazione in queste condizioni) aggiungere uno o più filtri facoltativi.

    5. ScegliAggiungi gruppo di filtriper aggiungere un altro gruppo di filtri, se necessario.

    Per ulteriori informazioni sui tipi di eventi e sui filtri del webhook di Bitbucket, consultaEventi webhook Bitbucket.

  7. In Environment (Ambiente):

    Immagine dell'ambiente

    Scegli una delle seguenti opzioni:

    Per utilizzare un'immagine Docker gestita daAWS CodeBuild:

    ScegliImmagine gestita, quindi effettuare selezioni dasistema operativo,Durata (i),Immagine, eVersione dell'immagine. Se disponibile, eseguire una selezione da Environment type (Tipo ambiente).

    Per usare un'altra immagine Docker:

    ScegliImmagine personalizzata. PerTipo di ambiente, scegliBRACCIO,Linux,GPU Linux, oppurefinestre. Se si sceglie Other registry (Altro registro), fin External registry URL (URL registro esterno), inserire il nome e il tag dell'immagine Docker in Docker Hub, utilizzando il formato docker repository/docker image name. Se scegliAmazon ECR, usaRepository Amazon ECReImmagine Amazon ECRper scegliere l'immagine Docker nel tuoAWSaccount.

    Per usare un'immagine Docker privata:

    ScegliImmagine personalizzata. PerTipo di ambiente, scegliBRACCIO,Linux,GPU Linux, oppurefinestre. Per Image registry (Registro immagine), selezionare Other registry (Altro registro), quindi immettere l'ARN delle credenziali per l'immagine Docker privata. Le credenziali devono essere create da Secrets Manager. Per ulteriori informazioni, consulta Che cos'è AWS Secrets Manager? nella Guida per l'utente di AWS Secrets Manager.

    Ruolo di servizio

    Scegli una delle seguenti opzioni:

    • Se non si dispone di unCodeBuildruolo di servizio, scegliNuovo ruolo di servizio. NelNome del ruolo, inserisci un nome per il nuovo ruolo.

    • Se hai unCodeBuildruolo di servizio, scegliRuolo di servizio esistente. NelRuolo ARN, scegli il ruolo di servizio.

    Nota

    Quando utilizzi la console per creare o aggiornare un progetto di compilazione, è possibile creare contemporaneamente un ruolo del servizio CodeBuild. Per impostazione predefinita, il ruolo funziona solo con tale progetto di compilazione. Se si utilizza la console per associare questo ruolo del servizio con un altro progetto di compilazione, il ruolo viene aggiornato per funzionare con l'altro progetto. Un ruolo del servizio può funzionare con un massimo di 10 progetti di compilazione.

  8. InSpecifiche di costruzione, esegui una delle seguenti operazioni:

    • ScegliUsa un file buildspecper utilizzare il file buildspec.yml nella directory principale del codice sorgente.

    • ScegliInserisci i comandi di compilazioneper utilizzare la console per inserire i comandi di compilazione.

    Per ulteriori informazioni, consulta la Riferimento per buildspec.

  9. In Artifacts (Artefatti):

    Type (Tipo)

    Scegli una delle seguenti opzioni:

    • Se non si desidera creare artefatti di output di compilazione, scegliere No artifacts (Nessun artefatto).

    • Per memorizzare l'output della build in un bucket S3, scegliAmazon S3, quindi procedi come segue:

      • Se desideri utilizzare il tuo nome di progetto per la cartella o il file ZIP di output di compilazione, lascia vuoto il campo Name (Nome). In caso contrario, digitare il nome. Per impostazione predefinita, il nome dell'artefatto è quello del progetto. Se si desidera utilizzare un nome diverso, immetterlo nella casella del nome degli artefatti. Se si desidera eseguire l'output di un file .ZIP, includere l'estensione .zip.

      • Per Bucket name (Nome bucket) selezionare il nome del bucket di output.

      • Se hai scelto Insert build commands (Inserisci comandi di compilazione) in una fase precedente di questa procedura, quindi per Output files (File di output), immetti le posizioni dei file di compilazione che desideri inserire nella cartella o nel file ZIP dell'output di compilazione. Per più posizioni, separarne ognuna con una virgola (per esempio, appspec.yml, target/my-app.jar). Per ulteriori informazioni, consultare la descrizione di files in Sintassi buildspec.

    Configurazione aggiuntiva

    Espandere Additional configuration (Configurazione aggiuntiva) e impostare le opzioni come opportuno.

  10. Scegliere Create build project (Crea progetto di compilazione). Nella pagina Review (Verifica), selezionare Start build (Avvia compilazione) per eseguire la compilazione.

Attivazione di una compilazione con un webhook bitbucket

Per un progetto che utilizza webhook Bitbucket, AWS CodeBuild crea una compilazione nel momento in cui il repository di Bitbucket individua una modifica al codice sorgente.

  1. Apri ilAWS CodeBuildconsole all'indirizzohttps://console.aws.amazon.com/codesuite/codebuild/home.

  2. Nel riquadro di navigazione, selezionare Build projects (Compilare progetti), quindi selezionare un progetto associato a un repository di Bitbucket con webhook. Per informazioni sulla creazione di un progetto webhook Bitbucket, consultaCreazione di un progetto di compilazione con Bitbucket come repository di origine e abilitazione dei webhook.

  3. Apportare modifiche al codice nel repository Bitbucket del progetto.

  4. Creare una richiesta pull nel repository Bitbucket. Per ulteriori informazioni, consultare l'articolo relativo alla creazione di una richiesta pull.

  5. Nella pagina dei webhook Bitbucket, selezionare View request (Visualizzare richiesta) per visualizzare un elenco di eventi recenti.

  6. Scegliere View details (Mostra dettagli) per consultare i dettagli relativi alla risposta restituiti da CodeBuild. Potrebbe essere simile al seguente: 

    "response":"Webhook received and build started: https://us-east-1.console.aws.amazon.com/codebuild/home..."
"statusCode":200

  7. Navigare alla pagina della richiesta pull Bitbucket per visualizzare lo stato della compilazione.