操作 中的 Azure DevOps 软件包 连接可让您与 Azure DevOps 实例建立经过身份验证的会话。 成功执行后,操作 会创建一个 Azure DevOps 会话上下文,后续的 操作 可以重用该上下文。
先决条件
- 需要一个处于活动状态的 Azure DevOps 组织。 执行身份验证的用户必须在组织内拥有足够的权限才能执行所需操作。
- 有效的 Azure DevOps 组织 URL,格式为:
https://dev.azure.com/<organization>。 - 目标组织内有效的 Azure DevOps 项目名称。
-
项目级权限: 用户必须具有对现有项目的访问权限,或具有创建项目的权限。 在项目中,根据预期用途,需要以下细粒度权限:
- 存储库: 读取、写入和管理访问权限以创建和修改存储库
- 流水线: 创建、编辑和删除构建/发行流水线
- 流水线运行: 排队并管理流水线执行
- 您可以使用以下连接方法连接到 Azure DevOps:
- OAuth2 连接: 在使用此选项之前,请确保您已在 Microsoft Azure 平台中配置 OAuth 连接、授予所需的权限范围,并在 Control Room 中设置 OAuth 连接。 有关更多详情,请参阅 为 Azure DevOps 应用配置 OAuth 2.0 身份验证。
-
个人访问令牌: 个人访问令牌 (PAT) 身份验证通过从用户的 Azure DevOps 账户生成的 PAT 进行处理。 执行以下步骤以创建个人访问令牌。
- 导航到。
- 在项目设置页面上,单击右侧的用户设置图标。
- 选择个人访问令牌,然后单击+新建令牌图标以创建访问令牌。
- 创建 PAT 时,您可以定义其访问范围:
- 完全访问: 授予对所有受支持操作的完全访问权限。
-
自定义定义: 对于受限访问,仅授予与您的进程将执行的操作相对应的范围(例如,
代码: 读取和写入,构建: 读取和执行,流水线资源: 使用)
设置
-
身份验证方法: 选择用于通过 Azure DevOps 进行身份验证的方法。
-
个人访问令牌: 用于通过 Azure DevOps 进行身份验证的个人访问令牌。 选择凭据以使用存储在 Control Room 中的凭据,选择变量以使用字符串变量,或选择不安全字符串直接输入令牌。注: Microsoft 将于 2026 年 12 月 1 日停用个人访问令牌 (PAT)。 请在停用日期之前,改用 OAuth 2.0 身份验证,替代 PAT。 有关弃用的更多信息,请参阅 即将弃用的功能。
-
OAuth2 连接: 要在 OAuth 中使用 Azure DevOps 托管的 Control Room2,您必须在 Control Room 中配置 OAuth 连接。 请参阅 创建 OAuth 连接。注: 确保 OAuth2 连接有效且在 Control Room 中处于活动状态。
在以下字段中更新信息:
- OAuth2 连接: 单击选择按钮以选择连接类型。
- 单击提供程序类型下拉菜单以选择可用或自定义的提供程序。
有关创建自定义提供程序的更多信息,请参阅 在 Control Room 中配置 OAuth 2.0 连接。
- 在连接名称字段,选择特定的 OAuth 连接对象。 此字段由 Control Room 管理员配置。
该字段在选择提供程序类型之前处于禁用状态。
- 在令牌类型字段中,根据运行时将使用的令牌选择以下选项之一。
-
共享:用于全局令牌。
当与 Control Room 建立连接时,会创建一个共享类型的访问令牌。 此访问令牌存储为凭据。 当您运行自动化时,访问令牌会在使用在 Control Room 中设置的企业应用程序提供程序类型的自动化中被引用。
-
用户特定:用于特定用户的令牌。如果您选择此选项,请确保登录到您的账户以进行身份验证并生成用户特定的令牌。 执行以下步骤以使用此选项:
- 登录到 Control Room 并导航至个人配置文件中的。
- 在 OAuth 连接选项卡下,单击登录进行身份验证。
- 登录并选择继续。
- 验证您有权访问的服务,然后单击继续。
如果连接成功,则会在表格下显示状态为活跃。
- 单击确认。
-
共享:用于全局令牌。
-
个人访问令牌: 用于通过 Azure DevOps 进行身份验证的个人访问令牌。 选择凭据以使用存储在 Control Room 中的凭据,选择变量以使用字符串变量,或选择不安全字符串直接输入令牌。
-
组织 URL: 指定 Azure DevOps 组织 URL,例如,
https://dev.azure.com/<organization>。 直接输入值或使用字符串变量。 URL 必须是有效且可访问的 Azure DevOps 组织 URL。 - 项目名称: 指定要在指定组织内插入的 Azure DevOps 项目的名称。 直接输入值或使用字符串变量。
- Azure DevOps 会话: 用于存储 Azure DevOps 会话上下文的会话变量。 选择本地会话将会话限定为当前 机器人,选择全局会话可在 机器人 中共享,例如父 机器人 和子 机器人。 创建或选择 Azure DevOps 会话子类型的现有会话变量。
- 注释(可选): 选择添加注释以为此步骤添加上下文、假设或参考信息。