Exemple d'utilisation de la gestion sémantique des versions pour nommer des artefacts de génération

Cet exemple contient des exemples de fichiers buildspec qui montrent comment spécifier le nom d'un artefact qui est créé au moment de la génération. Un nom spécifié dans un fichier buildspec peut comprendre des commandes Shell et des variables d'environnement afin de le rendre unique. Un nom que vous spécifiez dans un fichier buildspec se substitue au nom que vous saisissez dans la console lorsque vous créez votre projet.

Si vous procédez à plusieurs générations, le nom d'artefact spécifié dans le fichier buildspec permet de vous assurer que les noms de vos fichiers d'artefact de sortie sont uniques. Par exemple, vous pouvez utiliser une date et un horodatage inséré dans le nom d'un artefact au moment de la génération.

Si vous souhaitez remplacer le nom de l'artefact que vous avez saisi dans la console par un nom dans le fichier buildspec, procédez comme suit :

1. Configurez votre projet de génération afin de remplacer le nom de l'artefact par un nom du fichier buildspec.

   • Si vous utilisez la console pour créer votre projet de génération, sélectionnez Activer la gestion sémantique des versions. Pour plus d’informations, consultez Création d'un projet de génération (console).

   • Si vous utilisez le AWS CLI, attribuez-lui la valeur overrideArtifactName true dans le fichier JSON formaté transmis à. create-project Pour plus d’informations, consultez Création d'un projet de génération (AWS CLI).

   • Si vous utilisez le AWS CodeBuild API, placez l'overrideArtifactNameindicateur sur l'ProjectArtifactsobjet lorsqu'un projet est créé ou mis à jour ou qu'une construction est lancée.

2. Spécifiez un nom dans le fichier buildspec. Utilisez l'exemple de fichier buildspec suivant comme guide.

Cet exemple Linux vous montre comment spécifier un nom d'artefact qui comprend la date de création de la génération :

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

Cet exemple Linux vous montre comment spécifier un nom d'artefact qui utilise une variable d' CodeBuild environnement. Pour plus d’informations, consultez Variables d'environnement dans les environnements de génération.

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

Cet exemple Windows vous montre comment spécifier un nom d'artefact qui comprend la date et l'heure de création de la génération :

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")

Cet exemple Windows montre comment spécifier un nom d'artefact qui utilise une variable déclarée dans le fichier buildspec et une variable d'environnement. CodeBuild Pour plus d’informations, consultez Variables d'environnement dans les environnements de génération.

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

Pour plus d’informations, consultez Référence de spécification de construction pour CodeBuild.