Esecuzione di una compilazione (AWS CLI)

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.

Se esegui ilstart-buildcomando con--project-nameopzione, sostituisci<project-name>con il nome del progetto di compilazione, quindi vai al passaggio 6 di questa procedura. Per ottenere un elenco di progetti di compilazione, consulta Visualizzazione di un elenco di nomi di progetti di compilazione.

Se si esegue ilstart-buildcomando con--idempotency-tokenl'opzione, un identificatore o token univoco con distinzione tra maiuscole e minuscole, è inclusa nelstart-buildrichiesta. Il token è valido per 5 minuti dopo la richiesta . Se si ripete la richiesta start-build con lo stesso token, ma si modifica un parametro, CodeBuild restituisce un errore di mancata corrispondenza dei parametri.

Se si esegue il comando start-build con l'opzione --generate-cli-skeleton, i dati in formato JSON appaiono nell'output. Copiare i dati in un file, ad esempio start-build.json, in un percorso nel computer o nell'istanza locale in cui è installato AWS CLI. 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:

Si consiglia di memorizzare una variabile di ambiente con un valore sensibile, ad esempioAWSID della chiave di accesso, unAWSchiave di accesso segreta o password come parametro in Amazon EC2 Systems Manager Parameter Store. CodeBuildpuò utilizzare un parametro memorizzato in Amazon EC2 Systems Manager Parameter Store solo se il nome di quel parametro inizia con/CodeBuild/(ad esempio,/CodeBuild/dockerLoginPassword). È possibile utilizzare ilCodeBuildconsole 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, perChiave KMS, puoi facoltativamente specificare l'ARN di unAWS KMSinserisci il 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 console CodeBuild per creare un parametro, la console inizia il parametro con /CodeBuild/ durante l'archiviazione. Tuttavia, se utilizzi la console Amazon EC2 Systems Manager Parameter Store per creare un parametro, devi iniziare il nome del parametro con/CodeBuild/, e devi impostareTipoaStringa sicura. Per ulteriori informazioni, vedereAWS Systems Managerarchivio parametrieProcedura dettagliata: creazione e test di un parametro String (console)nelGuida per l'utente di Amazon EC2 Systems Manager.

Se il progetto di compilazione si riferisce a parametri memorizzati in Amazon EC2 Systems Manager Parameter Store, il ruolo di servizio del progetto di compilazione deve consentiressm:GetParametersazione. Se in precedenza era stata scelta l'opzione Create a new service role in your account (Crea un nuovo ruolo del servizio nel tuo account), CodeBuild include automaticamente questa operazione nel ruolo del servizio predefinito per il 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:

Per informazioni sui valori validi per questi segnaposto, consultare Creazione di un progetto di compilazione (AWS CLI). Per un elenco delle impostazioni più recenti per un progetto di compilazione, consultare Visualizzazione dei dettagli di un progetto di compilazione.

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

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