다음을 통해 공유

Azure 명령줄 인터페이스(Azure CLI)를 사용하여 파이프라인 관리

  • 아티클

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

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

이러한 명령에는 관리하려는 파이프라인의 이름 또는 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/main).
  • commit-id: 파이프라인 실행을 큐에 대기할 커밋 ID입니다.
  • folder-path: 파이프라인의 폴더 경로입니다. 기본값은 루트 수준 폴더입니다.
  • id: 이름이 제공되지 않는 경우 필수입니다. 큐에 대한 파이프라인의 ID입니다.
  • 이름: ID가 제공되지 않은 경우 필수이지만 ID가 제공되면 무시됩니다. 큐에 추가할 파이프라인의 이름입니다.
  • 열기: 웹 브라우저에서 파이프라인 결과 페이지를 엽니다.
  • org: Azure DevOps 조직 URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git config. 예: --org https://dev.azure.com/MyOrganizationName/
  • project: 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git config.
  • 변수: 설정할 변수에 대해 공백으로 구분된 "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/main).
  • description: 파이프라인에 대한 새 설명입니다.
  • id: 이름이 제공되지 않는 경우 필수입니다. 업데이트할 파이프라인의 ID입니다.
  • 이름: ID가 제공되지 않은 경우 필수입니다. 업데이트할 파이프라인의 이름입니다.
  • new-folder-path: 파이프라인이 이동되는 폴더의 새 전체 경로(예 : user1/production_pipelines).
  • new-name: 파이프라인의 새 업데이트된 이름입니다.
  • org: Azure DevOps 조직 URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 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 파일 경로입니다.

전역 매개 변수에는 debug,help, only-show-errors및 outputqueryverbose.

팁

다음과 같이 --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입니다.
  • 이름: 이름이 제공되지 않은 경우 필수이지만 ID가 제공되면 무시됩니다. 세부 정보를 표시할 파이프라인의 이름입니다.
  • 열기: 웹 브라우저에서 파이프라인 요약 페이지를 엽니다.
  • org: Azure DevOps 조직 URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 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 요청이 필요합니다. 파이프라인 트리거에 대한 자세한 내용은 파이프라인을 트리거하는 이벤트 지정을 참조 하세요.

파이프라인 실행의 단계를 건너뛸 어떻게 할까요? 있나요?

이 az rest 명령을 사용하여 Azure DevOps REST API를 사용하여 run pipeline 매개 변수를 사용하여 stagesToSkip 파이프라인 실행의 단계를 건너뛸 수 있습니다.

예시:

az rest --method post `
    --uri https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1-preview.1 `
    --body "{'stagesToSkip': [''], 'resources': {'repositories': {'self': {'refName': 'refs/heads/{branch}'}}}}" `
    --resource 499b84ac-1321-427f-aa17-267ca6975798

자세한 내용은 Azure DevOps Services REST API 참조를 참조하세요.