Azure CLI를 사용하여 Quantum 작업 영역 만들기

아티클
10/26/2023

이 가이드에서는 Azure CLI(Azure 명령줄 인터페이스)를 사용하여 Azure Quantum 작업 영역과 필요한 리소스 그룹 및 스토리지 계정을 만들고 Azure Quantum에서 양자 애플리케이션 실행을 시작하는 방법을 알아봅니다.

필수 조건

Azure Quantum 서비스를 사용하려면 다음이 필요합니다.

활성 구독이 있는 Azure 계정. Azure 계정이 없는 경우 무료로 등록하고 종량제 구독에 등록합니다.
양자 작업 영역이 있는 Azure 리소스 그룹입니다.
Quantum 작업 영역에 연결할 리소스 그룹의 스토리지 계정. 동일한 계정에 여러 작업 영역을 연결할 수 있습니다.
Azure CLI
Microsoft Quantum Development Kit.

환경 설정

Azure CLI quantum 확장을 설치합니다. 명령 프롬프트를 열고 다음 명령을 실행합니다. 이전 버전이 이미 설치된 경우에도 확장을 업그레이드합니다.
```
az extension add --upgrade -n quantum
```
로그인 정보를 사용하여 Azure에 로그인합니다. 계정과 연결된 구독 목록이 표시됩니다.
```
az login
```

사용할 구독을 지정합니다.

az account set -s <Your subscription ID>

구독에서 양자 작업 영역을 처음 만드는 경우 이 명령을 사용하여 리소스 공급자를 등록합니다.
```
az provider register --namespace Microsoft.Quantum
```

Azure Quantum 작업 영역 만들기

새 Azure Quantum 작업 영역을 만들려면 다음을 알아야 합니다.

리소스가 있는 위치 또는 Azure 지역 이름. Azure CLI 도구에서 지원하는 지역 및 관련 리소스 관리자 코드 목록을 사용할 수 있습니다(예: westus).
새 작업 영역과 연결된 리소스 그룹(예: MyResourceGroup).
양자 작업 영역과 동일한 리소스 그룹 및 구독에 있는 스토리지 계정. Az CLI 도구에서 새 스토리지 계정을 만들 수 있습니다(예: MyStorageAccount).
만들 양자 작업 영역의 이름입니다(예: MyQuantumWorkspace).
작업 영역에서 사용할 Azure Quantum 공급자 목록입니다. 공급자는 일련의 플랜을 제공하며, 각 SKU는 관련 계약조건, 비용 및 할당량을 포함하는 플랜을 나타냅니다. 작업 영역을 만들려면 무료 크레딧을 제공하는 공급자로 시작하지 않는 한 공급자와 함께 해당 계획을 지정해야 합니다. 이 플랜은 작업 영역에 자동으로 추가됩니다.

작업 영역에서 사용할 공급자 및 플랜 이름을 이미 알고 있는 경우 아래 4단계로 건너뛸 수 있습니다. 무료 크레딧을 제공하는 공급자와 함께 시작하려면 다음 명령을 입력할 수 있습니다.

az quantum workspace create \
   -l MyLocation \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyStorageAccount

사용 약관에 동의하라는 메시지가 표시될 수 있습니다. 약관에 동의하려면 Y를 입력하세요. 아래의 4단계에 표시된 -r 매개 변수는 필요하지 않았습니다.

사용할 공급자 및 플랜을 결정해야 하는 경우 다음과 같이 진행합니다.

사용 가능한 양자 공급자 목록을 검색하려면 list 명령을 사용합니다(이 예에서는 westus를 위치로 사용).
```
az quantum offerings list \
     -l westus \
     -o table
```
팁

어떤 공급자가 무료 크레딧을 제공하는지 확인하려면 --autoadd-only 매개 변수를 사용하십시오. 예를 들면 다음과 같습니다.
az quantum offerings list --autoadd-only -l westus -o table
이전에 언급했듯이 해당 공급자는 작업 영역에 자동으로 추가됩니다. -r 매개 변수를 사용하여 지정할 필요가 없습니다.
공급자를 결정하고 작업 영역에 포함할 계획이 있으면 show-terms 명령을 사용하여 용어를 검토할 수 있습니다(예제 값으로 MyProviderID 및 MyPlan 추가).
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
show-terms 명령의 출력에는 해당 공급자의 사용 약관에 이미 동의했는지 보여주는 accepted 부울 필드와 검토할 사용 조건에 대한 링크가 포함되어 있습니다. 해당 조건에 동의하기로 결정한 경우 accept-terms 명령을 사용하여 동의를 기록합니다.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
모든 필수 사용 약관을 검토하고 동의한 후에는 create 명령을 사용하여 작업 영역을 만들어, 아래 예제와 같이 쉼표로 구분된 공급자 및 플랜 조합 목록을 지정할 수 있습니다.
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

작업 영역을 만든 후에도 Azure Portal 사용하여 공급자를 추가하거나 제거할 수 있습니다.

양자 작업 영역에 대한 기본 스토리지 계정 변경

기존 작업 영역에 대한 기본 스토리지 계정을 변경해야 하는 경우 새 스토리지 계정과 함께 모든 현재 속성을 지정하는 create 명령을 사용할 수 있습니다. 다음 예제에서는 이전 예제에서 만든 작업 영역과 동일한 설정을 사용합니다.

az quantum workspace create \
   -l westus \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyNEWStorageAccount \
   -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

중요

이 절차는 실제로 새 스토리지 계정으로 작업 영역을 다시 만듭니다. 스토리지 계정 이외의 모든 속성이 원래 속성과 정확히 동일한지 확인합니다. 그렇지 않으면 두 번째 작업 영역이 만들어집니다.

양자 작업 영역 삭제

삭제할 양자 작업 영역의 이름과 리소스 그룹을 알고 있는 경우 delete 명령을 사용하여 작업 영역을 삭제할 수 있습니다(앞의 예제와 동일한 이름 사용).

az quantum workspace delete \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

팁

정확한 이름이 기억나지 않는 경우 az quantum workspace list -o table을 사용하여 구독의 전체 Quantum 작업 영역 목록을 볼 수 있습니다.

작업 영역을 삭제한 후에도 클라우드에서 삭제되는 동안에도 여전히 나열됩니다. 그러나 작업 영역의 provisioningState 속성은 삭제 중임을 나타내기 위해 즉시 변경됩니다. show 명령을 사용하여 해당 정보를 확인할 수 있습니다.

az quantum workspace show \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

참고

이전에 az quantum workspace set 명령을 사용하여 기본 양자 작업 영역을 지정한 경우 매개 변수 없이 delete 명령을 호출하면 기본 작업 영역을 삭제하고 지웁니다.

az quantum workspace delete

다음 단계

이제 작업 영역을 만들고 삭제할 수 있으므로 Azure Quantum에서 양자 알고리즘을 실행하는 다양한targets 방법에 대해 알아봅니다.