Zarządzanie obszarami roboczymi kwantowymi za pomocą interfejsu wiersza polecenia platformy Azure

Z tego przewodnika dowiesz się, jak używać interfejsu azure Command-Line (interfejsu wiersza polecenia platformy Azure) do tworzenia obszarów roboczych usługi Azure Quantum oraz wymaganych grup zasobów i kont magazynu oraz rozpoczynać uruchamianie aplikacji kwantowych w usłudze Azure Quantum.

Wymagania wstępne

Aby korzystać z usługi Azure Quantum, potrzebne są następujące elementy:

• Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz konta platformy Azure, zarejestruj się bezpłatnie i wybierz subskrypcję typu "płać za użycie".
• Grupa zasobów platformy Azure, w której znajduje się obszar roboczy kwantowy.
• Konto przechowywania w grupie zasobów, które ma być powiązane z obszarem roboczym kwantowym. Z tym samym kontem można skojarzyć wiele obszarów roboczych.
• Azure CLI.
• Microsoft Quantum Development Kit.

Konfiguracja środowiska

1. Zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure quantum. Otwórz wiersz polecenia i uruchom następujące polecenie, co spowoduje również uaktualnienie rozszerzenia, jeśli poprzednia wersja jest już zainstalowana:

   az extension add --upgrade -n quantum
   

2. Zaloguj się do platformy Azure przy użyciu poświadczeń. Zostanie wyświetlona lista subskrypcji skojarzonych z twoim kontem.

   az login
   

3. Określ subskrypcję, której chcesz użyć.

   az account set -s <Your subscription ID>
   

4. Jeśli po raz pierwszy tworzysz obszary robocze kwantowe w ramach swojej subskrypcji, zarejestruj dostawcę zasobów za pomocą tego polecenia:

   az provider register --namespace Microsoft.Quantum
   

Tworzenie obszaru roboczego usługi Azure Quantum

Aby utworzyć nowy obszar roboczy usługi Azure Quantum, musisz wiedzieć:

• Nazwa lokalizacji lub regionu platformy Azure do utworzenia zasobu. Możesz użyć listy regionów i ich kodów menedżera zasobów obsługiwanych przez Azure CLI, na przykład westus.
• Grupa zasobów skojarzona z nowym obszarem roboczym, na przykład MyResourceGroup.
• Konto magazynowe w tej samej grupie zasobów i subskrypcji co obszar roboczy kwantowy. Istnieje możliwość utworzenia nowego konta usługi przechowywania za pomocą narzędzia Az CLI, na przykład MyStorageAccount.
• Nazwa obszaru roboczego kwantowego do utworzenia, na przykład MyQuantumWorkspace.
• Lista dostawców usługi Azure Quantum do użycia w obszarze roboczym. Dostawca oferuje zestaw planów, z których każdy reprezentuje plan ze skojarzonymi warunkami i postanowieniami, kosztami i limitami przydziału. Aby utworzyć obszary robocze, należy określić odpowiedni plan wraz z dostawcami.

Jeśli znasz już dostawcę i nazwy planów, które mają być używane w obszarze roboczym, możesz przejść poniżej do kroku czwartego. Jeśli chcesz zacząć od dostawców, którzy oferują bezpłatne środki, możesz wprowadzić następujące polecenie:

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

Może zostać wyświetlony monit o zaakceptowanie warunków użytkowania. Wprowadź Y, aby zaakceptować warunki. Należy pamiętać, że parametr -r pokazany w kroku czwartym poniżej nie był wymagany.

Jeśli musisz określić, którzy dostawcy i plany mają być używane, wykonaj następujące czynności:

1. Aby pobrać listę dostępnych dostawców kwantowych, użyj polecenia list (w tym przykładzie użyto westus jako lokalizacji):

   az quantum offerings list \
        -l westus \
        -o table
   

   Wskazówka

   Jeśli chcesz zobaczyć, którzy dostawcy przyznają darmowe środki, użyj parametru --autoadd-only, na przykład:
   az quantum offerings list --autoadd-only -l westus -o table
   Jak wspomniano wcześniej, ci dostawcy są automatycznie dodawani do obszaru roboczego. Nie trzeba ich określać za pomocą parametru -r.

2. Po określeniu dostawcy i planu, który chcesz włączyć do swojego obszaru roboczego, możesz przejrzeć warunki przy użyciu polecenia show-terms (dodając MyProviderID i MyPlan jako przykładowe wartości):

   az quantum offerings show-terms \
        -l westus \
        -p MyProviderId \
        -k MyPlan
   

3. Dane wyjściowe polecenia show-terms zawierają pole logiczne accepted, które pokazuje, czy warunki dla tego dostawcy zostały już zaakceptowane, czy nie, a także link do postanowień licencyjnych do przeglądu. Jeśli zdecydujesz się zaakceptować te warunki, użyj polecenia accept-terms, aby zarejestrować akceptację.

   az quantum offerings accept-terms \
        -l westus \
        -p MyProviderId \
        -k MyPlan
   

4. Po przejrzeniu i zaakceptowaniu wszystkich wymaganych warunków i postanowień można utworzyć obszar roboczy przy użyciu polecenia create, określając listę kombinacji dostawców i planów rozdzielonych przecinkami, jak w poniższym przykładzie:

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

Po utworzeniu obszaru roboczego można nadal dodawać lub usuwać dostawców przy użyciu witryny Azure Portal.

Zmienianie domyślnego konta magazynu dla obszaru roboczego kwantowego

Jeśli musisz zmienić domyślne konto magazynu dla istniejącego obszaru roboczego, możesz użyć polecenia create, określając wszystkie bieżące właściwości wraz z nowym kontem magazynu. W poniższym przykładzie użyto tych samych ustawień co obszar roboczy utworzony w poprzednim przykładzie:

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

Usuwanie obszaru roboczego kwantowego

Jeśli znasz nazwę i grupę zasobów obszaru roboczego kwantowego, który chcesz usunąć, możesz to zrobić za pomocą polecenia delete (przy użyciu tych samych nazw co w poprzednim przykładzie):

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

Po usunięciu obszaru roboczego jest on nadal wyświetlany, gdy jest on usuwany w chmurze. Jednak właściwość provisioningState dla obszaru roboczego zmienia się natychmiast, aby wskazać, że jest usuwana. Te informacje można wyświetlić za pomocą polecenia show:

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

az quantum workspace delete

Następne kroki

Teraz, gdy możesz tworzyć i usuwać obszary robocze, dowiedz się więcej o różnych metodach targets uruchamiania algorytmów kwantowych w usłudze Azure Quantum.