Azure DevOps CLI 入門

Azure DevOps Services |Azure DevOps Server 2020

您可以使用 Azure 命令列介面的 Azure DevOps 擴充功能 (CLI) ,從命令列管理許多 Azure DevOps Services。 CLI 命令可讓您使用更快速且彈性的互動式畫布來簡化工作,略過使用者介面工作流程。

注意

Azure DevOps 命令列介面 (CLI) 適用于 Azure DevOps Server 2020 和 Azure DevOps Services。

若要開始使用 Azure CLI 的 Azure DevOps 擴充功能,請執行下列步驟:

  1. 安裝 Azure CLI:遵循 安裝 Azure CLI 中提供的指示來設定您的 Azure CLI 環境。 您的 Azure CLI 版本至少必須是2.10.1。 您可以使用 az --version 來驗證。

  2. 加入 Azure DevOps 延伸模組:

     az extension add --name azure-devops
    

    您可以使用 az extension listaz extension show --name azure-devops 來確認安裝。

  3. 登入:執行 az login 以登入。 請注意,我們只支援互動式,或使用的使用者名稱和密碼登入 az login 。 若要使用個人存取權杖 (PAT) 登入,請參閱透過Azure DevOps 個人存取權杖登入 (pat) 。 連線到內部部署伺服器實例時,可能需要使用 PAT 進行登入,才能執行選取的命令。

  4. 設定預設值:建議您為組織和專案設定預設設定。 否則,您可以在個別命令本身內進行設定。

     az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp
    

    如果您要連接到 Azure DevOps Server,請指定伺服器實例的 URL。 例如:

     az devops configure --defaults organization=https://ServerName/CollectionName project=ProjectName
    

命令使用方式

加入 Azure DevOps 延伸模組會加入 devops 、、 pipelinesartifactsboardsrepos 群組。 如需任何命令的 [使用方式] 和 [說明] 內容,請輸入 -h 參數,例如:

$ az devops -h
   
Group
    az devops : Manage Azure DevOps organization level operations.
        Related Groups
        az pipelines: Manage Azure Pipelines
        az boards: Manage Azure Boards
        az repos: Manage Azure Repos
        az artifacts: Manage Azure Artifacts.
   
Subgroups:
    admin            : Manage administration operations.
    extension        : Manage extensions.
    project          : Manage team projects.
    security         : Manage security related operations.
    service-endpoint : Manage service endpoints/service connections.
    team             : Manage teams.
    user             : Manage users.
    wiki             : Manage wikis.

Commands:
    configure        : Configure the Azure DevOps CLI or view your configuration.
    feedback         : Displays information on how to provide feedback to the Azure DevOps CLI team.
    invoke           : This command will invoke request for any DevOps area and resource. Please use
                       only json output as the response of this command is not fixed. Helpful docs -
                       https://docs.microsoft.com/rest/api/azure/devops/.
    login            : Set the credential (PAT) to use for a particular organization.
    logout           : Clear the credential for all or a particular organization.

在瀏覽器中開啟專案

您可以使用 --open 參數,在預設瀏覽器中開啟 Azure DevOps 入口網站中的任何成品。

例如:

az pipelines build show --id 1 --open

此命令會在命令列上顯示組建的詳細資料 id 1 ,並在預設瀏覽器中開啟。