azd tool 사용하여 Azure 개발 도구 관리

Azure 개발자 CLI(azd)에는 Azure 애플리케이션을 빌드하고 배송하는 데 사용되는 일반적인 도구의 상태를 검색, 설치, 업그레이드 및 확인하기 위한 기본 제공 azd tool 명령 그룹이 포함되어 있습니다. 일관된 하위 명령 집합 뒤에 각 플랫폼(예: winget,brew, aptnpm및 VS Code code CLI)의 기본 패키지 관리자를 래핑하고 대화형 사용 및 자동화를 모두 지원합니다.

일반적인 사용 사례는 다음과 같습니다.azd tool

  • 단일 명령을 사용하여 새 컴퓨터에 권장되는 모든 Azure 개발 도구 설치
  • 팀 또는 CI 에이전트 집합에서 개발 환경을 표준화합니다.
  • 특정 컴퓨터에 설치된 Azure 도구(및 해당 버전) 감사
  • 설치된 도구에 대한 업데이트를 확인하고 적용합니다.
  • 비대화형 플래그 및 JSON 출력을 사용하여 파이프라인에서 스크립팅 도구 설정

기본 제공 도구

기본 제공 레지스트리에는 다음 도구가 포함되어 있습니다. 범주 및 우선 순위 열을 사용하여 지정된 워크플로에 적용되는 도구를 결정합니다.

아이디 Name Category 우선순위 일반적인 설치 전략
az-cli Azure CLI cli 권장 winget / brew / apt
github-copilot-cli GitHub Copilot 명령 줄 인터페이스 (CLI) cli 권장 winget / brew / npm
vscode-azure-tools Azure 도구(VS Code) extension 권장 code 커맨드 라인 인터페이스 (CLI)
vscode-bicep Bicep(VS Code) extension 권장 code 커맨드 라인 인터페이스 (CLI)
vscode-github-copilot GitHub Copilot(VS Code) extension Optional code 커맨드 라인 인터페이스 (CLI)
azure-mcp-server Azure MCP 서버 server Optional npm
azd-ai-extensions azd AI 확장 프로그램 library Optional azd extension

정확한 설치 전략은 운영 체제 및 컴퓨터에서 사용할 수 있는 패키지 관리자에 따라 달라집니다.

비고

VS Code 확장을 사용하려면 code CLI를 PATH에서 사용할 수 있어야 합니다. 사용할 수 없는 경우 code 도구는 설치되지 않은 것으로 표시되며 이를 통해 azd tool설치할 수 없습니다.

명령 개요

명령 그룹에는 azd tool 다음 하위 명령이 포함됩니다.

Command Description
azd tool 설치 및 사용 가능한 도구를 보여 주는 대화형 흐름을 시작하고 한 단계에서 설치할 도구를 묻는 메시지를 표시합니다.
azd tool list 설치 상태, 버전, 범주 및 우선 순위를 포함하여 등록된 모든 도구를 나열합니다.
azd tool show <id> 플랫폼별 설치 전략 및 프로젝트 웹 사이트를 포함하여 특정 도구에 대한 자세한 정보를 표시합니다.
azd tool check 설치된 도구에서 사용 가능한 업데이트를 확인합니다.
azd tool install [ids...] id로 하나 이상의 도구를 설치합니다.
azd tool upgrade [ids...] 하나 이상의 설치된 도구를 업그레이드합니다.

모든 명령은 스크립트와 파이프라인에서 사용하기에 적합한 --output json기계가 읽을 수 있는 출력을 지원합니다.

공통 플래그

다음 플래그를 사용할 수 있습니다.installupgrade

  • --all: 모든 적격 도구를 설치하거나 업그레이드합니다. install의 경우 이 명령에는 권장 도구가 모두 포함됩니다. 이 명령에는 upgrade업데이트를 사용할 수 있는 설치된 모든 도구가 포함됩니다.
  • --dry-run: 변경하지 않고 수행할 작업을 azd 미리 봅니다.

다음 옵션은 프롬프트 동작을 제어합니다.

  • --no-prompt: 대화형 프롬프트를 표시하지 않습니다. 스크립트에 유용합니다.
  • AZD_NON_INTERACTIVE=true: 에 해당하는 환경 변수입니다 --no-prompt.
  • AZD_SKIP_FIRST_RUN=true: 첫 실행 도구 확인 프롬프트를 사용하지 않도록 설정합니다.

예시 사용 사례: 개발 머신 설정

새 머신에서 권장되는 Azure 개발 도구의 전체 집합을 설정하려면 다음 명령을 실행합니다.

azd tool install --all

