Azure CLI ile kuantum çalışma alanlarını yönetme

Makale
10/26/2023

Bu kılavuzda, Azure Quantum çalışma alanlarını ve gerekli kaynak gruplarını ve depolama hesaplarını oluşturmak için Azure Command-Line Arabirimi'ni (Azure CLI) kullanmayı ve kuantum uygulamalarınızı Azure Quantum'da çalıştırmaya başlamayı öğrenin.

Önkoşullar

Azure Quantum hizmetini kullanmak için şunları yapmanız gerekir:

Etkin aboneliği olan bir Azure hesabı. Azure hesabınız yoksa ücretsiz kaydolun ve kullandıkça öde aboneliğine kaydolun.
Kuantum çalışma alanının bulunduğu bir Azure kaynak grubu.
Kuantum çalışma alanıyla ilişkilendirilecek kaynak grubundaki bir depolama hesabı. Aynı hesapla birden çok çalışma alanı ilişkilendirilebilir.
Azure CLI.
Microsoft Quantum Development Kit.

Ortamı ayarlama

Azure CLI quantum uzantısını yükleyin. Bir komut istemi açın ve önceki bir sürüm zaten yüklüyse uzantıyı yükselten aşağıdaki komutu çalıştırın:
```
az extension add --upgrade -n quantum
```
Kimlik bilgilerinizi kullanarak Azure'da oturum açın. Hesabınızla ilişkili aboneliklerin listesini görürsünüz.
```
az login
```
Kullanmak istediğiniz aboneliği belirtin.
```
az account set -s <Your subscription ID>
```
Aboneliğinizde ilk kez kuantum çalışma alanları oluşturuyorsanız kaynak sağlayıcısını şu komutla kaydedin:
```
az provider register --namespace Microsoft.Quantum
```

Azure Quantum çalışma alanı oluşturma

Yeni bir Azure Quantum çalışma alanı oluşturmak için şunları bilmeniz gerekir:

Kaynağın yaşayacağı konum veya Azure bölgesi adı. Bölgelerin listesini ve Azure CLI aracı tarafından desteklenen kaynak yöneticisi kodlarını (örneğin, westus) kullanabilirsiniz.
Yeni çalışma alanıyla ilişkilendirilmiş kaynak grubu, örneğin , MyResourceGroup.
Kuantum çalışma alanıyla aynı kaynak grubunda ve abonelikte yer alan bir depolama hesabı. Az CLI aracından yeni bir depolama hesabı oluşturmak mümkündür; örneğin, MyStorageAccount.
Oluşturulacak kuantum çalışma alanının adı, örneğin MyQuantumWorkspace.
Çalışma alanında kullanılacak Azure Quantum sağlayıcılarının listesi. Sağlayıcı, her biri ilişkili hüküm ve koşullara, maliyetlere ve kotalara sahip bir planı temsil eden bir plan kümesi sunar. Çalışma alanları oluşturmak için, ücretsiz kredi sunan sağlayıcılardan başlamak istemediğiniz sürece ilgili planı sağlayıcılarla birlikte belirtmeniz gerekir; bunlar otomatik olarak çalışma alanınıza eklenir.

Çalışma alanınızda kullanılacak sağlayıcıyı ve plan adlarını zaten biliyorsanız aşağıdaki dördüncü adıma atlayabilirsiniz. Ücretsiz kredi sunan sağlayıcılardan başlamak istiyorsanız aşağıdaki komutu girebilirsiniz:

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

Kullanım koşullarını kabul etmek isteyip istemediğiniz sorulabilir. Koşulları kabul etmek için girin Y . Aşağıdaki dördüncü adımda gösterilen parametrenin -r gerekli olmadığını unutmayın.

Hangi sağlayıcıları ve planları kullanacağınızı belirlemeniz gerekiyorsa, aşağıdaki gibi devam edin:

Kullanılabilir kuantum sağlayıcılarının listesini almak için komutunu kullanın list (bu örnekte konum olarak westus kullanılır):
```
az quantum offerings list \
     -l westus \
     -o table
```
İpucu

Hangi sağlayıcıların ücretsiz kredi vereceğini görmek istiyorsanız parametresini --autoadd-only kullanın, örneğin:
az quantum offerings list --autoadd-only -l westus -o table
Daha önce belirtildiği gibi, bu sağlayıcılar çalışma alanınıza otomatik olarak eklenir. Bunları parametresiyle -r belirtmeniz gerekmez.
Sağlayıcıyı belirledikten ve çalışma alanınıza eklemeyi planladıktan sonra komutunu kullanarak show-terms terimleri gözden geçirebilirsiniz (örnek değerler olarak MyProviderID ve MyPlan'ınızı ekleyin):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Komutun show-terms çıktısı, bu sağlayıcının koşullarının zaten kabul edilip edilmediğini gösteren bir Boole alanı accepted ve gözden geçirilme lisans koşullarının bağlantısını içerir. Bu koşulları kabul etmeye karar verirseniz, kabulünüzü kaydetmek için komutunu kullanın accept-terms .
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Gerekli tüm hüküm ve koşulları gözden geçirip kabul ettikten sonra, aşağıdaki örnekte olduğu gibi, komutunu kullanarak create , virgülle ayrılmış sağlayıcı ve plan birleşimlerinin listesini belirterek çalışma alanınızı oluşturabilirsiniz:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Çalışma alanı oluşturduktan sonra da Azure portal kullanarak sağlayıcı ekleyebilir veya kaldırabilirsiniz.

Kuantum çalışma alanının varsayılan depolama hesabını değiştirme

Mevcut bir çalışma alanının varsayılan depolama hesabını değiştirmeniz gerekiyorsa, yeni depolama hesabıyla birlikte tüm geçerli özellikleri belirterek komutunu kullanabilirsiniz create . Aşağıdaki örnek, önceki örnekte oluşturulan çalışma alanıyla aynı ayarları kullanır:

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

Önemli

Bu yordam aslında yeni depolama hesabıyla çalışma alanını yeniden oluşturur. Depolama hesabı dışındaki tüm özelliklerin özgün ile tam olarak aynı olduğundan emin olun, aksi takdirde ikinci bir çalışma alanı oluşturulur.

Kuantum çalışma alanını silme

Silmek istediğiniz kuantum çalışma alanının adını ve kaynak grubunu biliyorsanız, bunu komutuyla (önceki örnekle delete aynı adları kullanarak) yapabilirsiniz:

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

İpucu

Tam adı anımsamıyorsanız, kullanarak az quantum workspace list -o tableaboneliğinizdeki kuantum çalışma alanlarının listesinin tamamını görüntüleyebilirsiniz.

Bir çalışma alanını sildikten sonra, bulutta silinirken de listelenir. Ancak, provisioningState çalışma alanının özelliği silindiğini belirtmek için hemen değişir. Şu komutu kullanarak show bu bilgileri görebilirsiniz:

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

Not

Önceden varsayılan kuantum çalışma alanını belirtmek için komutunu kullandıysanız az quantum workspace set , varsayılan çalışma alanını silmek (ve temizlemek) için parametresiz komutunu çağırabilirsiniz delete .

az quantum workspace delete

Sonraki adımlar

Artık çalışma alanları oluşturup silebileceğinize göre, Azure Quantum'da kuantum algoritmalarını çalıştırmaya yönelik farklıtargets özellikler hakkında bilgi edinin.

Share via