访问构建工件的模式
这一部分保留用于与以前的 TeamCity 版本的 向后兼容性,以及某些特定功能。
请同时检查以下信息:
如果您需要访问构建中的 artifacts,可以考虑使用 TeamCity 的内置 artifact 依赖性 功能。
您也可以使用 Ivy 依赖性管理器从 TeamCity 下载工件。
对于来自 TeamCity 构建之外的工件下载,建议使用 REST API。
另请参见关于脚本从 HTTP 访问的基本规则的 通过 HTTP 访问服务器部分。
获取构件
要下载最新构建的制品(最后完成、成功或固定的),请使用以下路径:
要通过 build ID 下载工件,使用:
要通过构建编号下载工件,请使用:
要从带有特定标签的最新构建中下载工件,请使用:
要下载 .zip 归档中的所有工件,请使用:
where
BUILD_TYPE_EXT_ID
是一个 构建配置 ID。建筑规范
可以是.lastFinished
,.lastSuccessful
或.lastPinned
,特定的buildNumber
或 构建 ID 的格式为BUILD_ID:id
。ARTIFACT_PATH
是在 TeamCity 服务器上的工件的路径。 这个路径可以包含一个{build.number}
模式(%7Bbuild.number%7D
),它将被 TeamCity 替换为获取构建工件的构建的构建编号。 默认情况下,包含所有构件的存档不包括 隐藏构件。 要包括它们,请在相应的 URL 结尾处添加?showAll=true
。要从特定分支中的最后完成、最后成功、最后固定或标记的构建中下载工件,请在相应的 URL 结尾处添加?branch=<branch_name>
参数。 如果未指定分支参数,则从默认分支中的构建下载工件。
从归档文件中获取工件
TeamCity 允许通过以下 URL 模式从构建工件目录获取来自归档的文件:
从构建脚本中获取制品
工具如 wget 或其他不支持HTML登录页面的下载器,常常需要下载某些构建配置的工件。 如果您访问工件库,TeamCity 会要求进行身份验证。
要正确地使用基于令牌的身份验证从构建脚本中进行身份验证,您必须在 HTTP 头 授权:Bearer <token-value>
中传递您的个人 访问令牌。
要使用基本身份验证从构建脚本正确地进行身份验证,您必须更改网址(在网址中添加 /httpAuth/
前缀):
访问带有 /httpAuth/
前缀的这些 URLs 中的构件需要进行基本身份验证。
您可以在基础认证设置中使用现有的 TeamCity 用户名和密码,但建议使用 teamcity.auth.userId
/ teamcity.auth.password
系统属性作为下载构件请求的凭证:这样,TeamCity 就有办法记录哪个构建使用了另一个构建的构件,并在构建的依赖项标签页中显示出来。
要启用使用访客用户登录下载工件,您可以使用以下任一方法:
使用旧的 URL,不加
/httpAuth/
前缀,但要添加guest=1
参数。 例如:/repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH?guest=1将
/guestAuth
前缀添加到 URL,而不是使用guest=1
参数。 例如:/guestAuth/repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH
在这种情况下,您将不会被要求进行身份验证。 艺术品的列表可以在 /repository/download/BUILD_TYPE_EXT_ID/.lastFinished/teamcity-ivy.xml
中找到。
包含 TeamCity 构建编号的工件链接
您可以使用 {build.number}
(在 URL 中为 %7Bbuild.number%7D
)作为当前构建编号在工件文件名中的快捷方式。 例如: