View a markdown version of this page

Esegui una build (AWS CLI) - AWS CodeBuild

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à.

Esegui una build (AWS CLI)

Nota

Per CodePipeline utilizzarla per eseguire una build con AWS CodeBuild, salta questi passaggi e segui le istruzioni inCrea una pipeline che utilizza CodeBuild ()AWS CLI.

Per ulteriori informazioni sull'uso di AWS CLI with CodeBuild, consulta ilGuida di riferimento alla riga di comando.

  1. Eseguire il comando start-build in uno dei seguenti modi:

    aws codebuild start-build --project-name <project-name>

    Utilizzare questo comando se si desidera eseguire una compilazione che utilizza la versione più recente dell'artefatto di input di compilazione e le impostazioni correnti del progetto di compilazione.

    aws codebuild start-build --generate-cli-skeleton

    Utilizzare questo comando se si desidera eseguire una compilazione con una versione precedente dell'artefatto di input di compilazione o se si desidera ignorare le impostazioni per gli artefatti di output di compilazione, le variabili di ambiente, la buildspec il periodo di timeout di compilazione predefinito.

  2. Se eseguite il start-build comando con l'--project-nameopzione, sostituitelo <project-name> con il nome del progetto di compilazione, quindi passate al passaggio 6 di questa procedura. Per ottenere un elenco di progetti di compilazione, consulta Visualizza i nomi dei progetti di compilazione.

  3. Se si esegue il start-build comando con l'--idempotency-tokenopzione, nella richiesta viene incluso un identificatore univoco con distinzione tra maiuscole e minuscole. start-build Il token è valido per 5 minuti dopo la richiesta . Se si ripete la start-build richiesta con lo stesso token, ma si modifica un parametro, viene CodeBuild restituito un errore di mancata corrispondenza dei parametri.

  4. Se si esegue il start-build comando con l'--generate-cli-skeletonopzione, JSON-formatted i dati vengono visualizzati nell'output. Copia i dati in un file (ad esempio,start-build.json) in una posizione sul computer locale o sull'istanza in cui AWS CLI è installato. Modificare i dati copiati in modo che corrispondano a questo formato e salvare i risultati:

    {
  "projectName": "projectName",
  "sourceVersion": "sourceVersion",
  "artifactsOverride": {
    "type": "type",
    "location": "location",
    "path": "path",
    "namespaceType": "namespaceType",
    "name": "artifactsOverride-name",
    "packaging": "packaging"
  },
  "buildspecOverride": "buildspecOverride",
  "cacheOverride": {
    "location": "cacheOverride-location",
    "type": "cacheOverride-type"
  },
  "certificateOverride": "certificateOverride",
  "computeTypeOverride": "computeTypeOverride",
  "environmentTypeOverride": "environmentTypeOverride",
  "environmentVariablesOverride": {
    "name": "environmentVariablesOverride-name",
    "value": "environmentVariablesValue",
    "type": "environmentVariablesOverride-type"
  },
  "gitCloneDepthOverride": "gitCloneDepthOverride",
  "imageOverride": "imageOverride",
  "idempotencyToken": "idempotencyToken",
  "insecureSslOverride": "insecureSslOverride",
  "privilegedModeOverride": "privilegedModeOverride",
  "queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
  "reportBuildStatusOverride": "reportBuildStatusOverride",
  "timeoutInMinutesOverride": "timeoutInMinutesOverride",
  "sourceAuthOverride": "sourceAuthOverride",
  "sourceLocationOverride": "sourceLocationOverride",
  "serviceRoleOverride": "serviceRoleOverride",
  "sourceTypeOverride": "sourceTypeOverride"
}

    Sostituire i seguenti segnaposto:

    • projectName: stringa obbligatoria. Il nome del progetto di compilazione da utilizzare per questa compilazione.

    • sourceVersion: Stringa opzionale. Una versione del codice sorgente da creare, come segue:

      • Per Amazon S3, l'ID della versione che corrisponde alla versione del file ZIP di input che desideri creare. Se non sourceVersion è specificato, viene utilizzata la versione più recente.

      • Per CodeCommit, l'ID di commit che corrisponde alla versione del codice sorgente che vuoi creare. Se non sourceVersion è specificato, viene utilizzato l'ID di commit HEAD predefinito del ramo. (Non è possibile specificare un nome per il tagsourceVersion, ma è possibile specificare l'ID di commit del tag.)

      • Per GitHub, l'ID di commit, l'ID della pull request, il nome della filiale o il nome del tag che corrisponde alla versione del codice sorgente che desideri creare. Se si specifica l'ID di una richiesta pull, deve utilizzare il formato pr/pull-request-ID (ad esempio pr/25). Se un nome ramo è specificato, viene utilizzato l'ID commit HEAD del ramo. Se non sourceVersion è specificato, viene utilizzato l'ID di commit HEAD predefinito del ramo.

      • Per Bitbucket, l'ID commit, il nome ramo o il nome del tag che corrisponde alla versione del codice sorgente che si desidera creare. Se un nome ramo è specificato, viene utilizzato l'ID commit HEAD del ramo. Se non sourceVersion è specificato, viene utilizzato l'ID di commit HEAD predefinito del ramo.

    • I seguenti segnaposto sono per artifactsOverride.

      • type: facoltativo. Il tipo di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

      • location: facoltativo. La posizione dell'artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

      • path: facoltativo. Il percorso di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

      • namespaceType: facoltativo. Il tipo di percorso di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

      • name: facoltativo. Il nome di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

      • packaging: facoltativo. Il tipo di pacchetto di artefatto di output di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

    • buildspecOverride: facoltativo. Una dichiarazione di specifiche di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione. Se questo valore è impostato, può essere una definizione buildspec inlinea oppure il percorso a un file buildspec alternativo, relativo al valore della variabile di ambiente CODEBUILD_SRC_DIR incorporata o al percorso di un bucket S3. Il bucket S3 deve trovarsi nella stessa regione AWS del progetto build. Specificare il file buildspec utilizzando il relativo ARN (ad esempio, arn:aws:s3:::<my-codebuild-sample2>/buildspec.yml). Se tale valore non è fornito o è impostato su una stringa vuota, il codice di origine deve contenere un file buildspec.yml nella directory radice. Per ulteriori informazioni, consulta Nome del file buildspec e posizione di storage.

    • I seguenti segnaposto sono per cacheOverride.

      • cacheOverride-location: facoltativo. Il percorso di un oggetto ProjectCache per questa compilazione che sostituisce l'oggetto ProjectCache specificato nel progetto di compilazione. cacheOverride è facoltativo e richiede un oggetto ProjectCache. location è obbligatorio in un oggetto ProjectCache.

      • cacheOverride-type: facoltativo. Il tipo di un oggetto ProjectCache per questa compilazione che sostituisce l'oggetto ProjectCache specificato nel progetto di compilazione. cacheOverride è facoltativo e richiede un oggetto ProjectCache. type è obbligatorio in un oggetto ProjectCache.

    • certificateOverride: facoltativo. Il nome di un certificato per questa compilazione che sostituisce quella definita nel progetto di compilazione.

    • environmentTypeOverride: facoltativo. Un tipo di container per questa compilazione che sostituisce quella definita nel progetto di compilazione. L'attuale stringa valida è LINUX_CONTAINER.

    • I seguenti segnaposto sono per environmentVariablesOverride.

      • environmentVariablesOverride-name: facoltativo. Il nome di una variabile di ambiente nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione.

      • environmentVariablesOverride-type: facoltativo. Il tipo di variabile di ambiente nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione.

      • environmentVariablesValue: facoltativo. Il valore della variabile di ambiente definita nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione.

    • gitCloneDepthOverride: facoltativo. Il valore di Git clone depth nel progetto di compilazione il quale valore si desidera ignorare per questa compilazione. Se il tipo di origine è Amazon S3, questo valore non è supportato.

    • imageOverride: facoltativo. Il nome di un immagine per questa compilazione che sostituisce quella definita nel progetto di compilazione.

    • idempotencyToken: facoltativo. Una stringa che serve come token per specificare che la richiesta di compilazione è idempotente. È possibile scegliere qualsiasi stringa con 64 caratteri o meno. Il token è valido per 5 minuti dopo la richiesta start-build. Se ripeti la richiesta start-build con lo stesso token, ma modifichi un parametro, CodeBuild restituisce un errore di mancata corrispondenza dei parametri.

    • insecureSslOverride: valore booleano opzionale che specifica se sovrascrivere l'impostazione TLS non sicura specificata nel progetto di compilazione. L'impostazione TLS non sicura determina se ignorare gli avvisi TLS durante la connessione al codice sorgente del progetto. Questa sostituzione si applica solo se l'origine della build è Enterprise Server. GitHub

    • privilegedModeOverride: valore booleano opzionale. Se impostato su true, la compilazione sostituisce la modalità privilegiata nel progetto di compilazione.

    • queuedTimeoutInMinutesOverride: numero intero opzionale che specifica il numero di minuti in cui una build può essere messa in coda prima del timeout. Il valore minimo è cinque minuti e il valore massimo è 480 minuti (8 ore).

    • reportBuildStatusOverride: valore booleano opzionale che specifica se inviare al fornitore di sorgenti lo stato di inizio e completamento di una compilazione. Se lo imposti con un provider di origine diverso GitHub da GitHub Enterprise Server o Bitbucket, viene generato un codice non valido. InputException

    • sourceAuthOverride: stringa opzionale. Un tipo di autorizzazione per questa compilazione che sostituisce quella definita nel progetto di compilazione. Questa sostituzione si applica solo se l'origine del progetto di compilazione è Bitbucket o. GitHub

    • sourceLocationOverride: stringa opzionale. Il percorso che, per questa compilazione, sostituisce il percorso di origine definito nel progetto di compilazione.

    • serviceRoleOverride: Stringa opzionale. Il nome di un ruolo del servizio per questa compilazione che sostituisce quella definita nel progetto di compilazione.

    • sourceTypeOverride: Stringa opzionale. Un tipo di input di origine per questa compilazione che sostituisce l'input di origine definito nel progetto di compilazione. Le stringhe valide sono NO_SOURCE, CODECOMMIT, CODEPIPELINE, GITHUB, S3, BITBUCKET e GITHUB_ENTERPRISE.

    • timeoutInMinutesOverride: numero opzionale. Il numero di minuti di timeout di compilazione che, per questa compilazione, sostituisce quella definita nel progetto di compilazione.

    Ti consigliamo di memorizzare una variabile di ambiente con un valore sensibile, ad esempio un ID della chiave di AWS accesso, una chiave di accesso AWS segreta o una password come parametro in Amazon EC2 Systems Manager Parameter Store. CodeBuild è possibile utilizzare un parametro memorizzato in Amazon EC2 Systems Manager Parameter Store solo se il nome del parametro inizia con /CodeBuild/ (ad esempio,/CodeBuild/dockerLoginPassword). Puoi utilizzare la CodeBuild console per creare un parametro in Amazon EC2 Systems Manager. Selezionare Create a parameter (Crea un parametro) e seguire le istruzioni. (In quella finestra di dialogo, per la chiave KMS, puoi facoltativamente specificare l'ARN di una AWS KMS chiave nel tuo account. Amazon EC2 Systems Manager utilizza questa chiave per crittografare il valore del parametro durante l'archiviazione e decrittografarlo durante il recupero.) Se si utilizza la CodeBuild console per creare un parametro, la console avvia il parametro con /CodeBuild/ il momento in cui viene archiviato. Tuttavia, se utilizzi la console Amazon EC2 Systems Manager Parameter Store per creare un parametro, devi iniziare il nome del parametro con /CodeBuild/ e impostare Type su Secure String. Per ulteriori informazioni, consulta AWS Systems Manager Parameter Store e Walkthrough: Create and test a String parameter (console) nella Amazon EC2 Systems Manager User Guide.

    Se il progetto di compilazione fa riferimento a parametri memorizzati in Amazon EC2 Systems Manager Parameter Store, il ruolo di servizio del progetto di compilazione deve consentire l'azione. ssm:GetParameters Se in precedenza hai scelto Crea un nuovo ruolo di servizio nel tuo account, CodeBuild include automaticamente questa azione nel ruolo di servizio predefinito per il tuo progetto di compilazione. Tuttavia, se era stata scelta l'opzione Choose an existing service role from your account (Scegli un ruolo del servizio esistente dal tuo account), è necessario includere questa operazione al ruolo del servizio separatamente.

    Le variabili di ambiente impostate sostituiscono quelle esistenti. Ad esempio, se l'immagine Docker contiene già una variabile di ambiente denominata MY_VAR con un valore di my_value, e si imposta una variabile di ambiente denominata MY_VAR con un valore di other_value, il valore my_value viene sostituito da other_value. Allo stesso modo, se l'immagine Docker contiene già una variabile di ambiente denominata PATH con un valore di /usr/local/sbin:/usr/local/bin, e si imposta una variabile di ambiente denominata PATH con un valore di $PATH:/usr/share/ant/bin, il valore di /usr/local/sbin:/usr/local/bin viene sostituito dal valore letterale $PATH:/usr/share/ant/bin.

    Non impostare variabili di ambiente con nomi che iniziano con CODEBUILD_. Questo prefisso è riservato per l'uso interno .

    Se una variabile di ambiente con lo stesso nome viene definita in più luoghi, il valore della variabile di ambiente viene determinato come segue:

    • Il valore della chiamata all'operazione di inizio della compilazione ha la massima priorità.

    • Il valore della definizione del progetto di compilazione è il seguente in ordine di priorità.

    • Il valore della dichiarazione buildspec ha la minima priorità.

    Per informazioni sui valori validi per questi segnaposto, consultare Crea un progetto di compilazione (AWS CLI). Per un elenco delle impostazioni più recenti per un progetto di compilazione, consultare Visualizza i dettagli del progetto di costruzione.

  5. Passare alla directory contenente il file appena salvato ed eseguire nuovamente il comando start-build.

    aws codebuild start-build --cli-input-json file://start-build.json

  6. In caso di esito positivo, nell'output vengono visualizzati dati simili a quelli descritti nella procedura Per eseguire la build.

Per utilizzare le informazioni dettagliate su questa compilazione, annotare il valore id nell'output e consultare Visualizzazione dei dettagli delle compilazioni (AWS CLI).