Azure CLI를 사용하여 양자 작업 영역 관리

2025-08-19

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

필수 조건

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

활성 구독이 있는 Azure 계정. Azure 계정이 없는 경우 무료로 등록하고 종량제 구독을 신청하십시오.
양자 작업 영역이 있는 Azure 리소스 그룹입니다.
양자 작업 영역과 연결할 리소스 그룹의 스토리지 계정입니다. 여러 작업 영역을 동일한 계정과 연결할 수 있습니다.
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 작업 영역 만들기

경고

2025년 9월 30일에 Azure Quantum 서비스는 미국 동부, 미국 서부, 북유럽 및 서유럽 지역에서만 사용할 수 있습니다. 이러한 지역 중 하나에 새 Quantum 작업 영역을 만듭니다. 기존 작업 영역이 이러한 지역 중 하나에 없는 경우 Azure Quantum 작업 데이터 마이그레이션을 참조하세요.

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

리소스를 만들 위치 또는 Azure 지역 이름입니다. azure CLI 도구에서 지원하는 지역 및 해당 리소스 관리자 코드의 목록(예: westus )을 사용할 수 있습니다.
새 작업 영역과 연결된 리소스 그룹(예: MyResourceGroup.
양자 작업 영역과 동일한 리소스 그룹 및 구독에 있는 스토리지 계정입니다. Az CLI 도구 (예: MyStorageAccount )에서 새 스토리지 계정을만들 수 있습니다.
만들 양자 작업 영역의 이름입니다(예: MyQuantumWorkspace ).
작업 영역에서 사용할 Azure Quantum 공급자 목록입니다. 공급자는 각각 관련 사용 약관, 비용 및 할당량이 있는 계획을 나타내는 일련의 계획을 제공합니다. 작업 영역을 만들려면 공급자와 함께 해당 계획을 지정해야 합니다.

작업 영역에서 사용할 공급자 및 계획 이름을 이미 알고 있는 경우 아래의 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사용하여 구독의 전체 양자 작업 영역 목록을 볼 수 있습니다.

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

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

비고

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

az quantum workspace delete

다음 단계

이제 작업 영역을 만들고 삭제할 수 있으므로 Azure Quantum targets 대해 알아봅니다.