Azure Devops Build Manager For Azure Functions

:construction: 该项目目前处于 开发中。请 不要在生产环境中使用，因为我们预期随着时间的推移会有所发展。 :construction

此项目提供AzureDevopsBuildManager类和辅助类。此管理类允许调用者管理在Azure DevOps帐户内维护的Azure DevOps管道。此项目创建是为了支持AZ CLI的命令行工具。

安装

从pip安装包

pip install azure-functions-devops-build

开始使用

要使用API，您首先需要通过使用az login登录您的Azure帐户来与Azure建立连接。然后，您可以按照以下示例进行操作。首先，我们从登录中获取令牌，并使用此令牌对不同的Python函数调用进行身份验证。

from azure.cli.core import get_default_cli
from azure.cli.core._profile import Profile
from azure_functions_devops_build.organization.organization_manager import OrganizationManager
import pprint

# Get your token from the az login cache
cli_ctx = get_default_cli()
profile = Profile(cli_ctx=cli_ctx)
creds, _, _ = profile.get_login_credentials(subscription_id=None)

# Create an organization manager using your credentials
organization_manager = OrganizationManager(creds=creds)

# Get the list of organizations for your user
organizations = organization_manager.list_organizations()

# Show details about each organization in the console
for organization in organizations.value:
    pprint.pprint(organization.__dict__)

API文档

该Python库广泛使用Azure DevOps REST API和Azure DevOps Python API。有关调用不同API的详细信息，请参阅Azure DevOps REST API参考，有关azure-devops-python-api的详细信息，请参阅Azure DevOps Python SDK。

示例

查看测试或查看az-cli functionapp devops-build模块以查看示例。

测试

在运行测试之前需要设置几件事情

1. 已登录az cli。您可以通过使用az login来完成此操作。
2. 由于此操作直接部署到Azure函数，请在Azure门户中创建一个Azure Functions函数应用。您需要为这些测试创建一个函数应用，以确保测试能够成功运行，并确保记录订阅名称、项目名称、应用程序类型和存储名称的详细信息。
3. 按照tests/_config_example.py文件，创建一个tests/_config.py文件，包含您自己的测试环境。
4. 使用python -m tests.suite运行完整的测试套件
5. 要运行特定管理器测试，请运行python -m tests.{NAME_OF_MANAGER}，例如：python -m tests.test_builder_manager

贡献

该项目欢迎贡献和建议。大多数贡献都需要您同意贡献者许可协议（CLA），声明您有权并且确实授予我们使用您的贡献的权利。有关详细信息，请访问https://cla.microsoft.com。

当您提交pull请求时，CLA-bot将自动确定您是否需要提供CLA，并相应地装饰PR（例如，标签、评论）。只需遵循bot提供的说明即可。您在整个使用我们的CLA的repo中只需这样做一次。

该项目已采用Microsoft开源行为准则。有关更多信息，请参阅行为准则FAQ或通过opencode@microsoft.com联系以获取任何额外的问题或评论。