Utilizzo del controllo versioni semantico per assegnare i nomi agli artefatti di compilazione di esempio

Questo campione contiene esempi di file di specifiche di compilazione che spiegano come specificare il nome di un artefatto che viene creato durante il processo di compilazione. Il nome specificato nel file di specifiche di compilazione può includere comandi Shell e variabili di ambiente al fine di renderlo univoco. Il nome specificato nel file di specifiche di compilazione sostituirà il nome immesso nella console al momento della creazione del progetto.

Se si ripete il processo di compilazione più volte, l'utilizzo di un nome dell'artefatto specificato nel file di specifiche di compilazione farà in modo che i nomi dei file artefatti di output siano univoci. Ad esempio, è possibile utilizzare una data e un timestamp che sono inseriti all'interno del nome dell'artefatto durante il processo di compilazione.

Per sostituire il nome dell'artefatto che si è inserito nella console con il nome presente nel file di specifiche di compilazione, basta seguire questi passaggi:

1. Impostare il progetto di compilazione per sostituire il nome dell'artefatto con il nome presente nel file di specifiche di compilazione.

   • Se utilizzi la console per creare il progetto di compilazione, seleziona Enable semantic versioning (Abilita funzione Versioni multiple semantica). Per ulteriori informazioni, consulta Creare un progetto di compilazione (console).

   • Se usi il AWS CLI, imposta su overrideArtifactName true nel file in formato JSON passato a. create-project Per ulteriori informazioni, consulta Creazione di un progetto di compilazione (AWS CLI).

   • Se utilizzi l' AWS CodeBuild API, imposta il overrideArtifactName flag sull'ProjectArtifactsoggetto quando viene creato o aggiornato un progetto o viene avviata una build.

2. Specificare il nome nel file di specifiche di compilazione. Utilizza il seguente esempio di file di specifiche di compilazione come guida.

Questo esempio di Linux mostra come specificare il nome di un artefatto che comprende la data di creazione della compilazione.

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: myname-$(date +%Y-%m-%d) 

Questo esempio di Linux mostra come specificare il nome di un artefatto che utilizza una variabile di CodeBuild ambiente. Per ulteriori informazioni, consulta Variabili di ambiente degli ambienti di compilazione.

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: myname-$AWS_REGION

Questo esempio di Windows mostra come specificare il nome di un artefatto che comprende data e ora di creazione della compilazione.

version: 0.2
env:
  variables:
    TEST_ENV_VARIABLE: myArtifactName
phases:
  build:
    commands:
      - cd samples/helloworld
      - dotnet restore
      - dotnet run
artifacts:
  files:
    - '**/*'
  name: $Env:TEST_ENV_VARIABLE-$(Get-Date -UFormat "%Y%m%d-%H%M%S")

Questo esempio di Windows mostra come specificare il nome di un artefatto che utilizza una variabile dichiarata nel file buildspec e una variabile di ambiente. CodeBuild Per ulteriori informazioni, consulta Variabili di ambiente degli ambienti di compilazione.

version: 0.2
env:
  variables:
    TEST_ENV_VARIABLE: myArtifactName
phases:
  build:
    commands:
      - cd samples/helloworld
      - dotnet restore
      - dotnet run
artifacts:
  files:
    - '**/*'
  name: $Env:TEST_ENV_VARIABLE-$Env:AWS_REGION

Per ulteriori informazioni, consultare Riferimento alle specifiche di costruzione per CodeBuild.