Zarządzanie obszarami roboczymi kwantowymi przy użyciu interfejsu wiersza polecenia platformy Azure

W tym przewodniku 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 zarejestruj się w celu uzyskania subskrypcji z płatnością zgodnie z rzeczywistym użyciem.
• Grupa zasobów platformy Azure, w której znajduje się kwantowy obszar roboczy.
• Konto magazynu w grupie zasobów, które ma być skojarzone z obszarem roboczym kwantowym. Wiele obszarów roboczych może być skojarzonych z tym samym kontem.
• Interfejs wiersza polecenia platformy Azure.
• Quantum Development KitMicrosoft .

Konfigurowanie środowiska

1. Zainstaluj rozszerzenie interfejsu wiersza polecenia quantum platformy Azure. Otwórz wiersz polecenia i uruchom następujące polecenie, które również uaktualnia rozszerzenie, 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 jest to pierwszy raz podczas tworzenia obszarów roboczych kwantowych w subskrypcji, zarejestruj dostawcę zasobów za pomocą następującego 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 świadczenia usługi Azure, w którym będzie mieszkał zasób. Możesz użyć listy regionów i kodów menedżera zasobów obsługiwanych przez narzędzie interfejsu wiersza polecenia platformy Azure, na przykład westus.
• Grupa zasobów skojarzona z nowym obszarem roboczym, na przykład MyResourceGroup.
• Konto magazynu w tej samej grupie zasobów i subskrypcji co obszar roboczy kwantowy. Istnieje możliwość utworzenia nowego konta magazynu z poziomu narzędzia interfejsu wiersza polecenia Az, 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 warunkami, kosztami i limitami przydziału. Aby utworzyć obszary robocze, należy określić odpowiedni plan wraz z dostawcami, chyba że chcesz zacząć od dostawców oferujących bezpłatne środki — są one automatycznie dodawane do obszaru roboczego.

Jeśli znasz już dostawcę i nazwy planów do użycia w obszarze roboczym, możesz przejść do kroku czwartego poniżej. Jeśli chcesz zacząć od dostawców oferujących 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 -r parametr 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 list polecenia (w tym przykładzie użyto westus jako lokalizacji):

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

   Porada

   Jeśli chcesz zobaczyć, którzy dostawcy dają bezpłatne ś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 zaplanowaniu uwzględnienia w obszarze roboczym możesz przejrzeć terminy przy użyciu show-terms polecenia (dodając identyfikator MyProviderID i MyPlan jako przykładowe wartości):

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

3. Dane wyjściowe show-terms polecenia zawierają pole accepted logiczne, które pokazuje, czy warunki dla tego dostawcy zostały już zaakceptowane, czy nie, a także link do postanowień licencyjnych do przejrzenia. Jeśli zdecydujesz się zaakceptować te warunki, użyj accept-terms polecenia , 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żesz utworzyć obszar roboczy przy użyciu create polecenia , określając listę kombinacji dostawcy i planu 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 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ć create polecenia , 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"

Ważne

Ta procedura faktycznie ponownie tworzy obszar roboczy przy użyciu nowego konta magazynu. Upewnij się, że wszystkie właściwości inne niż konto magazynu są dokładnie takie same jak w przypadku oryginalnego, w przeciwnym razie zostanie utworzony drugi obszar roboczy.

Usuwanie obszaru roboczego kwantowego

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

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

Porada

Jeśli nie pamiętasz dokładnej nazwy, możesz wyświetlić całą listę obszarów roboczych kwantowych w subskrypcji przy użyciu polecenia az quantum workspace list -o table.

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

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

Uwaga

Jeśli wcześniej użyto az quantum workspace set polecenia do określenia domyślnego obszaru roboczego kwantowego, możesz wywołać delete polecenie bez parametrów, aby usunąć (i wyczyścić) domyślny obszar roboczy.

az quantum workspace delete

Następne kroki

Teraz, gdy możesz tworzyć i usuwać obszary robocze, zapoznaj się z różnymi targets algorytmami kwantowymi w usłudze Azure Quantum.