다음을 통해 공유

Bicep 템플릿을 사용하여 Azure Machine Learning 허브 작업 영역 만들기

  • 아티클

Microsoft Bicep 템플릿을 사용하여 ML Studio 및 Azure AI Foundry에서 사용할 허브 작업 영역을 만듭니다. 템플릿을 사용하면 조정된 단일 작업으로 리소스를 쉽게 만들 수 있습니다. Bicep 템플릿은 배포에 필요한 리소스를 정의하는 텍스트 문서입니다. 배포 매개 변수도 지정할 수 있습니다. 매개 변수는 템플릿 사용 시 입력 값을 제공하는 데 사용됩니다.

이 문서에 사용된 템플릿은 https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics에서 찾을 수 있습니다. 원본 main.bicep 파일과 컴파일된 Azure Resource Manager 템플릿(main.json) 파일을 모두 사용할 수 있습니다. 이 템플릿은 다음과 같은 리소스를 만듭니다.

  • Azure 리소스 그룹(아직 없는 경우)
  • '허브' 종류의 Azure Machine Learning 작업 영역
  • Azure Storage Account
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Azure AI 서비스(Azure AI Foundry에 필요하고 Azure Machine Learning 사용 사례에 삭제될 수 있음)

필수 구성 요소

  • Azure 구독 아직 없는 경우 무료 계정을 만들 수 있습니다.

  • GitHub 리포지토리의 템플릿 파일 복사본입니다. GitHub 리포지토리를 로컬 컴퓨터에 복제하려면 Git을 사용할 수 있습니다. 다음 명령을 사용하여 빠른 시작 리포지토리를 로컬 컴퓨터에 복제하고 aistudio-basics 디렉터리로 이동합니다.

    git clone https://github.com/Azure/azure-quickstart-templates
cd azure-quickstart-templates/quickstarts/microsoft.machinelearningservices/aistudio-basics

  • Bicep 명령줄 도구입니다. Bicep 명령줄 도구를 설치하려면 Bicep CLI 설치 문서를 사용합니다.

템플릿 이해

Bicep 템플릿은 다음 파일로 구성됩니다.

파일 설명
main.bicep 매개 변수 및 변수를 정의하는 기본 Bicep 파일입니다. 매개 변수 및 변수를 modules 하위 디렉터리의 다른 모듈에 전달합니다.
ai-resource.bicep Azure AI 허브 리소스를 정의합니다.
dependent-resources.bicep Azure AI 허브에 대한 종속 리소스를 정의합니다. Azure Storage 계정, Container Registry, Key Vault 및 Application Insights.

Important

예제 템플릿이 항상 Azure 리소스용 최신 API 버전을 사용하는 것은 아닙니다. 템플릿을 사용하기 전에 최신 API 버전을 사용하도록 수정하는 것이 좋습니다. 각 Azure 서비스에는 고유한 API 버전 세트가 있습니다. 특정 서비스의 API에 대한 정보는 Azure REST API 참조에서 서비스 정보를 확인합니다.

AI 허브 리소스는 Azure Machine Learning을 기반으로 합니다. Azure Machine Learning용 최신 API 버전에 대한 자세한 내용은 Azure Machine Learning REST API 참조를 참조하세요. 이 API 버전을 업데이트하려면 리소스 종류에 대한 Microsoft.MachineLearningServices/<resource> 항목을 찾아 최신 버전으로 업데이트합니다. 다음 예제는 2023-08-01-preview의 API 버전을 사용하는 Azure AI 허브에 대한 항목입니다.

resource aiResource 'Microsoft.MachineLearningServices/workspaces@2023-08-01-preview' = {

Azure Resource Manager 템플릿

Bicep DSL(도메인 특정 언어)은 리소스를 정의하는 데 사용되지만, Bicep 파일은 템플릿을 배포할 때 Azure Resource Manager 템플릿으로 컴파일됩니다. GitHub 리포지토리에 포함된 main.json 파일은 컴파일된 Azure Resource Manager 버전의 템플릿입니다. 이 파일은 Bicep 명령줄 도구를 사용하여 main.bicep 파일에서 생성됩니다. 예를 들어 Bicep 템플릿을 배포하면 main.json 파일이 생성됩니다. 템플릿을 배포하지 않고 bicep build 명령을 사용하여 수동으로 main.json 파일을 만들 수도 있습니다.

bicep build main.bicep

자세한 내용은 Bicep CLI 문서를 참조하세요.

템플릿 구성

Bicep 템플릿을 실행하려면 aistudio-basics 디렉터리에서 다음 명령을 사용합니다.

  1. 새 Azure 리소스 그룹을 만들려면 다음 명령을 사용합니다. exampleRG를 리소스 그룹의 이름과 바꾸고, eastus를 사용할 Azure 지역으로 바꿉니다.

    az group create --name exampleRG --location eastus

  2. 템플릿을 실행하려면 다음 명령을 사용합니다. myai를 리소스에 사용할 이름으로 바꿉니다. 이 값은 생성된 접두사 및 접미사와 함께, 템플릿에서 만든 리소스에 대한 고유한 이름을 만드는 데 사용됩니다.

    팁

    aiResourceName는 5자 이하여야 합니다. 완전히 숫자로만 이루어지거나 ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ? 문자를 포함할 수 없습니다.

    az deployment group create --resource-group exampleRG --template-file main.bicep --parameters aiResourceName=myai