使用 Azure CLI 从 Azure DevOps 克隆所有存储库

我使用很多不同的计算机，而且我经常对计算机进行重新映像。总而言之，这意味着我发现自己经常坐在新安装的计算机前。

我总是在一台新计算机上做的一件事是从 Azure DevOps 中的我的个人组织克隆一堆存储库，其中包含我的笔记和我希望在任何地方都可以使用的精选工具。另一种情况是，当我联系客户时，他们允许我访问 Azure DevOps 中的一堆项目以及我应该贡献的存储库。

在这两种情况下，我发现我自己复制粘贴网址并运行 git clone 几次。我知道，听起来不太难，但我真的不喜欢重复做一件事！

那么该怎么办呢？ 我们当然使用 PowerShell！

Azure CLI 有一个用于与 Azure DevOps 集成的扩展，我发现它非常方便。我很惊讶我遇到的很多人不知道 Azure CLI 有大量可用的扩展，因此我想分享一下如何使用它来克隆我有权访问的所有 Azure 存储库Azure 开发运营。

我假设我们已经安装了 Azure CLI，如果没有，则需要安装 Azure CLI。

首先我们需要登录。这是通过调用“az login”来完成的。如果我无权访问 Azure 中的任何订阅，我必须添加参数“-allow-no-subscriptions”。

az login --allow-no-subscriptions

然后我们需要确保安装了正确的扩展。可以使用以下命令列出已安装的扩展：

az extension list

如果安装了许多扩展，那么此列表可能会有点让人不知所措。我可以使用 PowerShell 将 JSON 的输出转换为对象，然后像在 PowerShell 中过滤其他内容一样过滤列表。但是，Azure CLI 中有一种本机过滤方式，那么为什么不使用它呢？ Azure CLI 有一个名为“-query”的参数，它采用 JMESPath 表达式。 JMESPath 与 XPath 类似，但对于 JSON 而不是 XML，它的文档位于 https://jmespath.org/。

我从列出扩展程序中得到的响应是扩展程序数组。要进行过滤，我可以使用以下表达式：“[?name == ‘‘azure-devops’’].name”。我还可以通过添加参数“-o tsv”来告诉 Azure CLI 以制表符分隔格式而不是 JSON 输出结果。这很适合我在这里，因为我只会拿回一个名字。

az extension list  --query '[?name == ''azure-devops''].name' -o tsv

如果我得到“azure-devops”回来，我就可以走了！如果我没有得到任何回报，我需要安装 devops 扩展。这是通过运行以下命令来完成的：

az extension add --name 'azure-devops'

现在我们已准备好向 Azure DevOps 发出一些查询！要列出 Azure DevOps 中的存储库，我们需要提供组织 URL 和项目名称。让我们将组织名称存储在一个变量中，并使用它来列出所有项目。我们再次使用查询仅获取名称并选择将输出作为 tsv。

$Organization = 'https://dev.azure.com/SimonWahlin'
$Projects = az devops project list --organization $Organization --query 'value[].name' -o tsv

现在我准备列出每个项目中的所有存储库！

foreach ($Proj in $Projects) {
  az repos list --organization $Organization --project $Proj | ConvertFrom-Json
}

这将为每个存储库输出一个对象。如果在属性 webUrl 中找到，则使用 https 进行克隆的路径。 现在，如果我们将其结合起来，我们会得到以下脚本：

param(
    [string]$Organization
)

if ($Organization -notmatch '^https?://dev.azure.com/\w+') {
    $Organization = "https://dev.azure.com/$Organization"
}

# Make sure we are signed in to Azure
$AccountInfo = az account show 2>&1
try {
    $AccountInfo = $AccountInfo | ConvertFrom-Json -ErrorAction Stop
}
catch {
    az login --allow-no-subscriptions
}

# Make sure we have Azure DevOps extension installed
$DevOpsExtension = az extension list --query '[?name == ''azure-devops''].name' -o tsv
if ($null -eq $DevOpsExtension) {
    $null = az extension add --name 'azure-devops'
}

$Projects = az devops project list --organization $Organization --query 'value[].name' -o tsv
foreach ($Proj in $Projects) {
    if (-not (Test-Path -Path ".$Proj" -PathType Container)) {
        New-Item -Path $Proj -ItemType Directory |
        Select-Object -ExpandProperty FullName |
        Push-Location
    }
    $Repos = az repos list --organization $Organization --project $Proj | ConvertFrom-Json
    foreach ($Repo in $Repos) {
        if(-not (Test-Path -Path $Repo.name -PathType Container)) {
            Write-Warning -Message "Cloning repo $Proj$($Repo.Name)"
            git clone $Repo.webUrl
        }
    }
}

您如何使用 Azure CLI？在评论中分享您的经验！