Usare il file con estensione artifactignore

Servizi di Azure DevOps

Il artifactignore file funziona in modo analogo a un gitignore file, ma ha uno scopo diverso. Anziché specificare i file da ignorare da Git, viene usato in Azure Pipelines per controllare quali file vengono esclusi durante la pubblicazione di artefatti della pipeline o pacchetti universali. Questo file consente di ridurre l'esecuzione della pipeline e migliorarne l'efficienza impedendo la copia di file non necessari nella directory di staging prima della pubblicazione.

Il file artifactignore ha una sintassi simile a quella di un file gitignore ed è in genere archiviato nel sistema di controllo della versione. Tuttavia, a differenza di gitignore, il file artifactignore non deve sempre trovarsi nella radice del repository. Il percorso dipende dal percorso specificato nell'attività di pubblicazione. Se inserita in modo non corretto, l'attività non lo riconosce, causando risultati imprevisti. Ad esempio, se il percorso è $(System.DefaultWorkingDirectory)/bin/artifacts, il file artifactignore deve essere inserito nella directory /bin/artifacts .

Nota

Il file artifactignore non funziona con l'attività Pubblica artefatti di compilazione , usare invece l'attività Pubblica artefatti della pipeline.

Sintassi

. artifactignore segue la stessa sintassi di .gitignore con alcune eccezioni. Il carattere + segno più non è supportato nei percorsi URL e alcuni tipi di pacchetto, ad esempio Maven, possono avere limitazioni con i metadati di controllo delle versioni semantici.

Nota

Per impostazione predefinita, il file con estensione gitignore viene ignorato a meno che non si disponga di un file con estensione artifactignore . Per includerlo, è sufficiente creare un file con estensione artifactignore vuoto.

Esempio

In questo esempio tutti i file verranno ignorati, ad eccezione di quelli che si trovano nella directory src/MyApp/bin/Release .

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

Importante

Il file con estensione artifactignore deve essere inserito nella directory specificata nell'argomento nell'attività targetPath Pubblica artefatti della pipeline.