이 명령은 현재 플랫폼에 적합한 패키지 관리자를 사용하여 레지스트리에 표시된 recommended 모든 도구를 설치합니다. 변경하지 않고 설치 작업을 미리 보려면 다음을 추가합니다 --dry-run.

azd tool install --all --dry-run

설치된 도구를 최신 상태로 유지하려면 다음 명령을 실행합니다.

azd tool check
azd tool upgrade --all

설치된 도구 및 사용 가능한 도구 나열

실행 azd tool list 하여 등록된 모든 도구, 설치 상태 및 설치된 버전을 표시합니다.

$ azd tool list

  Id                     Name                      Category    Priority      Status          Version
  ─────────────────────  ────────────────────────  ──────────  ────────────  ──────────────  ────────
  az-cli                 Azure CLI                 cli         recommended   Installed       2.67.0
  github-copilot-cli     GitHub Copilot CLI        cli         recommended   Not Installed
  vscode-azure-tools     Azure Tools (VS Code)     extension   recommended   Installed       0.9.0
  vscode-bicep           Bicep (VS Code)           extension   recommended   Installed       0.30.0
  vscode-github-copilot  GitHub Copilot (VS Code)  extension   optional      Not Installed
  azure-mcp-server       Azure MCP Server          server      optional      Not Installed
  azd-ai-extensions      azd AI Extensions         library     optional      Not Installed

스크립팅을 위해 JSON과 동일한 데이터를 반환하려면 다음을 실행합니다.

azd tool list --output json

도구에 대한 세부 정보 표시

실행 azd tool show <id> 하여 지원되는 각 플랫폼 및 프로젝트 웹 사이트에 적용되는 설치 전략을 포함하여 특정 도구를 검사합니다.

azd tool show az-cli

하나 이상의 도구 설치

하나 이상의 도구 id 값을 전달하여 특정 도구를 설치합니다.

azd tool install az-cli vscode-bicep

권장되는 모든 도구를 설치하려면 다음을 사용합니다 --all.

azd tool install --all

설치 명령을 실행하지 않고 미리 보려면 다음을 추가 --dry-run합니다.

azd tool install az-cli --dry-run

하위 명령 없이 실행 azd tool 하면 설치된 도구를 표시하고, 추가 도구를 선택할 수 있으며, 한 단계로 설치하는 대화형 흐름이 시작됩니다.

업데이트 확인

실행 azd tool check 하여 설치된 도구에서 사용 가능한 업데이트를 검색합니다.

azd tool check

azd 또한 정기적인 백그라운드 업데이트 검사를 실행하고 최신 버전의 등록된 도구를 사용할 수 있는 경우 비침입 알림을 표시합니다.

업그레이드 도구

id 값을 전달하여 특정 도구를 업그레이드하세요:

azd tool upgrade az-cli github-copilot-cli

사용 가능한 업데이트가 있는 모든 항목을 업그레이드합니다.

azd tool upgrade --all

업그레이드 계획을 적용하지 않고 미리 봅니다.

azd tool upgrade --all --dry-run

첫 실행 환경

워크플로 명령(예: azd initazd up실행)azd deployazd 이 처음으로 일회성 도구 검사를 수행하고 권장 도구를 검토하거나 설치하라는 메시지를 표시합니다.

다음 옵션을 사용하여 첫 실행 프롬프트를 건너뛰거나 사용하지 않도록 설정합니다.

  • 워크플로 명령에 --no-prompt를 전달합니다.
  • 환경 변수 AZD_SKIP_FIRST_RUN=true를 설정합니다.
  • 감지된 CI 환경에서 실행합니다. azd가 설정되면 프롬프트 CITF_BUILDGITHUB_ACTIONS 를 자동으로 무시합니다.

CI 및 비대화형 시나리오

azd tool 명령 그룹은 다음 옵션을 통해 파이프라인 및 스크립트를 지원합니다.

  • 대화형 선택을 피하려면 id 및 install와 함께 위치 인수 upgrade를 사용하세요.
  • 프롬프트가 표시되지 않도록 --no-prompt을 추가하거나 AZD_NON_INTERACTIVE=true을 설정하세요.
  • 다운스트림 단계에 대한 구조적 결과를 캡처하는 데 사용합니다 --output json .
  • 첫 실행 프롬프트와 백그라운드 업데이트 알림이 표시되지 않도록 CI 자동 감지를 사용합니다.

다음 예제에서는 파이프라인 단계에서 Azure CLI 및 Bicep 확장을 설치합니다.

azd tool install az-cli vscode-bicep --no-prompt --output json

관련 콘텐츠

  • Last updated on