Compartilhar via


Use o arquivo .artifactignore

Serviços do Azure DevOps

O artifactignore arquivo funciona de forma semelhante a um gitignore arquivo, mas serve a um propósito diferente. Em vez de especificar arquivos a serem ignorados pelo Git, ele é usado no Azure Pipelines para controlar quais arquivos são excluídos ao publicar artefatos de pipeline ou Pacotes Universais. Esse arquivo pode ajudar a reduzir a execução do pipeline e melhorar sua eficiência, impedindo que arquivos desnecessários sejam copiados para o diretório de preparo antes da publicação.

O arquivo artifactignore tem uma sintaxe semelhante à de um arquivo gitignore e normalmente é armazenado em seu sistema de controle de versão. No entanto, ao contrário de gitignore, o arquivo artifactignore nem sempre precisa estar na raiz do repositório. Sua localização depende do caminho especificado na tarefa de publicação. Se colocado incorretamente, a tarefa não o reconhecerá, levando a resultados não intencionais. Por exemplo, se o caminho for $(System.DefaultWorkingDirectory)/bin/artifacts, o arquivo artifactignore deverá ser colocado no diretório /bin/artifacts.

Observação

O arquivo artifactignore não funciona com a tarefa PublishBuildArtifacts , use a tarefa PublishPipelineArtifact .

Sintaxe

O .artifactignore segue a mesma sintaxe que o .gitignore com algumas exceções. O caractere + de sinal de adição não tem suporte em caminhos de URL e determinados tipos de pacote, como o Maven, podem ter limitações com metadados semânticos de controle de versão.

Observação

Por padrão, o arquivo .gitignore é ignorado, a menos que você tenha um arquivo .artifactignore . Para incluí-lo, basta criar um arquivo .artifactignore vazio.

Exemplo

Neste exemplo, todos os arquivos serão ignorados, exceto aqueles localizados no diretório src/MyApp/bin/Release .

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

Para incluir vários arquivos ou pastas quando todo o resto for excluído, comece com um padrão de exclusão (**/*)de cobertor e adicione uma ! regra prefixada para cada arquivo ou diretório que você deseja manter. No exemplo a seguir, a dist pasta e todo o seu conteúdo, juntamente com package.json e .npmrc estão incluídos:

# Exclude everything
**/*

# Re-include the top-level dist folder, its contents, and the specific files
!dist/
!dist/**
!package.json
!.npmrc

Importante

O arquivo .artifactignore deve ser colocado no diretório especificado no targetPath argumento na tarefa Publicar Artefatos de Pipeline .