使用 .artifactignore 文件

Azure DevOps Services

该文件 artifactignore 的工作方式 gitignore 与文件类似,但用途不同。 Azure Pipelines 中用于控制发布管道项目或通用包时排除的文件,而不是指定 Git 忽略的文件。 此文件可帮助减少管道执行,并通过防止在发布之前将不必要的文件复制到暂存目录中来提高其效率。

artifactignore 文件具有与 gitignore 文件类似的语法,通常存储在版本控制系统中。 但是,与 gitignore 不同artifactignore 文件并不总是需要位于存储库的根目录中。 其位置取决于发布任务中指定的路径。 如果放置不正确,任务将无法识别它,从而导致意外的结果。 例如,如果路径为 $(System.DefaultWorkingDirectory)/bin/artifacts则 artifactignore 文件应放置在 /bin/artifacts 目录中。

注意

artifactignore 文件不适用于发布生成项目任务,而是使用发布管道项目任务。

语法

.artifactignore 遵循与 .gitignore 相同的语法,但有一些例外情况。 URL 路径不支持加号字符 + ,并且某些包类型(如 Maven)可能具有语义版本控制元数据的限制。

注意

默认情况下,除非有 .artifactignore 文件,否则将忽略 .gitignore 文件。 若要包含该文件,只需创建一个空 的 .artifactignore 文件。

示例

在此示例中,除 src /MyApp/bin/Release 目录中的文件外,将忽略所有文件。

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

重要

.artifactignore 文件必须放置在发布管道项目任务的参数中指定的targetPath目录中。