Creează și gestionează instanțe

Accesul la serviciile IBM Quantum® Platform este controlat de instanțele cărora le ești atribuit. Utilizatorii pot aparține mai multor instanțe.

Instanțele sunt servere virtuale (implementări ale IBM Quantum Compute Service) care gestionează execuția volumelor tale de lucru, inclusiv executarea programelor cuantice și a sarcinilor de calcul clasic (cum ar fi procesarea atenuării erorilor). Instanțele sunt identificate prin Cloud Resource Name (CRN). Acest CRN poate fi utilizat la trimiterea volumelor de lucru din programele tale Qiskit.

Poți vedea instanțele la care ai acces pe dashboard, sau dând clic pe fila „Instances" din dashboard. Fiecare instanță este listată cu identificatorul său CRN.

Ai nevoie de o instanță diferită pentru fiecare plan de servicii (cum ar fi Open sau Pay-As-You-Go) pe care îl folosești în fiecare regiune în care dorești să operezi. Managerul de cont și oricine are permisiunile necesare poate crea o instanță și îi poate defini configurația, cum ar fi alocările, limitele de utilizare, calculatoarele cuantice și permisiunile utilizatorilor.

Dashboard-ul IBM Quantum Platform afișează instanțele la care ai acces. În funcție de accesul tău, poți vizualiza detalii complete, edita și șterge instanțe pe pagina Instances.

Este important să știi ce instanță folosești, deoarece toate instanțele care nu sunt asociate cu Planul Open implică un cost (sau se scad din timpul alocat planului tău).

notă

Joburile pe care le rulezi tu și joburile rulate de alți colaboratori din aceeași instanță contribuie la utilizarea raportată pentru acea instanță.

Poți vizualiza utilizarea unei instanțe pe pagina Instances, sau, pentru cei cu autoritatea corespunzătoare, pe pagina Analytics. Reține că paginile pot afișa numere de utilizare diferite, deoarece pagina Instance afișează utilizarea totală înainte de timestamp-ul curent, în timp ce pagina Analytics folosește limite de zi completă.

Instanța Planului Open

Utilizatorii Planului Open pot rula circuite cuantice pe cele mai bune QPU-uri din lume gratuit (echivalentul în unități de resurse (RU) a 10 minute de utilizare a unității de procesare cuantică (QPU) pe o fereastră mobilă de 28 de zile). Utilizarea poate fi urmărită pe paginile Platform dashboard și Workloads.

Instanța Planului Pay-As-You-Go

Planul Pay-As-You-Go este un plan cu plată. Pentru a folosi acest plan, trebuie să creezi o instanță și să o asociezi cu planul. Toate volumele de lucru trimise la QPU-uri prin acest plan implică un cost. Instanțele Pay-as-you-go pot avea o limită totală de cost (opțional).

Instanța Planului Flex

Planul Flex este un plan cu plată. Pentru a folosi acest plan, trebuie mai întâi să contactezi IBM pentru a te înregistra. Apoi, creează o instanță și asociaz-o cu planul. Toate volumele de lucru trimise la QPU-uri prin acest plan contează pentru abonamentul tău alocat.

Un administrator poate seta o limită de utilizare pe o instanță a Planului Flex care se aplică pe durata contractului. Dacă o instanță a fost marcată ca „limitată" de administratorul tău (vei vedea o coloană „Remaining" în zona de utilizare) și instanța depășește alocarea sa (definită de administratorul tău), orice volum de lucru activ va continua să ruleze (inclusiv sesiunile), dar volumele de lucru în așteptare vor rămâne în coadă până când mai mult timp devine disponibil. Dacă o instanță nu este limitată și depășește alocarea sa, joburile rulate cu acea instanță vor rula probabil la o prioritate mai mică și vor experimenta timpi de așteptare mai lungi în coadă.

O alertă se afișează pe utilizarea unei instanțe când aceasta a depășit alocarea sa.

Instanța Planului Premium

Planul Premium este un plan cu plată. Pentru a folosi acest plan, trebuie mai întâi să contactezi IBM pentru a te înregistra. Apoi, creează o instanță și asociaz-o cu planul. Toate volumele de lucru trimise la QPU-uri prin acest plan contează pentru abonamentul tău alocat.

