Microsoft Foundry를 사용하여 빌드할 개발 환경을 준비합니다. 워크플로에 맞는 지원되는 프로그래밍 언어, Git 및 Foundry 개발자 도구가 필요합니다.
Tip
Foundry DevPack은 개발자 도구를 하나의 명령에 설치하는 데 권장되는 방법입니다. 각 도구를 별도로 설치할 수도 있습니다.
중요
이 문서에서는 일반적인 필수 구성 요소 및 개발자 도구에 대해 설명합니다. 시나리오별 SDK 패키지 또는 인증 코드는 다루지 않습니다. 환경이 준비되면 빠른 시작을 계속합니다.
필수 구성 요소
- 활성 구독이 있는 Azure 계정입니다. 계정이 없는 경우, 무료 평가판 구독이 포함된 무료 Azure 계정을 만드세요.
- 사용하려는 Foundry 리소스 또는 프로젝트에 액세스합니다. 설치 지침은 시작할 최소 역할 할당을 참조하세요.
Foundry DevPack 설치
Foundry DevPack은 터미널, 편집기 및 코딩 에이전트용 Foundry 개발자 도구를 설치합니다. 운영 체제를 선택합니다.
DevPack은 핵심 도구를 설치하고 앱이 있는 경우에만 호스트 확장을 추가합니다.
| Tool | 수행 가능한 작업 |
|---|---|
azd 및 azd ai |
터미널에서 스캐폴드, 배포, 평가 및 자동화합니다. |
| Microsoft 파운드리 기술 | Foundry 워크플로에 대해 코딩 에이전트에 재사용 가능한 지침을 제공합니다. |
| Microsoft Foundry Toolkit for Visual Studio Code | Visual Studio Code 있는 경우에만 설치됩니다. 편집기에서 빌드, 테스트, 평가 및 배포합니다. |
| Foundry Canvas(미리 보기) | GitHub Copilot 앱이 있는 경우에만 설치됩니다. 안내 캔버스에서 호스트된 에이전트를 디자인하고 배포합니다. |
DevPack은 Visual Studio Code 또는 GitHub Copilot 앱을 설치하지 않습니다.
다음 섹션을 계속 진행하여 프로그래밍 언어를 설정하고 Git을 설치합니다.
프로그래밍 언어 사용
애플리케이션에 필요한 언어를 사용합니다. 탭을 선택하여 해당 런타임 또는 Visual Studio Code 확장을 설치합니다.
Python 3.10 이상을 설치합니다. Python 3.10은 지원되는 최소 버전입니다. 패키지를 전역적으로 설치하는 대신 프로젝트에 대한 가상 환경을 만듭니다.
Windows
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
macOS 및 Linux
python3 -m venv .venv
source .venv/bin/activate
편집기 지원을 위해 Visual Studio Code Python 확장을 설치합니다.
Git 설치
Foundry SDK 샘플을 복제하려면 Git이 필요합니다. Git이 설치되어 있지 않은 경우 Git 웹 사이트에서 다운로드하여 설치합니다.
개발자 도구를 별도로 설치
Foundry DevPack을 사용하지 않는 경우 탭을 선택하여 필요한 도구만 설치합니다.
Foundry 확장을 설치합니다.
azd ext install microsoft.foundry
전체 번들 대신 개별 확장을 설치하려면 Azure Developer CLI Foundry 확장 설치를 참조하세요.
개별 Azure 리소스를 직접 세분화하여 관리하려면 Azure CLI(az)를 사용합니다.
Azure Developer CLI와 Azure CLI 비교를 참조하세요.
문제 해결
| 문제 | 해상도 |
|---|---|
| 설치 후 명령을 찾을 수 없음 | 터미널을 닫고 다시 엽니다. Visual Studio Code 사용하는 경우 PATH 변경 내용이 적용되도록 다시 시작합니다. |
| Python 찾을 수 없음 | macOS 또는 Linux에서는 python3 대신 python를 사용하거나 Python 3.10 이상 버전을 설치합니다. |
| Python 패키지 설치 중 사용 권한이 거부됨 | macOS 또는 Linux에서는 sudo pip install를 사용하지 마세요. 대신 가상 환경을 사용합니다. |