Azure Skills 설치 및 구성

이 문서에서는 Azure Skills를 설치하고, Azure 계정에 인증하고, 설치를 확인하는 방법을 보여 줍니다. 설정 후 채팅 인터페이스에서 Azure 리소스를 관리할 수 있습니다.

사전 요구 사항

다음이 있는지 확인합니다.

• Node.js LTS(장기 지원): nodejs.org 다운로드 하거나 nvm과 같은 버전 관리자를 사용합니다.
• Azure 계정: 무료 계정을 만드세요 없다면.
• AI 도우미: GitHub Copilot CLI, Claude Code 또는 호환되는 다른 플랫폼.
• Azure CLI(로컬 개발에 권장): 인증을 간소화합니다. Azure CLI를 설치합니다. 환경 변수 또는 관리 ID는 CI/CD 파이프라인의 대안으로 사용할 수 있습니다.

메모

Azure Skills는 Azure MCP Server 동일한 인증을 사용합니다. Azure MCP Server에 대해 이미 인증된 경우 Azure Skills는 해당 자격 증명을 사용합니다.

Azure에 인증하기

Azure 기술에는 Azure 리소스에 액세스하기 위한 자격 증명이 필요합니다. 사용 사례에 맞는 메서드를 선택합니다.

Azure CLI(권장)

이 방법은 로컬 개발 및 테스트에 가장 쉽습니다.

1. Azure CLI 설치:

   • Azure CLI 설치 가이드 방문하세요.
   • 또는 패키지 관리자 brew install azure-cli (macOS) apt-get install azure-cli (Linux)를 사용합니다.

2. Azure:

   az login
   

   브라우저 창이 열립니다. Azure 계정 자격 증명을 사용하여 로그인합니다.

3. 인증 확인:

   az account show
   

   터미널에 구독 세부 정보가 표시됩니다. Azure Skills는 이 인증을 검색합니다.

환경 변수

Azure CLI 사용할 수 없는 스크립트 또는 파이프라인에 환경 변수를 사용합니다. 먼저 서비스 주체 를 만듭니다.

Bash 또는 Zsh:

export AZURE_TENANT_ID="your-tenant-id"
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"

PowerShell:

$env:AZURE_TENANT_ID = "your-tenant-id"
$env:AZURE_CLIENT_ID = "your-client-id"
$env:AZURE_CLIENT_SECRET = "your-client-secret"

Windows 명령 프롬프트:

set AZURE_TENANT_ID=your-tenant-id
set AZURE_CLIENT_ID=your-client-id
set AZURE_CLIENT_SECRET=your-client-secret

Azure Skills는 이러한 환경 변수를 자동으로 검색합니다.

관리되는 아이덴티티

Azure 리소스(가상 머신, Container Apps 또는 Azure Functions)에서 Azure Skills를 실행하는 경우 관리 ID는 수동 설정 없이 인증을 처리합니다.

자세한 내용은 Azure 관리 ID 참조하세요.

Azure 스킬 설치

AI 도우미에 대한 설치 방법을 선택합니다.

GitHub Copilot CLI

마켓플레이스 추가(처음만 해당):

/plugin marketplace add microsoft/azure-skills

플러그 인을 설치합니다.

/plugin install azure@azure-skills

플러그 인을 업데이트합니다.

/plugin update azure@azure-skills

Visual Studio Code

Visual Studio Marketplace에서 Azure MCP 확장을 설치합니다.

👉 Azure MCP 확장

Azure MCP 확장은 Visual Studio Code에 Azure 스킬을 제공하는 동반 확장을 설치합니다. 함께 Azure MCP 서버와 전체 기술 계층을 구성합니다.

메모

기술 확장을 사용하려면 컴퓨터에 Git CLI 를 설치해야 합니다.

Claude 코드

마켓플레이스 추가(처음만 해당):

/plugin marketplace add microsoft/azure-skills

플러그 인을 설치합니다.

/plugin install azure@azure-skills

업데이트:

/plugin marketplace update azure-skills

Cursor

Cursor Marketplace 또는 Cursor 설정에서 직접 Azure 플러그인을 설치합니다.

1. 설정>플러그 인으로 이동합니다.

2. Azure를 검색 합니다.

3. Azure 플러그 인을 선택하여 설치합니다.

   

플러그 인은 Azure MCP Server, Foundry MCP 및 전체 기술 계층을 자동으로 구성합니다.

IntelliJ IDEA

IntelliJ IDEA에 Azure Skills를 설치하기 전에 다음이 있는지 확인합니다.

• Node.js 18 이상이 설치되어 있고, npx이 PATH에서 사용 가능한 시스템에 설치되어 있어야 합니다.
• Git 이 설치되고 명령줄에서 액세스할 수 있습니다.

다음을 실행하여 이러한 필수 구성 요소를 확인할 수 있습니다.

npx --version
git --version

1단계: GitHub Copilot 플러그 인 설치

1. IntelliJ IDEA를 엽니다.
2. 파일>설정(Windows/Linux) 또는 IntelliJ IDEA>기본 설정(macOS)으로 이동합니다.
3. 왼쪽 사이드바의 플러그 인 으로 이동합니다.
4. Marketplace 탭에서 GitHub Copilot 를 검색합니다.
5. GitHub Copilot 플러그 인을 설치합니다(버전 1.5.64-242 이상 필요).
6. 메시지가 표시되면 IntelliJ IDEA를 다시 시작합니다.

2단계: GitHub Copilot에 대한 기술 사용

1. IntelliJ IDEA 설정 또는 기본 설정을 다시 엽니다.

