Tworzenie instancji i zarządzanie nimi

Dostęp do usług IBM Quantum® Platform jest kontrolowany przez instancje, do których masz przypisany dostęp. Użytkownicy mogą należeć do wielu instancji.

Instancje to wirtualne serwery (wdrożenia IBM Quantum Compute Service), które zarządzają wykonywaniem Twoich obciążeń, w tym uruchamianiem programów kwantowych i klasycznych zadań obliczeniowych (takich jak przetwarzanie mitigacji błędów). Instancje są identyfikowane przez swoją nazwę zasobu w chmurze (CRN). Tego CRN można używać podczas wysyłania obciążeń z programów Qiskit.

Instancje, do których masz dostęp, możesz zobaczyć na pulpicie nawigacyjnym lub klikając kartę „Instancje" w pulpicie nawigacyjnym. Każda instancja jest wymieniona wraz ze swoim identyfikatorem CRN.

Potrzebujesz osobnej instancji dla każdego planu usługi (np. Open lub Pay-As-You-Go), którego używasz w każdym regionie, w którym chcesz działać. Menedżer konta oraz każda osoba z odpowiednimi uprawnieniami może tworzyć instancję i definiować jej konfigurację, taką jak alokacje, limity użycia, komputery kwantowe i uprawnienia użytkowników.

Pulpit nawigacyjny IBM Quantum Platform wyświetla instancje, do których masz dostęp. W zależności od Twoich uprawnień możesz wyświetlać pełne szczegóły, edytować i usuwać instancje na stronie Instancje.

Ważne jest, abyś wiedział, której instancji używasz, ponieważ wszystkie instancje, które nie są powiązane z planem Open, generują koszty (lub wliczają się do przydzielonego czasu planu).

uwaga

Zadania uruchamiane przez Ciebie oraz przez innych współpracowników w tej samej instancji są wliczane do raportowanego użycia tej instancji.

Użycie instancji możesz wyświetlić na stronie Instancje lub – dla osób z odpowiednimi uprawnieniami – na stronie Analityka. Zwróć uwagę, że strony mogą pokazywać różne wartości użycia, ponieważ strona Instancje wyświetla łączne użycie przed bieżącym znacznikiem czasu, podczas gdy strona Analityka używa pełnych granic dziennych.

Instancja planu Open

Użytkownicy planu Open Plan mogą bezpłatnie uruchamiać obwody kwantowe na najlepszych na świecie QPU (odpowiednik 10 minut użycia jednostki przetwarzania kwantowego (QPU) w jednostkach zasobów (RU) w toczącym się oknie 28-dniowym). Użycie można śledzić na pulpicie nawigacyjnym platformy oraz na stronie Obciążenia.

Instancja planu Pay-As-You-Go

Plan Pay-As-You-Go jest planem płatnym. Aby korzystać z tego planu, musisz utworzyć instancję i przypisać ją do tego planu. Wszystkie obciążenia wysyłane do QPU przy użyciu tego planu podlegają opłacie. Instancje Pay-As-You-Go mogą mieć całkowity limit kosztów (opcjonalny).

Instancja planu Flex

Plan Flex jest planem płatnym. Aby korzystać z tego planu, musisz najpierw skontaktować się z IBM, aby się zarejestrować. Następnie utwórz instancję i przypisz ją do tego planu. Wszystkie obciążenia wysyłane do QPU przy użyciu tego planu są wliczane do przydzielonej subskrypcji.

Administrator może ustawić limit użycia na instancji planu Flex, który obowiązuje przez cały okres trwania umowy. Jeśli instancja została oznaczona jako „ograniczona" przez administratora (w obszarze użycia zobaczysz kolumnę „Pozostało") i instancja przekroczy swój przydział (zdefiniowany przez administratora), wszelkie aktywne obciążenia będą nadal działać (w tym Session), ale oczekujące obciążenia pozostaną w kolejce do czasu, gdy dostępny będzie dodatkowy czas. Jeśli instancja nie jest ograniczona i przekroczy swój przydział, zadania uruchamiane przy jej użyciu prawdopodobnie będą wykonywane z niższym priorytetem i dłuższymi czasami kolejki.

Po przekroczeniu przydziału instancji w obszarze jej użycia wyświetlany jest alert.

Instancja planu Premium

Plan Premium jest planem płatnym. Aby korzystać z tego planu, musisz najpierw skontaktować się z IBM, aby się zarejestrować. Następnie utwórz instancję i przypisz ją do tego planu. Wszystkie obciążenia wysyłane do QPU przy użyciu tego planu są wliczane do przydzielonej subskrypcji.

