Partager via


Utiliser le fichier .artifactignore

Azure DevOps Services

Le artifactignore fichier fonctionne de la même manière qu’un gitignore fichier, mais sert un autre objectif. Au lieu de spécifier des fichiers à ignorer par Git, il est utilisé dans Azure Pipelines pour contrôler les fichiers exclus lors de la publication d’artefacts de pipeline ou de packages universels. Ce fichier peut aider à réduire l’exécution de votre pipeline et à améliorer son efficacité en empêchant les fichiers inutiles d’être copiés dans le répertoire intermédiaire avant la publication.

Le fichier artifactignore a une syntaxe similaire à celle d’un fichier gitignore et est généralement stocké dans votre système de contrôle de version. Toutefois, contrairement à gitignore, le fichier artifactignore n’a pas toujours besoin d’être à la racine de votre référentiel. Son emplacement dépend du chemin spécifié dans la tâche de publication. Si elle est placée incorrectement, la tâche ne la reconnaît pas, ce qui entraîne des résultats inattendus. Par exemple, si le chemin d’accès est $(System.DefaultWorkingDirectory)/bin/artifacts, le fichier artifactignore doit être placé dans le répertoire /bin/artifacts .

Remarque

Le fichier artifactignore ne fonctionne pas avec la tâche Publier les artefacts de build, utilisez plutôt la tâche Publish Pipeline Artifacts .

Syntaxe

Le .artifactignore suit la même syntaxe que le .gitignore avec quelques exceptions. Le caractère + de signe plus n’est pas pris en charge dans les chemins d’URL, et certains types de package, tels que Maven, peuvent avoir des limitations avec les métadonnées de contrôle de version sémantique.

Remarque

Par défaut, le fichier .gitignore est ignoré, sauf si vous avez un fichier .artifactignore . Pour l’inclure, créez simplement un fichier .artifactignore vide.

Exemple

Dans cet exemple, tous les fichiers sont ignorés, à l’exception des fichiers situés dans le répertoire src/MyApp/bin/Release .

**/*
!src/MyApp/bin/Release/**.*

Important

Le fichier .artifactignore doit être placé dans le répertoire spécifié dans l’argument targetPath de votre tâche Publish Pipeline Artifacts .