Mengelola ruang kerja kuantum dengan Azure CLI

Artikel
10/26/2023

Dalam panduan ini, pelajari cara menggunakan Antarmuka Baris Perintah Azure (Azure CLI) untuk membuat ruang kerja Azure Quantum dan grup sumber daya dan akun penyimpanan yang diperlukan, dan mulai menjalankan aplikasi kuantum di Azure Quantum.

Prasyarat

Untuk menggunakan layanan Azure Quantum, Anda memerlukan:

Akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun Azure, daftar secara gratis dan daftar untuk langganan prabayar.
Grup sumber daya Azure tempat ruang kerja kuantum berada.
Akun penyimpanan dalam grup sumber daya yang akan dikaitkan dengan ruang kerja kuantum. Beberapa ruang kerja dapat dikaitkan dengan akun yang sama.
Azure CLI.
Microsoft Quantum Development Kit.

Penyiapan lingkungan

Instal ekstensi quantum Azure CLI. Buka perintah dan jalankan perintah berikut, yang juga meningkatkan ekstensi jika versi sebelumnya sudah diinstal:
```
az extension add --upgrade -n quantum
```
Masuk ke Azure menggunakan informasi masuk Anda. Anda melihat daftar langganan yang terkait dengan akun Anda.
```
az login
```

Pilih langganan yang ingin Anda gunakan.

az account set -s <Your subscription ID>

Jika ini adalah pertama kalinya membuat ruang kerja kuantum di langganan Anda, daftarkan penyedia sumber daya dengan perintah ini:
```
az provider register --namespace Microsoft.Quantum
```

Buat ruang kerja Azure Quantum

Untuk membuat ruang kerja Azure Quantum baru, Anda perlu mengetahui:

Lokasi atau nama wilayah Azure tempat sumber daya akan live. Anda dapat menggunakan daftar wilayah dan kode pengelola sumber dayanya yang didukung oleh alat Azure CLI, misalnya westus.
Grup sumber daya yang terkait dengan ruang kerja baru, misalnya MyResourceGroup.
Akun penyimpanan dalam grup sumber daya dan langganan yang sama dengan ruang kerja kuantum. Dimungkinkan untuk membuat akun penyimpanan baru dari alat Az CLI, misalnya, MyStorageAccount.
Nama ruang kerja kuantum untuk membuat, misalnya, MyQuantumWorkspace.
Daftar penyedia Azure Quantum yang akan digunakan di ruang kerja. Penyedia menawarkan serangkaian rencana, masing-masing mewakili rencana dengan syarat dan ketentuan, biaya, dan kuota terkait. Untuk membuat ruang kerja, Anda perlu menentukan paket yang sesuai bersama dengan penyedia, kecuali Jika Anda ingin memulai dengan penyedia yang menawarkan kredit gratis - paket tersebut secara otomatis ditambahkan ke ruang kerja Anda.

Jika Anda sudah mengetahui penyedia dan nama paket yang akan digunakan di ruang kerja, Anda dapat melompat ke langkah empat, di bawah ini. Jika Anda ingin memulai dengan penyedia yang menawarkan kredit gratis, Anda dapat memasukkan perintah berikut:

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

Anda mungkin diminta untuk menerima ketentuan penggunaan. Masukkan Y untuk menerima persyaratan. Perhatikan bahwa parameter yang -r ditunjukkan pada langkah empat, di bawah ini, tidak diperlukan.

Jika Anda perlu menentukan penyedia dan rencana mana yang akan digunakan, lanjutkan sebagai berikut:

Untuk mengambil daftar penyedia kuantum yang tersedia, gunakan perintah list (contoh ini menggunakan westus sebagai lokasi):
```
az quantum offerings list \
     -l westus \
     -o table
```
Tip

Jika ingin melihat penyedia mana yang memberikan kredit gratis, gunakan --autoadd-only parameter , misalnya:
az quantum offerings list --autoadd-only -l westus -o table
Seperti disebutkan sebelumnya, penyedia tersebut secara otomatis ditambahkan ke ruang kerja Anda. Anda tidak perlu menentukannya dengan -r parameter .
Setelah menentukan penyedia dan rencana untuk disertakan di ruang kerja, Anda dapat meninjau ketentuan menggunakan perintah show-terms (menambahkan Nilai MyProviderID dan MyPlan sebagai nilai contoh):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Output dari perintah show-terms termasuk bidang Boolean accepted yang menunjukkan jika persyaratan untuk penyedia ini telah diterima atau belum, serta link ke persyaratan lisensi untuk ditinjau. Jika Anda memutuskan untuk menerima persyaratan tersebut accept-terms, gunakan perintah untuk mencatat penerimaan.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Setelah meninjau dan menerima semua syarat dan ketentuan yang diperlukan, Anda dapat membuat ruang kerja menggunakan perintah create, menentukan daftar kombinasi penyedia dan paket yang dipisahkan oleh koma, seperti dalam contoh berikut:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Setelah membuat ruang kerja, Anda masih dapat menambahkan atau menghapus penyedia menggunakan portal Azure.

Mengubah akun penyimpanan default untuk ruang kerja kuantum

Jika Anda perlu mengubah akun penyimpanan default untuk ruang kerja yang sudah ada, Anda dapat menggunakan create perintah , menentukan semua properti saat ini bersama dengan akun penyimpanan baru. Contoh berikut menggunakan pengaturan yang sama dengan ruang kerja yang dibuat dalam contoh sebelumnya:

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

Penting

Prosedur ini benar-benar membuat ulang ruang kerja dengan akun penyimpanan baru. Pastikan bahwa semua properti selain akun penyimpanan sama persis dengan aslinya, jika tidak, ruang kerja kedua dibuat.

Menghapus ruang kerja kuantum

Jika Anda mengetahui nama dan grup sumber daya ruang kerja kuantum yang ingin Anda hapus, Anda dapat melakukannya dengan delete perintah (menggunakan nama yang sama dengan contoh sebelumnya):

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

Tip

Jika Anda tidak ingat nama tepatnya, Anda dapat melihat seluruh daftar ruang kerja kuantum dalam langganan menggunakan az quantum workspace list -o table.

Setelah Anda menghapus ruang kerja, ruang kerja masih tercantum saat dihapus di cloud. Namun, properti provisioningState ruang kerja segera berubah untuk menunjukkan bahwa ruang tersebut sedang dihapus. Anda dapat melihat informasi ini dengan menggunakan perintah show:

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

Catatan

Jika Anda menggunakan perintah az quantum workspace set sebelumnya untuk menentukan ruang kerja kuantum default, maka Anda dapat memanggil perintah delete tanpa parameter untuk menghapus (dan menghapus seluruhnya) ruang kerja default.

az quantum workspace delete

Langkah berikutnya

Sekarang setelah Anda dapat membuat dan menghapus ruang kerja, pelajari tentang berbagai targets hal untuk menjalankan algoritma kuantum di Azure Quantum.

Bagikan melalui