콘텐츠로 이동

2. 무엇을 준비해야 하나요

도구 Windows 설치 macOS 설치
Azure CLI 2.60+ winget install Microsoft.AzureCLI brew install azure-cli
Azure Developer CLI 1.9+ winget install Microsoft.Azd brew install azd
Git 2.x winget install Git.Git brew install git
Python 3.10+ winget install Python.Python.3.12 brew install python3

Windows 주의 (중요): Python 설치 후 설정 → 앱 → 앱 실행 별칭에서 python.exe, python3.exe 를 끄세요. 켜져 있으면 python3 가 Microsoft Store 스텁으로 잡혀 구성 스크립트가 조용히 실패합니다. (이 저장소의 스크립트는 스텕을 자동 감지해 우회하도록 수정했습니다 — 6.7 발견·수정한 이슈 참고)

Bash 스크립트는 Git Bash 로 실행합니다: & "C:\Program Files\Git\bin\bash.exe" scripts/...

Azure 요구사항

  • 구독에 Owner 권한 (구독 범위 RBAC 역할 할당 필요)
  • 리소스 공급자 등록: az provider register -n Microsoft.App --wait
  • 리전 — SRE Agent 는 Korea Central 을 포함해 19개 리전을 지원합니다 (지원 리전). 이 Lab 은 기본값으로 eastus2 를 쓰며, azd env set AZURE_LOCATION <region> 으로 바꿀 수 있습니다. 구독이 SRE Agent 사용 대상으로 등록되지 않았다면 포털의 리전 목록이 비어 있습니다.

선택 사항

⚠️ fork 했다면 GITHUB_USER 를 반드시 설정하세요. 설정하지 않으면 에이전트가 업스트림 저장소를 대상으로 삼아 남의 저장소에 이슈를 만들 수 있습니다. 실제로 이 Lab 에서 발생했고, 재발 방지 조치를 넣었습니다 → 6.11

azd env set GITHUB_USER <your-github-username>

이슈를 앱 저장소가 아닌 별도 저장소에 모으고 싶다면 GITHUB_ISSUE_REPO 를 함께 지정하세요. 지정하지 않으면 GITHUB_REPO 와 같은 저장소를 사용합니다.

azd env set GITHUB_ISSUE_REPO <owner>/<repo>