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...]	하나 이상의 설치된 도구를 업그레이드합니다.
azd tool uninstall [ids...]	하나 이상의 도구를 제거합니다. ids 대화형으로 도구를 선택하지 않습니다. 대량 제거 --dry-run--output json및 .를 지원합니다.

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

도구 기술의 경우 JSON 출력은 각 에이전트에 대한 각 기술을 나열하고 필드를 포함합니다 agent . 다음은 그 예입니다.

{
  "skills": [
    {
      "id": "my-skill",
      "agent": "copilot"
    }
  ]
}

공통 플래그

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

• --all: 모든 적격 도구를 설치하거나 업그레이드합니다. install의 경우 이 명령에는 권장 도구가 모두 포함됩니다. 이 명령에는 upgrade업데이트를 사용할 수 있는 설치된 모든 도구가 포함됩니다.

install, upgrade및 uninstall 명령은 변경하지 않고 작업을 미리 볼 수 있도록 지원 --dry-run 합니다.

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

• azd는 CI/CD 또는 AI 에이전트 환경을 감지하면 자동으로 비대화형 모드로 실행될 수 있습니다.
• --no-prompt: 대화형 프롬프트를 명시적으로 표시하지 않습니다.
• AZD_NON_INTERACTIVE=true: 대화형 프롬프트를 명시적으로 표시하지 않습니다.
• AZD_NON_INTERACTIVE=false: 감지된 CI/CD 또는 AI 에이전트 환경에서도 명시적으로 프롬프트를 사용하도록 설정합니다.
• 명시적 --no-prompt 및 AZD_NON_INTERACTIVE 값은 환경 자동 감지보다 우선 적용됩니다.

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

새 머신에서 권장되는 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

업그레이드 도구

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

azd tool upgrade az-cli github-copilot-cli

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

azd tool upgrade --all

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

azd tool upgrade --all --dry-run

도구 제거

값을 전달 id 하여 하나 이상의 도구를 제거합니다.

azd tool uninstall az-cli azure-mcp-server

변경하지 않고 제거 미리 보기:

azd tool uninstall vscode-bicep --dry-run

도구 ID 없이 실행 azd tool uninstall 하여 대화형으로 도구를 선택합니다. 특정 AI 에이전트에서 기술을 제거하려면 다음을 사용합니다 --agent.

azd tool uninstall my-skill --agent copilot

스크립트 또는 파이프라인에서 제거 결과가 필요할 때 추가 --output json 합니다.

첫 실행 환경

권장 Azure 개발 도구를 검색하고 설치하려면 명시적으로 실행 azd tool 합니다. 이전 버전과는 달리 azd init, azd up, azd deploy와 같은 워크플로 명령은 더 이상 자동 도구 확인 프롬프트를 표시하지 않습니다.

다음 옵션 중 하나를 사용하여 azd tool 명령을 실행할 때 대화형 프롬프트를 건너뛸 수 있습니다.

• 명령에 --no-prompt을 전달합니다.
• 환경 변수 AZD_NON_INTERACTIVE=true를 설정합니다.
• 검색된 CI/CD 또는 AI 에이전트 환경에서 실행합니다. azd 는 대화형 프롬프트를 자동으로 무시할 수 있습니다.

감지된 CI/CD 또는 AI 에이전트 환경에서 프롬프트를 계속 사용하도록 설정하려면 다음을 설정합니다 AZD_NON_INTERACTIVE=false. 명시적 --no-prompt 및 AZD_NON_INTERACTIVE 값은 자동 감지를 무시합니다.

CI 및 비대화형 시나리오

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

• 와 함께 위치 id 인수를 installupgradeuninstall 사용하고 대화형 선택을 방지합니다.
• 프롬프트를 표시하지 않으려면 --no-prompt를 추가하거나, AZD_NON_INTERACTIVE=true를 설정하거나, CI/CD 또는 AI 에이전트 환경에서 자동 감지를 사용하세요.
• 자동 검색을 옵트아웃하고 CI/CD 또는 AI 에이전트 환경에서 계속 프롬프트를 사용하도록 설정합니다 AZD_NON_INTERACTIVE=false .
• 명시적 --no-prompt 및 AZD_NON_INTERACTIVE 값은 자동 감지를 무시합니다.
• 다운스트림 단계에 대한 구조적 결과를 캡처하는 데 사용합니다 --output json .

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

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

관련 콘텐츠

• Azure 개발자 CLI란?
• Azure Developer CLI
• Azure 개발자 CLI 명령 개요
• Azure Developer CLI 구성 관리
• Azure 개발자 CLI 확장을 사용하여 작업