개발 환경 준비

Microsoft Foundry를 사용하여 빌드할 개발 환경을 준비합니다. 지원되는 프로그래밍 언어, 인증용 Azure CLI, Git 및 Foundry 개발자 도구가 필요합니다.

Tip

Foundry DevPack은 개발자 도구를 하나의 명령에 설치하는 데 권장되는 방법입니다. 각 도구를 별도로 설치할 수도 있습니다.

중요

이 문서에서는 일반적인 필수 구성 요소, 전역 도구 및 Visual Studio Code 설정에 대해 설명합니다. 시나리오별 SDK 패키지 또는 인증 코드는 다루지 않습니다. 환경이 준비되면 빠른 시작을 계속합니다.

필수 구성 요소

  • 활성 구독이 있는 Azure 계정입니다. 계정이 없는 경우, 무료 평가판 구독이 포함된 무료 Azure 계정을 만드세요.

  • Visual Studio Code 다운로드, 설치 및 구성하거나 원하는 IDE를 사용합니다.

  • Foundry 리소스를 만들고 관리하려면 다음 Azure RBAC 역할 중 하나를 사용합니다.

    • Foundry Project Manager를 사용하여 Foundry 프로젝트를 관리합니다.

    중요

    Foundry RBAC 역할의 이름이 최근에 바뀌었습니다. Foundry User, Foundry OwnerFoundry 계정 소유자 및 Foundry Project Manager는 이전에 Azure AI 사용자, Azure AI 소유자, Azure AI 계정 소유자 및 Azure AI Project Manager로 이름이 지정되었습니다. 이름 바꾸기가 롤아웃되는 동안 일부 위치에서는 이전 이름이 계속 표시될 수 있습니다. 역할 ID 및 핵심 권한은 이름 바꾸기에 의해 변경되지 않습니다.

    • 일부 시나리오에 필요한 구독 수준 권한 및 역할 할당의 소유자입니다.

  • 리소스를 만들지 않고 기존 프로젝트를 사용하려면 프로젝트에 적어도 Foundry 사용자가 필요합니다.

각 역할에 대한 자세한 내용은 Microsoft Foundry에 대한 역할 기반 액세스 제어를 참조하세요.

Foundry DevPack 설치

Foundry DevPack은 편집기, 터미널 및 코딩 에이전트용 Foundry 개발자 도구를 설치합니다. 운영 체제에 대한 명령을 실행합니다.

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

DevPack은 다음 도구를 설치합니다.

Tool 수행 가능한 작업
Microsoft Foundry Toolkit for Visual Studio Code Visual Studio Code 빌드, 테스트, 평가 및 배포합니다.
azd 및 azd ai 터미널에서 스캐폴드, 배포, 평가 및 자동화합니다.
Foundry Canvas(미리 보기) 안내된 Copilot 캔버스를 사용하여 호스트된 에이전트를 디자인하고 배포합니다.
Microsoft 파운드리 기술 Foundry 워크플로에 대해 코딩 에이전트에 재사용 가능한 지침을 제공합니다.

다음 섹션을 계속 진행하여 프로그래밍 언어를 설정하고, Azure CLI 로그인하고, Git을 설치합니다.

프로그래밍 언어 사용

애플리케이션에 필요한 언어를 사용합니다. 해당 런타임 또는 Visual Studio Code 확장을 설치해야 하는 경우 섹션을 확장합니다.

파이썬

Python 3.10 이상을 설치합니다. Python 3.9는 지원되는 최소 버전입니다. 패키지를 전역적으로 설치하는 대신 프로젝트에 대한 가상 환경을 만듭니다.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS 및 Linux

python3 -m venv .venv
source .venv/bin/activate

편집기 지원을 위해 Visual Studio Code Python 확장을 설치합니다.

Java

JDK 17 이상을 설치합니다. OpenJDK의 Microsoft Build는 무료 장기 지원 배포판입니다. 편집기 지원을 위해 Java Visual Studio Code 확장 팩을 설치합니다.

JavaScript/TypeScript

Node.js를 설치합니다. 버전 20 이상을 사용하는 것이 좋습니다.

C#

.NET SDK의 최신 Long-Term 지원 버전을 설치합니다. 편집기 지원을 위해 Visual Studio Code C# Dev Kit를 설치합니다.

Azure CLI 설치하고 로그인

코드에서 사용자 자격 증명을 사용하여 Foundry를 통해 Azure 서비스를 호출할 수 있도록 Azure CLI 설치하고 로컬 개발 환경에서 로그인합니다.

대부분의 경우 다음 명령을 사용하여 터미널에서 Azure CLI 설치할 수 있습니다.

winget install -e --id Microsoft.AzureCLI

이러한 명령이 특정 운영 체제 또는 설정에 작동하지 않는 경우 Azure CLI 설치하는 방법에 대한 지침을 따를 수 있습니다.

Azure CLI 설치한 후 az login 명령을 사용하여 로그인하고 브라우저를 사용하여 로그인합니다.

az login

또는 디바이스 코드를 사용하여 브라우저를 통해 수동으로 로그인할 수 있습니다.

az login --use-device-code

로그인한 후 스크립트를 실행하려면 이 터미널을 열어 둡니다.

Git 설치

Foundry SDK 샘플을 복제하려면 Git이 필요합니다. Git이 설치되어 있지 않은 경우 Git 웹 사이트에서 다운로드하여 설치합니다.

개별적으로 개발자 도구 설치

Foundry DevPack을 사용하지 않는 경우 각 개발자 도구를 별도로 설치합니다.

  1. Azure 개발자 CLI를 설치하세요.
  2. azd용 모든 Foundry 확장 설치: 
    azd ext install microsoft.foundry
    개별 확장을 설치하려면 Azure 개발자 CLI Foundry 확장 설치를 참조하세요.
  3. 편집기 및 코딩 에이전트 도구를 설치합니다.

많은 AI 솔루션 템플릿은 azd를 사용한 배포를 지원합니다.

문제 해결

문제 해상도
설치 후 명령을 찾을 수 없음 터미널을 닫고 다시 열거나 Visual Studio Code 다시 시작하여 PATH 변경 내용을 적용합니다.
az login 브라우저 오류와 함께 실패 디바이스 코드를 사용하여 인증하려면 실행 az login --use-device-code 합니다.
Python 찾을 수 없음 macOS 또는 Linux에서는 python3 대신 python을 사용하거나 Python 3.9 이상을 설치하세요.
Python 패키지 설치 중 사용 권한이 거부됨 macOS 또는 Linux에서는 sudo pip install를 사용하지 마세요. 대신 가상 환경을 사용합니다.

관련 콘텐츠

  • Last updated on