Un administrator poate seta o limită de utilizare pe o instanță Premium Plan care se aplică la fereastra mobilă de utilizare de 28 de zile a planului. Dacă o instanță a fost marcată ca „limitată" de administratorul tău, vei vedea o coloană „Remaining" în zona de utilizare. Dacă instanța ta a fost marcată „limitată" și depășește limita stabilită de administratorul tău, orice volum de lucru în așteptare va rămâne în coadă până când devine disponibil mai mult timp; totuși, orice volum de lucru activ va continua să ruleze, inclusiv volumele de lucru în session mode.

Dacă o instanță nu este limitată și își depășește alocarea, volumele de lucru rulate cu ea vor avea probabil o prioritate mai mică și timpi de așteptare mai lungi în coadă.

O alertă se afișează pe utilizarea unei instanțe când aceasta a depășit alocarea sa.

Specifică o instanță în codul tău

Poți folosi CRN-ul sau numele instanței pentru a specifica o instanță de utilizat — fie la inițializarea serviciului, fie la trimiterea volumului de lucru la un QPU (de exemplu, cu `QiskitRuntimeService.backend()). Pentru instrucțiuni despre cum să specifici o instanță în codul tău, consultă Inițializează-ți contul.

Când o instanță este transmisă, sunt disponibile doar Backend-urile și joburile din acea instanță (permis în qiskit-ibm-runtime v0.40.1 și versiuni ulterioare).

Dacă o instanță nu este inclusă la inițializarea serviciului, sunt disponibile toate Backend-urile și joburile din toate instanțele contului tău. În acest caz, când un Backend este specificat, se găsește și se folosește o instanță care poate accesa acel Backend, așa cum este descris în Selectare automată a instanței.

Versiuni necesare

Qiskit Runtime v0.40.1 sau o versiune ulterioară este necesară pentru următoarele:

• Utilizarea numelui instanței pentru a specifica o instanță

• Netransmiterea unei instanțe la inițializare

• Setarea unui tip de instanță și a unei regiuni preferate

Pentru Qiskit Runtime v0.42 sau versiuni ulterioare, planurile gratuite sunt prioritizate în mod implicit când se folosește selecția automată a instanței.

Creează o instanță

Urmează acești pași pentru a crea o instanță și a o adăuga în contul tău. Dacă ești un administrator care trebuie să configureze Quantum Compute pe Cloud pentru organizația ta, consultă Planifică Quantum Compute pentru o organizație.

1. Pentru a adăuga o instanță în contul tău, asigură-te mai întâi că ai contul și regiunea corecte selectate în comutatorul de cont din antet.

   • Poți avea (sau face parte din) mai multe conturi IBM Cloud. Dacă nu vezi instanțele sau joburile așteptate, încearcă un alt cont.

   • Poți accesa oricare regiune folosind aceeași cheie API, dar poți vedea și accesa doar instanțele care au fost create în regiunea în care ești conectat.

   • Dacă vrei să creezi o instanță Open, trebuie să alegi regiunea us-east.

   

   Despre regiuni

   Instanța va fi creată în regiunea selectată. Această regiune determină aceste caracteristici importante:

   • Ce QPU-uri sunt disponibile.
   • Unde se desfășoară calculul clasic al joburilor, cum ar fi compilarea.
   • Unde rămân datele fluxului de lucru al utilizatorului.

   Datele fluxului de lucru includ circuitele de intrare, parametrii circuitelor și rezultatele calculului cuantic. Nu includ metadate, cum ar fi numărul de shots, dimensiunea circuitelor sau alte statistici ale joburilor.

   Pentru a evita expunerea datelor fluxului de lucru al utilizatorului la un strat global de protecție Distributed Denial of Service, poți folosi Virtual Private Endpoints. qiskit-ibm-runtime suportă acest lucru prin parametrul private_endpoint.

2. Din panoul Instances al dashboard-ului, dă clic pe View all, sau mergi la pagina Instances din meniul principal.

3. Din pagina Instances, dă clic pe Create instance.

   • Introdu un nume și adaugă opțional etichete.

   • Dacă ai acces la mai mult de un grup de resurse în IBM Cloud®, poți alege să schimbi grupul de resurse căruia îi aparține această instanță. Consultă Gestionarea grupurilor de resurse și Acordarea accesului la resurse în grupurile de resurse pentru mai multe informații.

4. Selectează planul de prețuri cu care este asociată această instanță (de exemplu, Pay-As-You-Go). În funcție de planul de prețuri selectat, poți specifica alte opțiuni, cum ar fi limita de cost sau numărul de RU de alocat acestei instanțe. Reține că, dacă această instanță nu este asociată cu un plan gratuit, va fi perceput un cost când această instanță este utilizată pentru a rula volume de lucru.

5. Dă clic pe Next. Se afișează o listă cu QPU-urile pe care instanța le poate accesa.

   • Dacă vrei ca instanța să aibă acces la toate QPU-urile listate (și la toate QPU-urile adăugate la acest plan în viitor), dă clic pe Next.

   • Dacă nu configurezi o instanță open, poți personaliza ce QPU-uri pot fi accesate cu această instanță. Dă clic pe comutatorul „Customize allocated compute resources". Selectează QPU-uri specifice pe care această instanță le poate accesa, apoi dă clic pe Next.

     notă

     Dacă personalizezi resursele de calcul alocate, QPU-urile disponibile nu vor fi niciodată actualizate automat, indiferent de orice modificări aduse planului părinte. Totuși, poți adăuga sau elimina manual QPU-uri ulterior. Dacă nu le personalizezi, vei avea întotdeauna acces la orice QPU la care contul are acces în plan. Deci, dacă în viitor un nou QPU este adăugat la plan, instanța are automat acces la el.

     Dispozitivele mock sunt ascunse implicit în această listă. Activează comutatorul pentru a le afișa, apoi selectează dispozitivele mock pe care vrei să le incluzi. Poți restricționa o instanță doar la dispozitive mock selectând numai dispozitivele mock. Acest lucru este util pentru studenți sau participanți la cursuri, care își pot astfel valida sarcinile de lucru de la un capăt la altul, fără a consuma timp QPU real sau RU. Deoarece instanța are acces doar la dispozitive mock, utilizatorii selectează backend-ul după numele său mock, de exemplu service.backend("mock_phoenix"). Pentru mai multe informații, consultă Joburi dry-run.

6. Se deschide panoul Access group. Un grup de acces „collaborators" este creat automat pentru această instanță. Utilizatorii adăugați la acest grup de acces pot folosi timpul alocat acestei instanțe. Poți modifica sau crea grupuri de acces suplimentare folosind consola IBM Cloud. Consultă Configurarea grupurilor de acces pentru instrucțiuni.

7. Dă clic pe Create instance. Acum poți vizualiza instanța pe pagina Instances. Dacă ai configurat mai multe planuri în contul tău, fiecare tip de plan are propria filă în tabelul Instances.

Volume de lucru în așteptare

Coloana Pending workloads din tabelul Instances arată numărul de volume de lucru aflate în prezent în coada acestei instanțe pe toate QPU-urile.

Editează o instanță și alocarea sa

Găsește instanța pe pagina Instances. Dă clic pe meniul overflow la sfârșitul rândului instanței și selectează Edit details.

notă

Doar administratorii și proprietarii pot edita instanța. Consultă ghidul Creează politici de acces și grupuri de acces pentru informații despre atribuirea accesului.

Configurează accesul la Qiskit Functions într-o instanță

notă

Fila Functions și opțiunile ei apar doar dacă contul tău a fost configurat cu acces la Qiskit Functions. Dacă contul tău are acces la Qiskit Functions, dar nu vezi opțiunea de a edita accesul la funcții per instanță, contul tău nu a fost încă migrat la această metodă. Contactează managerul tău de relații sau echipa de suport pentru a fi migrat.

Poți configura la care Qiskit Functions are acces o instanță fie folosind Resource Controller API (vezi Configure Qiskit Functions access on an instance), fie urmând acești pași în IBM Quantum Platform.

1. Mergi la pagina Instances.

2. Asigură-te că ai selectat contul corect în comutatorul de cont din antet.

3. Găsește instanța pentru care vrei să activezi accesul la funcții.

4. Dă clic pe meniul overflow de la sfârșitul rândului instanței, apoi selectează Edit details.

5. Dă clic pe fila Functions.

6. Activează accesul la funcții și selectează funcția pe care vrei să o activezi.

7. Citește și confirmă că ai citit acordurile.

8. Dă clic pe Save pentru a salva modificările.

Reține că, dacă contul tău are acces la Qiskit Functions, poți configura accesul și atunci când adaugi o instanță nouă. Dă clic pe Create instance și urmează pașii din fereastra care se deschide. În pasul Functions, poți activa accesul la funcțiile din catalog și la funcțiile personalizate și poți specifica la care Qiskit Functions are acces instanța.

Permisiuni implicite și personalizate

Permisiunile implicite la nivel de utilizator se aplică atunci când configurezi accesul la Qiskit Functions pentru o instanță în IBM Quantum Platform. Utilizatorii cu permisiuni implicite pot face următoarele:

• Să vizualizeze funcția și detaliile ei

• Să trimită joburi folosind funcția

• Să listeze și să descarce fișierele stocate în spațiul de lucru al utilizatorului

• Să încarce, să actualizeze și să șteargă fișierele de intrare și de rezultat din spațiul de lucru al utilizatorului

Pentru a atribui permisiuni Custom, folosește în schimb Resource Controller API. Consultă Configure Qiskit Functions access on an instance pentru mai multe informații. Pentru a găsi referința API, dă clic pe pictograma de informații de lângă permisiunile unei funcții din fila Functions, apoi dă clic pe linkul View the API reference din tooltip.

Pentru a restaura permisiunile implicite ale unei instanțe care are permisiuni personalizate, fie folosește Resource Controller, fie elimină și realocă funcția în IBM Quantum Platform, făcând următoarele în pagina Instances:

1. Dă clic pe meniul overflow de la sfârșitul rândului instanței, apoi selectează Edit details.

2. Dă clic pe fila Functions.

3. Elimină accesul la funcția cu permisiuni personalizate.

4. Dă clic pe Save.

5. Repetă pașii pentru a realoca accesul la funcție: selectează Edit details pentru instanță, dă clic pe fila Functions, selectează funcția și dă clic pe Save. Instanța are acum permisiunile implicite la nivel de utilizator pentru acea funcție.

Instanțe arhivate

O instanță arhivată este rezultatul unuia dintre următoarele scenarii.

Un utilizator privilegiat a arhivat contul

Un utilizator cu privilegii suficiente pentru cont a arhivat instanța.

• Orice joburi în așteptare din instanță sunt anulate.
• Instanțele arhivate apar într-o secțiune separată „Archive" pe pagina Instances.
• Joburile pot fi în continuare recuperate.
• Utilizatorii nu pot trimite joburi noi instanței arhivate.
• Instanța arhivată nu contează în alocarea planului tău.
• Un utilizator cu privilegii suficiente poate reactiva o instanță pe care ei (sau un alt utilizator privilegiat) au arhivat-o oricând.

Pentru a arhiva o instanță pe care o gestionezi, mergi la pagina Instances. La sfârșitul rândului pentru acea instanță, dă clic pe meniul overflow cu trei puncte din dreapta, apoi selectează Archive instance.

Contul nu mai are acces la planul instanței

Contul nu mai are acces la planul sub care a fost creată instanța.

• Instanțele arhivate apar într-o secțiune separată „Archive" pe pagina Instances.

• Joburile pot fi în continuare recuperate.

• Utilizatorii nu pot trimite joburi noi instanței arhivate.

• Instanța arhivată nu contează în alocarea planului tău.

• Instanțele care au fost arhivate deoarece nu mai au vizibilitate asupra planului instanței nu pot fi reactivate.

Pași următori

Recomandări

• Lucrează cu grupuri de acces.
• Gestionează utilizatorii.
• Salvează-ți datele de autentificare.
• Inițializează IBM Quantum Compute Service într-un mediu Python de încredere.
• Inițializează IBM Quantum Compute Service într-un mediu fără încredere.