Azure DevOps CLI를 사용하여 파이프라인 관리
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
이 문서에서는 다음 az pipelines 명령을 사용하여 Azure DevOps 프로젝트에서 기존 파이프라인 을 관리하는 방법을 설명합니다.
- 프로젝트의 파이프라인을 나열하는 az pipelines list
- az pipelines show to show the details of a pipeline
- az pipelines run to run a pipeline
- az pipelines update to update to update a pipeline a pipeline
- az pipelines delete to delete to delete a pipeline
참고 항목
Azure DevOps CLI 확장은 Azure DevOps Services에만 사용할 수 있으며 Azure DevOps Server의 버전을 지원하지 않습니다.
Azure DevOps CLI 확장
az-pipelines 명령 그룹은 Azure CLI 버전 2.30.0 이상이 필요한 Azure CLI에 대한 DevOps 확장의 일부입니다. 명령을 처음 실행할 때 Azure DevOps 확장이 azure pipelines 자동으로 설치됩니다. 시작에 대한 자세한 내용은 Azure DevOps CLI 시작을 참조하세요.
Azure DevOps CLI 명령에서 전역 Azure CLI 매개 변수(예: debug, helponly-show-errors, queryoutput및verbose)를 사용할 수도 있습니다. 전역 매개 변수의 --output 값은 table 출력을 친숙한 형식으로 표시합니다. 자세한 내용은 Azure CLI 명령의 출력 형식을 참조하세요.
Azure DevOps CLI 명령에 az devops configure --defaults organization=<YourOrganizationURL>대한 기본 Azure DevOps 조직을 설정하거나 매개 변수를 --detect true 사용하여 조직을 자동으로 검색할 수 있습니다. 를 사용하여 az devops configure -d project=<Project Name or ID>기본 Azure DevOps 프로젝트를 구성할 수 있습니다.
조직을 검색하거나 기본 조직 또는 프로젝트를 구성하지 않거나 조직 및 프로젝트를 통해 git config선택하는 경우 각 명령에서 매개 변수와 project 매개 변수를 org 지정해야 합니다.
기존 파이프라인 나열
, , 및 파이프라인 명령에는 run관리하려는 파이프라인 중 하나 name 또는 id 파이프라인이 필요합니다.delete updateshow 사용하는 id경우 매개 변수는 name 무시됩니다. ID를 포함하여 프로젝트 파이프라인 목록을 얻으려면 az pipelines list 명령을 사용합니다. 매개 변수를 사용하여 결과 목록을 필터링하거나 서식을 지정할 수 있습니다.
예를 들어 다음 명령은 이름이 테이블 형식으로 시작하는 프로젝트 파이프라인을 python*나열합니다.
az pipelines list --name python* --output table
출력:
ID Path Name Status Default Queue
---- ------ -------------------------- -------- ---------------
17 \ python-sample-vscode-flask disabled Azure Pipelines
24 \ python-sample-get-started enabled Azure Pipelines
전체 명령 참조는 az pipelines 목록을 참조하세요.
파이프라인에 대한 세부 정보 표시
기존 파이프라인의 세부 정보를 보려면 az pipelines show 명령을 사용합니다. 예를 들어 다음 명령은 를 사용하여 파이프라인 ID 12의 세부 정보를 표시하고 웹 브라우저에서 파이프라인 요약 페이지를 엽니다.
az pipelines show --id 12 --open
전체 명령 참조는 az pipelines show를 참조하세요.
파이프라인 실행
기존 파이프라인을 큐에 대기하고 실행하려면 az pipelines run 명령을 사용합니다. 실행에서 설정하고 parameters variables 사용할 수 있습니다.
예를 들어 다음 명령은 분기의 pipeline 파이프라인을 myGithubname.pipelines-java name 실행하고, 실행에 대한 변수 var1 100 값을 설정하고, 결과를 형식으로 table 출력합니다.
az pipelines run --name myGithubname.pipelines-java --branch pipeline --variables var1=100 --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 run을 참조하세요.
파이프라인 업데이트
기존 파이프라인을 업데이트하려면 az pipelines update 명령을 사용합니다. 예를 들어 다음 명령은 파이프라인을 새 이름 및 설명으로 id 12 업데이트하고 결과를 테이블 형식으로 출력합니다.
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 update를 참조하세요.
파이프라인 삭제
파이프라인을 삭제하려면 az-pipelines-delete 명령을 실행합니다. 예를 들어 다음 명령은 ID 12가 인 파이프라인을 삭제하고 확인을 요청하지 않습니다. 매개 변수를 --yes 포함하지 않으면 명령은 기본적으로 확인을 요청합니다.
az pipelines delete --id 12 --yes
전체 명령 참조는 az pipelines delete를 참조하세요.
프로그래밍 방식으로 파이프라인 만들기 및 구성
Azure DevOps CLI를 사용하여 YAML 파이프라인을 만들려면 az pipelines create를 참조하세요. YAML 파이프라인에서 Azure CLI 명령을 실행하려면 Azure Pipelines YAML의 Azure DevOps CLI를 참조하세요.
YAML 파이프라인을 만들어 선택한 언어로 앱을 빌드, 구성, 테스트 및 배포할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.
- .NET Core 앱 빌드, 테스트 및 배포
- Go 프로젝트 빌드 및 테스트
- Java 앱 빌드
- Node.js 패키지 빌드 및 게시
- Python 앱 빌드 및 게시
- 앱을 배포하는 컨테이너 이미지 빌드
- 파이프라인 사용자 지정
Azure DevOps Services REST API
REST API를 사용하여 직접 HTTP를 호출하여 Azure DevOps와 통합되는 사용자 지정 애플리케이션 또는 서비스를 빌드할 수 있습니다. 자세한 내용은 Azure DevOps Services REST API 참조를 참조하세요. 이러한 API에 클라이언트 라이브러리 를 사용할 수도 있습니다.
파이프라인 실행의 단계 건너뛰기
파이프라인 REST API 실행과 함께 az rest 명령을 사용하여 매개 변수를 사용하여 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 CLI에서 Azure REST API 사용을 참조하세요.