Administrator może ustawić limit użycia na instancji planu Premium, który obowiązuje w 28-dniowym toczącym się oknie użycia planu. Jeśli instancja została oznaczona jako „ograniczona” przez administratora, w obszarze użycia zobaczysz kolumnę „Pozostało”. Jeśli Twoja instancja została oznaczona jako „ograniczona” i przekracza limit ustawiony przez administratora, wszelkie oczekujące obciążenia pozostaną w kolejce do czasu, gdy dostępny będzie dodatkowy czas; jednak wszelkie aktywne obciążenia będą nadal działać, w tym obciążenia w session mode.

Jeśli instancja nie jest ograniczona i przekracza swój przydział, obciążenia uruchamiane w tej instancji prawdopodobnie będą wykonywane z niższym priorytetem i dłużej czekać w kolejce.

Po przekroczeniu przydziału instancji w obszarze jej użycia wyświetlany jest alert.

Określanie instancji w kodzie

Możesz użyć CRN lub nazwy instancji, aby wskazać instancję do użycia – zarówno podczas inicjalizacji usługi, jak i podczas wysyłania obciążenia do QPU (na przykład za pomocą `QiskitRuntimeService.backend()). Instrukcje dotyczące określania instancji w kodzie znajdziesz w artykule Inicjalizacja konta.

Gdy instancja zostanie przekazana, dostępne są wyłącznie Backend i zadania z tej instancji (obsługiwane w qiskit-ibm-runtime v0.40.1 i nowszych).

Jeśli instancja nie jest uwzględniona podczas inicjalizacji usługi, dostępne są wszystkie Backend i zadania ze wszystkich instancji na Twoim koncie. W takim przypadku, gdy zostanie wskazany Backend, odpowiednia instancja mająca dostęp do tego Backend jest wyszukiwana i używana zgodnie z opisem w artykule Automatyczne wybieranie instancji.

Wymagane wersje

Qiskit Runtime v0.40.1 lub nowszy jest wymagany do:

• Używania nazwy instancji do jej określenia

• Nieudostępniania instancji

• Ustawiania preferowanego typu instancji i regionu

Dla Qiskit Runtime v0.42 lub nowszego, plany bezpłatne są domyślnie traktowane priorytetowo podczas korzystania z automatycznego wyboru instancji.

Tworzenie instancji

Wykonaj poniższe kroki, aby utworzyć instancję i dodać ją do swojego konta. Jeśli jesteś administratorem, który musi skonfigurować Quantum Compute w chmurze dla swojej organizacji, zapoznaj się z artykułem Planowanie Quantum Compute dla organizacji.

1. Aby dodać instancję do swojego konta, najpierw upewnij się, że w przełączniku konta w nagłówku wybrano właściwe konto i region.

   • Możesz mieć (lub należeć do) wiele kont IBM Cloud. Jeśli nie widzisz oczekiwanych instancji lub zadań, spróbuj wybrać inne konto.

   • Możesz uzyskać dostęp do obu regionów przy użyciu tego samego klucza API, ale możesz widzieć i uzyskiwać dostęp tylko do instancji utworzonych w regionie, do którego jesteś zalogowany.

   • Jeśli chcesz utworzyć instancję Open, musisz wybrać region us-east.

   

   O regionach

   Instancja zostanie utworzona w wybranym regionie. Ten region determinuje następujące ważne cechy:

   • Które QPU są dostępne.
   • Gdzie odbywa się klasyczne obliczanie zadań, takie jak kompilacja.
   • Gdzie pozostają dane przepływu pracy użytkownika.

   Dane przepływu pracy obejmują Circuit wejściowe, parametry Circuit i wyniki obliczeń kwantowych. Nie obejmują metadanych, takich jak liczba powtórzeń, rozmiar Circuit ani inne statystyki zadań.

   Aby uniknąć narażenia danych przepływu pracy użytkownika na globalną warstwę ochrony przed rozproszonymi atakami odmowy usługi, możesz korzystać z Prywatnych punktów końcowych. qiskit-ibm-runtime obsługuje to za pomocą parametru private_endpoint.

2. W panelu Instancje na pulpicie nawigacyjnym kliknij Wyświetl wszystko lub przejdź do strony Instancje z menu głównego.

3. Na stronie Instancje kliknij Utwórz instancję.

   • Wprowadź nazwę i opcjonalnie dodaj tagi.

   • Jeśli masz dostęp do więcej niż jednej grupy zasobów w IBM Cloud®, możesz zmienić grupę zasobów, do której należy ta instancja. Więcej informacji znajdziesz w artykułach Zarządzanie grupami zasobów i Przyznawanie dostępu do zasobów w grupach zasobów.

4. Wybierz plan cenowy powiązany z tą instancją (np. Pay-As-You-Go). W zależności od wybranego planu cenowego możesz określić inne opcje, takie jak limit kosztów lub liczba RU przydzielonych tej instancji. Pamiętaj, że jeśli ta instancja nie jest powiązana z planem bezpłatnym, korzystanie z niej do uruchamiania obciążeń będzie generować koszty.

5. Kliknij Dalej. Zostanie wyświetlona lista QPU, do których instancja ma dostęp.

   • Jeśli chcesz, aby instancja miała dostęp do wszystkich wymienionych QPU (i wszystkich QPU dodanych do tego planu w przyszłości), kliknij Dalej.

   • Jeśli nie konfigurujesz instancji Open, możesz dostosować, do których QPU można uzyskać dostęp za pomocą tej instancji. Kliknij przełącznik „Dostosuj przydzielone zasoby obliczeniowe". Wybierz konkretne QPU, do których ta instancja ma mieć dostęp, a następnie kliknij Dalej.

     uwaga

     Jeśli dostosujesz przydzielone zasoby obliczeniowe, dostępne QPU nigdy nie będą automatycznie aktualizowane, niezależnie od jakichkolwiek zmian wprowadzonych w planie nadrzędnym. Możesz jednak ręcznie dodawać lub usuwać QPU później. Jeśli ich nie dostosujesz, będziesz zawsze mieć dostęp do każdego QPU, do którego konto ma dostęp w ramach planu. Zatem jeśli w przyszłości do planu zostanie dodany nowy QPU, instancja automatycznie uzyska do niego dostęp.

     Urządzenia mock są domyślnie ukryte na tej liście. Włącz przełącznik, aby je wyświetlić, a następnie wybierz urządzenia mock, które chcesz uwzględnić. Możesz ograniczyć instancję wyłącznie do urządzeń mock, wybierając tylko je. Jest to przydatne dla studentów lub uczestników kursów, którzy mogą wtedy zweryfikować swoje zadania od początku do końca bez zużywania rzeczywistego czasu QPU ani RU. Ponieważ instancja ma dostęp tylko do urządzeń mock, użytkownicy wybierają backend według jego nazwy mock, na przykład service.backend("mock_phoenix"). Więcej informacji znajdziesz w Dry-run jobs.

6. Otwiera się panel Grupy dostępu. Dla tej instancji automatycznie tworzona jest grupa dostępu „współpracownicy". Użytkownicy dodani do tej grupy dostępu mogą korzystać z czasu przydzielonego tej instancji. Możesz modyfikować lub tworzyć dodatkowe grupy dostępu za pomocą konsoli IBM Cloud. Instrukcje znajdziesz w artykule Konfigurowanie grup dostępu.

7. Kliknij Utwórz instancję. Możesz teraz zobaczyć instancję na stronie Instancje. Jeśli masz skonfigurowane wiele planów na swoim koncie, każdy typ planu ma własną kartę w tabeli Instancje.

Oczekujące obciążenia

Kolumna Oczekujące obciążenia w tabeli Instancje pokazuje liczbę obciążeń aktualnie oczekujących w kolejce w tej instancji na wszystkich QPU.

Edytowanie instancji i jej alokacji

Znajdź instancję na stronie Instancje. Kliknij menu przepełnienia na końcu wiersza instancji i wybierz Edytuj szczegóły.

uwaga

Tylko administratorzy i właściciele mogą edytować instancję. Informacje na temat przypisywania dostępu znajdziesz w przewodniku Tworzenie polityk dostępu i grup dostępu.

Skonfiguruj dostęp do Qiskit Functions w instancji

uwaga

Karta Functions i jej opcje pojawiają się tylko wtedy, gdy Twoje konto zostało skonfigurowane z dostępem do Qiskit Functions. Jeśli Twoje konto ma dostęp do Qiskit Functions, ale nie widzisz opcji edycji dostępu do funkcji dla poszczególnych instancji, oznacza to, że Twoje konto nie zostało jeszcze zmigrowane do tej metody. Skontaktuj się ze swoim opiekunem klienta lub zespołem wsparcia, aby przeprowadzić migrację.

Możesz skonfigurować, do których Qiskit Functions ma dostęp instancja, korzystając z Resource Controller API (zobacz Konfiguracja dostępu do Qiskit Functions w instancji) lub wykonując poniższe kroki w IBM Quantum Platform.

1. Przejdź do strony Instancje.

2. Upewnij się, że w przełączniku konta w nagłówku wybrano właściwe konto.

3. Znajdź instancję, w której chcesz włączyć dostęp do funkcji.

4. Kliknij menu przepełnienia na końcu wiersza instancji, a następnie wybierz Edytuj szczegóły.

5. Kliknij kartę Functions.

6. Włącz dostęp do funkcji i wybierz funkcję, którą chcesz włączyć.

7. Przeczytaj umowy i potwierdź, że zostały przez Ciebie przeczytane.

8. Kliknij Zapisz, aby zapisać zmiany.

Pamiętaj, że jeśli Twoje konto ma dostęp do Qiskit Functions, możesz też skonfigurować dostęp podczas dodawania nowej instancji. Kliknij Utwórz instancję i wykonaj kroki w otwartym oknie. W kroku Functions możesz włączyć dostęp do funkcji z katalogu i funkcji niestandardowych oraz określić, do których Qiskit Functions instancja ma mieć dostęp.

Uprawnienia domyślne i niestandardowe

Domyślne uprawnienia na poziomie użytkownika obowiązują, gdy konfigurujesz dostęp do Qiskit Functions dla instancji w IBM Quantum Platform. Użytkownicy z uprawnieniami domyślnymi mogą wykonywać następujące czynności:

• Wyświetlać funkcję i jej szczegóły

• Przesyłać zadania przy użyciu funkcji

• Wyświetlać listę i pobierać pliki przechowywane w przestrzeni roboczej użytkownika

• Przesyłać, aktualizować i usuwać pliki wejściowe i wynikowe w przestrzeni roboczej użytkownika

Aby przypisać uprawnienia niestandardowe, użyj zamiast tego Resource Controller API. Więcej informacji zawiera Konfiguracja dostępu do Qiskit Functions w instancji. Aby znaleźć dokumentację API, kliknij ikonę informacji obok uprawnień funkcji na karcie Functions, a następnie kliknij link View the API reference w podpowiedzi.

Aby przywrócić uprawnienia domyślne dla instancji z uprawnieniami niestandardowymi, użyj Resource Controller albo usuń i ponownie przypisz funkcję w IBM Quantum Platform, wykonując następujące czynności na stronie Instancje:

1. Kliknij menu przepełnienia na końcu wiersza instancji, a następnie wybierz Edytuj szczegóły.

2. Kliknij kartę Functions.

3. Usuń dostęp do funkcji z uprawnieniami niestandardowymi.

4. Kliknij Zapisz.

5. Powtórz kroki, aby ponownie przypisać dostęp do funkcji: wybierz Edytuj szczegóły dla instancji, kliknij kartę Functions, wybierz funkcję i kliknij Zapisz. Instancja ma teraz domyślne uprawnienia na poziomie użytkownika do tej funkcji.

Zarchiwizowane instancje

Zarchiwizowana instancja jest wynikiem jednego z poniższych scenariuszy.

Uprzywilejowany użytkownik zarchiwizował konto

Użytkownik z wystarczającymi uprawnieniami do konta zarchiwizował instancję.

• Wszelkie oczekujące zadania w instancji zostają anulowane.
• Zarchiwizowane instancje pojawiają się w osobnej sekcji „Archiwum" na stronie Instancje.
• Zadania nadal można pobierać.
• Użytkownicy nie mogą przesyłać nowych zadań do zarchiwizowanej instancji.
• Zarchiwizowana instancja nie jest wliczana do przydziału planu.
• Użytkownik z wystarczającymi uprawnieniami może w dowolnym momencie reaktywować instancję zarchiwizowaną przez siebie (lub innego uprzywilejowanego użytkownika).

Aby zarchiwizować instancję, którą zarządzasz, przejdź do strony Instancje. Na końcu wiersza tej instancji kliknij menu z trzema kropkami po prawej stronie, a następnie wybierz Archiwizuj instancję.

Konto nie ma już dostępu do planu instancji

Konto nie ma już dostępu do planu, w ramach którego instancja została utworzona.

• Zarchiwizowane instancje pojawiają się w osobnej sekcji „Archiwum" na stronie Instancje.

• Zadania nadal można pobierać.

• Użytkownicy nie mogą przesyłać nowych zadań do zarchiwizowanej instancji.

• Zarchiwizowana instancja nie jest wliczana do przydziału planu.

• Instancji zarchiwizowanych z powodu braku dostępu do planu instancji nie można reaktywować.

Następne kroki

Zalecenia

• Praca z grupami dostępu.
• Zarządzanie użytkownikami.
• Zapisywanie danych logowania.
• Inicjalizacja IBM Quantum Compute Service w zaufanym środowisku Python.
• Inicjalizacja IBM Quantum Compute Service w niezaufanym środowisku.