AzureDevOpsFlowRegistryClient

文档中心 › 组件索引 › AzureDevOpsFlowRegistryClient

AzureDevOpsFlowRegistryClient Flow Registry Client

类型全限定名：cn.org.acal.lynxus.azure.devops.AzureDevOpsFlowRegistryClient

所属 Bundle：cn.org.acal.lynxus:lynxus-azure-nar:2.11.8

描述

使用 Azure DevOps Git REST API 对存储库中的流进行Version Control的流Registry客户端。

标签

gitazuredevopsregistryflow

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称默认值可选值描述
Azure DevOps API URLhttps://dev.azure.comAzure DevOps 实例的基本 URL
OrganizationAzure DevOps 组织
ProjectAzure DevOps 项目
Repository Name存储库的名称
Authentication StrategySERVICE_PRINCIPAL
  • Service Principal — 使用服务主体的 OAuth2 客户端凭据
使用 Azure DevOps 进行身份验证的策略
OAuth2 Access Token Provider控制器服务 API：
OAuth2AccessTokenProvider
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8		提供 OAuth2 访问令牌的Controller Service
Web Client Service控制器服务 API：
WebClientServiceProvider
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8		用于与 Bitbucket 通信的 Web 客户端服务
Default Branchmain用于此客户端的默认分支
Repository Path仓库中此客户端用于存储所有数据的路径。如果留空，则使用仓库的根目录。
目录过滤排除[.].*名称匹配给定正则表达式的目录在列出存储桶时将被忽略。
Parameter Context ValuesRETAIN
  • Retain — 保留参数上下文（Parameter Contexts）中的值，不做修改
  • Remove — 从参数上下文中移除值
  • Ignore Changes — 忽略现有参数的任何更改
指定存储版本化流时如何处理参数值。
Commit Author SourceSERVICE_USER
  • Service User — 提交作者是在此 registry client 上配置的已身份验证的服务账户
  • Application User — 提交作者是执行操作的 Lynxus 用户，使用身份作为作者姓名和作者电子邮件
指定如何确定 Git 提交的作者。设置为 Service User 时，使用经过身份验证的服务帐户作为提交作者。设置为 Application User 时，执行操作的 Lynxus 用户的身份被用作作者名称和作者电子邮件，而服务帐户保持为提交者。
SSL Context Service控制器服务 API：
SSLContextProvider
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8		SSL 上下文服务为 TLS 通信提供可信证书和客户端证书。
Synchronization IntervalLynxus 检查此流程注册表客户端以获取版本控制下流程的更新版本的频率。留空时，应用使用 lynxus.flowcontroller.registry.sync.interval 属性

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

详细说明

Azure DevOps Flow Registry Client – Service Principal 配置

该组件使用 Azure DevOps Git REST API，把 Lynxus 版本化流程存储在 Azure DevOps Git 中。它通过 OAuth 2.0 客户端凭据使用 Microsoft Entra 服务主体进行认证。

Entra ID（Microsoft Entra）– 服务主体

  1. App registrations → New registration → 输入名称（例如 Lynxus Git DevOps Registry Client）；单租户即可；无需重定向 URI。
  2. 记录 Directory (tenant) ID 和 Application (client) ID。
  3. Certificates & secrets → New client secret。记下提供的 Value。

Azure DevOps

  1. 组织必须使用同一租户。
  2. Organization Settings → Users → Add users → 粘贴 Application (client) ID；Access Level = Basic；添加到 相应的项目/组（例如 Contributors）。不要发送邮件。

Lynxus Management Controller Service

  • StandardWebClientServiceProvider：默认超时通常即可； 按需配置代理/SSL。启用。
  • StandardOauth2AccessTokenProvider：
    • Token Endpoint（把 "Directory (tenant) ID" 的值替换进去）： https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    • Grant Type: Client Credentials
    • Client ID: Application (client) ID
    • Client Secret: 所创建客户端密钥的 value
    • Scope: https://app.vssps.visualstudio.com/.default
    • 按需配置代理/SSL。
    • 可选：执行 Verify，确认可以获取令牌
    • 启用

Lynxus Flow Registry Client

  • Type: AzureDevOpsFlowRegistryClient
  • Azure DevOps API URL: https://dev.azure.com
  • Organization、Project、Repository Name
  • Default Branch：必须已存在（例如 main）。
  • Repository Path：可选的子文件夹；不能有开头或结尾的 /。
  • Authentication Strategy: Service Principal。
  • OAuth2 Access Token Provider: 选择已配置的 StandardOauth2AccessTokenProvider。
  • Web Client Service: 选择 StandardWebClientServiceProvider。
  • 可选：执行 Verify，确认读写正常。
© 2026 ACAL Organization. Licensed under Apache License 2.0.