Azure CLI를 사용하여 파이프라인 관리

  • 아티클

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

다음 az pipelines 명령을 사용하여 organization 파이프라인을 관리할 수 있습니다.

이러한 명령에는 관리하려는 파이프라인의 이름 또는 ID가 필요합니다. az pipelines list 명령을 사용하여 파이프라인의 ID를 가져올 수 있습니다.

시작하려면 Azure DevOps CLI 시작을 참조하세요.

파이프라인 실행

az pipelines run 명령을 사용하여 기존 파이프라인을 큐에 대기(실행)할 수 있습니다.

az pipelines run [--branch]
                 [--commit-id]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--project]
                 [--variables]

매개 변수

  • branch: 파이프라인 실행을 큐에 대기할 분기의 이름입니다(예: refs/heads/기본).
  • commit-id: 파이프라인 실행이 큐에 대기될 커밋 ID입니다.
  • folder-path: 파이프라인의 폴더 경로입니다. 기본값은 루트 수준 폴더입니다.
  • id: 이름이 제공되지 않은 경우 필요합니다. 큐에 연결할 파이프라인의 ID입니다.
  • name: ID 가 제공되지 않은 경우 필요하지만 ID 가 제공되면 무시됩니다. 큐에 추가할 파이프라인의 이름입니다.
  • 열기: 웹 브라우저에서 파이프라인 결과 페이지를 엽니다.
  • org: Azure DevOps organization URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 organization 구성할 수 있습니다. 기본값으로 구성되지 않았거나 를 사용하여 git config선택하지 않은 경우 필수입니다. 예: --org https://dev.azure.com/MyOrganizationName/.
  • project: 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 를 사용하여 git config선택하지 않은 경우 필수입니다.
  • variables: 설정하려는 변수에 대해 공백으로 구분된 "name=value" 쌍입니다.

예제

다음 명령은 분기 파이프라인에서 myGithubname.pipelines-java 라는 파이프라인 을 실행하고 결과를 테이블 형식으로 표시합니다.

az pipelines run --name myGithubname.pipelines-java --branch pipeline --output table

Run ID    Number      Status      Result    Pipeline ID    Pipeline Name                Source Branch    Queued Time               Reason
--------  ----------  ----------  --------  -------------  ---------------------------  ---------------  --------------------------  --------
123       20200123.2  notStarted            12             myGithubname.pipelines-java  pipeline           2020-01-23 11:55:56.633450  manual

파이프라인 업데이트

az pipelines update 명령을 사용하여 기존 파이프라인을 업데이트할 수 있습니다. 시작하려면 Azure DevOps CLI 시작을 참조하세요.

az pipelines update [--branch]
                    [--description]
                    [--id]
                    [--name]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

매개 변수

  • branch: 파이프라인 실행을 구성할 분기의 이름입니다(예: refs/heads/기본).
  • description: 파이프라인에 대한 새 설명입니다.
  • id: 이름이 제공되지 않은 경우 필요합니다. 업데이트할 파이프라인의 ID입니다.
  • name: ID 가 제공되지 않은 경우 필요합니다. 업데이트할 파이프라인의 이름입니다.
  • new-folder-path: 파이프라인이 이동되는 폴더의 새 전체 경로(예: user1/production_pipelines).
  • new-name: 파이프라인의 새 업데이트된 이름입니다.
  • org: Azure DevOps organization URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 organization 구성할 수 있습니다. 기본값으로 구성되지 않았거나 를 사용하여 git config선택하지 않은 경우 필수입니다. 예: --org https://dev.azure.com/MyOrganizationName/.
  • project: 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 를 사용하여 git config선택하지 않은 경우 필수입니다.
  • queue-id: 파이프라인을 실행해야 하는 에이전트 풀의 큐 ID입니다.
  • yaml-path: 리포지토리에 있는 파이프라인의 yaml 파일 경로입니다.

전역 매개 변수에는 , , help, only-show-errorsquery, output및 가 포함됩니다debugverbose.

팁

와 같이 --output사용할 수 있는 전역 매개 변수도 있습니다. 매개 변수는 --output 모든 명령에 사용할 수 있습니다. table 값은 출력을 친숙한 형식으로 표시합니다. 자세한 내용은 Azure CLI 명령의 출력 형식을 참조하세요.

예제

다음 명령은 새 이름 및 설명으로 12의 ID 로 파이프라인을 업데이트하고 결과를 테이블 형식으로 표시합니다.

az pipelines update --id 12 --description "rename pipeline" --new-name updatedname.pipelines-java --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

파이프라인 표시

az pipelines show 명령을 사용하여 기존 파이프라인의 세부 정보를 볼 수 있습니다. 시작하려면 Azure DevOps CLI 시작을 참조하세요.

az pipelines show [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]
                  [--query-examples]
                  [--subscription]

매개 변수

  • folder-path: 파이프라인의 폴더 경로입니다. 기본값은 루트 수준 폴더입니다.
  • id: 이름이 제공되지 않은 경우 필요합니다. 세부 정보를 표시할 파이프라인의 ID입니다.
  • name: 이름을 제공하지 않으면 필수이지만 ID 가 제공되면 무시됩니다. 세부 정보를 표시할 파이프라인의 이름입니다.
  • 열기: 웹 브라우저에서 파이프라인 요약 페이지를 엽니다.
  • org: Azure DevOps organization URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 organization 구성할 수 있습니다. 기본값으로 구성되지 않았거나 를 사용하여 git config선택하지 않은 경우 필수입니다. 예: --org https://dev.azure.com/MyOrganizationName/.
  • project: 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 를 사용하여 git config선택하지 않은 경우 필수입니다.
  • 쿼리 예제: JMESPath 문자열을 추천합니다.
  • 구독: 구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

예제

다음 명령은 ID 가 12인 파이프라인의 세부 정보를 표시하고 결과를 테이블 형식으로 반환합니다.

az pipelines show --id 12 --output table

ID    Name                        Status    Default Queue
----  --------------------------  --------  ------------------
12    updatedname.pipelines-java  enabled   Hosted Ubuntu 1604

다음 단계

파이프라인을 사용자 지정하거나 선택한 언어로 파이프라인을 구성하는 방법에 대해 자세히 알아볼 수 있습니다.

FAQ

프로그래밍 방식으로 빌드 파이프라인을 만들 어떻게 할까요? 있나요?

REST API 참조: 빌드 파이프라인 만들기

참고

Azure Pipelines CLI를 사용하여 명령줄 또는 스크립트에서 빌드 및 빌드 파이프라인을 관리할 수도 있습니다.

단일 명령을 사용하여 Azure DevOps Services 여러 파이프라인을 실행할 수 있나요?

현재 Azure CLI 및 Azure API는 명령줄에서 여러 파이프라인을 실행하는 명령을 제공하지 않습니다. Azure CLI 명령을 사용하여 모든 파이프라인 및 정의를 나열하고 단일 릴리스 또는 빌드 ID를 매개 변수로 제공할 수 있습니다. 모든 명령은 독립적인 파이프라인의 독립적인 실행에 대해 작동하도록 설계되었으며 고유한 값 하나만 허용하는 고유 ID 요청이 필요합니다. 파이프라인 트리거에 대한 자세한 내용은 파이프라인을 트리거하는 이벤트 지정을 참조하세요.