2. 도구>GitHub Copilot 채팅으로> 이동합니다.

3. 기술 사용 확인란을 선택합니다.

4. 적용 및 확인을 선택합니다.

   

3단계: Azure Skills 설치

옵션 1: IntelliJ용 Azure 도구 키트

1. JetBrains Marketplace에서 IntelliJ용 Azure 도구 키트 플러그 인을 설치합니다.

2. IntelliJ IDEA를 다시 시작하여 플러그 인 설치를 완료합니다.

3. 다시 시작한 후 Azure Skills를 설치하라는 알림이 표시됩니다. 설치를 선택하여 환경에 Azure 기술을 추가합니다.

   

4. GitHub Copilot 채팅 창을 열고 입력하여 설치를 확인합니다 /skill:azure. 이 명령은 사용 가능한 모든 Azure 기술을 표시합니다.

   

옵션 2: 수동 설치

1. 터미널 또는 명령 프롬프트를 엽니다.

2. 다음 명령을 실행하여 GitHub Copilot용 Azure Skills를 전역적으로 설치합니다.

   npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
   

3. 설치가 완료되기를 기다립니다. Azure 기술이 성공적으로 추가되면 확인 메시지가 나타납니다.

지원되는 호스트 및 설치 옵션의 전체 목록은 Azure Skills 리포지토리 참조하세요.

설치 확인

설치 후 Azure 기술을 사용할 준비가 됐는지 확인합니다.

1. 설치된 플러그 인을 나열합니다.

   /plugin list
   

   출력에는 azure@azure-skills 및 사용 가능한 기술이 포함됩니다.

2. 빠른 명령으로 테스트:

   /ask List my Azure subscriptions
   

   AI 도우미는 Azure 계정을 쿼리하고 구독을 표시합니다.

Azure 기술 사용해 보기

Azure Skills를 설치하고 확인한 후 AI 도우미의 채팅 창에서 다음 프롬프트를 시도합니다.

프로젝트에 대한 배포 계획을 준비합니다.

Analyze my project structure and prepare a deployment plan for deploying to Azure. What infrastructure do I need and how should I set it up?

예상 응답: 도우미는 코드베이스를 분석하고 코드 기반 인프라 템플릿을 생성합니다. 배포 계획을 .azure/plan.md 만들고 승인을 요청합니다.

Azure 리소스 상태 문제를 진단합니다:

I'm getting errors from my Azure App Service. What's wrong and how do I fix it?

예상 응답: 도우미가 앱 서비스를 검사하고, 로그를 확인하고, 최근 배포를 검토합니다. 문제를 식별하고 수정 단계를 제공합니다.

모니터링 및 관찰 가능성 설정:

Configure monitoring and alerting for my application. Which Application Insights features should I enable? What metrics should I track?

예상 응답: 도우미는 모니터링 전략을 제안하고 계측 코드를 생성합니다. 앱 스택에 맞게 조정된 중요한 메트릭에 대한 Azure 경고를 구성합니다.

지원되는 AI 도우미

이러한 플랫폼에서 Azure 기술을 사용할 수 있습니다.

• GitHub Copilot CLI: GitHub Copilot 도구와의 완전한 통합
• Claude 코드: MCP(모델 컨텍스트 프로토콜)를 통해
• 기타 MCP 호환 AI 도우미: MCP를 지원하는 모든 도구

Azure 통합을 지원하는 도구의 전체 목록은 Azure MCP Server 지원 도구 참조하세요.

구성 옵션

테레메트리

기본적으로 Azure Skills는 사용량 원격 분석을 수집하여 서비스를 개선합니다.

원격 분석을 사용하지 않도록 설정하려면 다음을 수행합니다.

export AZURE_MCP_COLLECT_TELEMETRY=false

Troubleshooting

"실패한 인증" 오류

Problem: AI 도우미는 Azure 인증할 수 없습니다.

솔루션:

• Azure CLI:az login 다시 실행하고 인증되었는지 확인합니다.
• 환경 변수: 확인 AZURE_TENANT_ID, AZURE_CLIENT_ID및 AZURE_CLIENT_SECRET 올바르게 설정됩니다.
• 관리 ID: Azure 리소스에 할당된 관리 ID가 있는지 확인합니다.

"플러그 인을 찾을 수 없음" 오류

Problem: Azure Skills 플러그 인이 설치되거나 인식되지 않습니다.

솔루션:

• 마켓플레이스를 등록하려면 .를 실행합니다 /plugin marketplace add microsoft/azure-skills .
• 플러그 인을 설치하려면 .를 실행합니다 /plugin install azure@azure-skills.
• AI 도우미를 다시 시작합니다.
• Node.js 설치되어 있는지 확인합니다.

"권한 부족" 오류

Problem: Azure 계정에 필요한 권한이 없습니다.

솔루션:

• Azure RBAC(역할 기반 액세스 제어) 역할 할당 확인합니다.
• Azure 관리자에게 더 많은 역할을 요청합니다.
• 더 높은 권한이 있는 다른 구독을 사용합니다.

"잘못된 구독" 오류

Problem: Azure Skills는 지정된 구독을 찾거나 액세스할 수 없습니다.

솔루션:

• 사용 가능한 구독을 보려면 az account list를 실행하십시오.
• 구독 ID 또는 이름이 올바른지 확인합니다.
• 자격 증명이 구독에 액세스할 수 있는지 확인합니다.

관련 콘텐츠

• Azure Skills로 시작했습니다
• Azure 기술 개요
• Azure용 GitHub Copilot
• Azure MCP Server 시작 가이드