Створення та керування інстансами

Доступ до сервісів IBM Quantum Platform контролюється інстансами, до яких тебе призначено. Користувач може належати до кількох інстансів.

Інстанси — це віртуальні сервери (розгортання Qiskit Runtime), які керують виконанням твоїх робочих навантажень, зокрема запуском квантових програм і класичних обчислювальних задач (наприклад, обробкою пом'якшення помилок). Інстанси ідентифікуються своїм Cloud Resource Name (CRN). Цей CRN можна використовувати під час надсилання навантажень із твоїх програм Qiskit.

Інстанси, до яких ти маєш доступ, можна переглянути на панелі керування або натиснувши вкладку «Instances» на панелі керування. Кожен інстанс відображається разом із його ідентифікатором CRN.

Для кожного плану обслуговування (наприклад, Open або Pay-As-You-Go) і кожного регіону, в якому ти хочеш працювати, потрібен окремий інстанс. Менеджер облікового запису та всі, хто має достатні права, можуть створити інстанс і визначити його конфігурацію: розподіл ресурсів, ліміти використання, квантові комп'ютери та дозволи користувачів.

Панель керування IBM Quantum Platform відображає інстанси, до яких ти маєш доступ. Залежно від твоїх прав, на сторінці Instances можна переглядати повні деталі, редагувати та видаляти інстанси.

Важливо розуміти, який інстанс ти використовуєш, оскільки всі інстанси, не пов'язані з планом Open, є платними (або зараховуються до виділеного часу твого плану).

примітка

Завдання, які запускаєш ти, а також завдання інших співробітників у тому самому інстансі, враховуються у звітному використанні цього інстансу.

Переглянути використання інстансу можна на сторінці Instances, а для тих, хто має відповідні права, — на сторінці Analytics. Зверни увагу, що сторінки можуть показувати різні показники використання, оскільки сторінка Instances відображає загальне використання до поточного часового штампу, а сторінка Analytics використовує межі повних діб.

Інстанс плану Open

Користувачі плану Open можуть безкоштовно запускати квантові схеми на найкращих QPU у світі (до 10 хвилин у ковзному вікні тривалістю 28 днів). Використання QPU можна відстежувати на панелі керування Platform та на сторінці Workloads.

Інстанс плану Pay-As-You-Go

План Pay-As-You-Go є платним. Щоб скористатися цим планом, потрібно створити інстанс і прив'язати його до плану. За всі навантаження, надіслані на QPU в рамках цього плану, стягується плата. Інстанси Pay-As-You-Go можуть мати загальний ліміт витрат (необов'язково).

Інстанс плану Flex

План Flex є платним. Щоб скористатися цим планом, спочатку зв'яжись з IBM для реєстрації. Потім створи інстанс і прив'яжи його до плану. Усі навантаження, надіслані на QPU в рамках цього плану, зараховуються до твоєї підписки.

Адміністратор може встановити ліміт використання для інстансу Flex Plan, що діє на весь термін контракту. Якщо адміністратор позначив інстанс як «обмежений» (у розділі використання з'явиться стовпець «Remaining») і інстанс перевищує своє виділення (визначене адміністратором), всі активні навантаження продовжать виконуватися (включно із сесіями), але нові навантаження залишатимуться в черзі до появи вільного часу. Якщо інстанс не є обмеженим і перевищує своє виділення, завдання, що виконуються з цим інстансом, швидше за все, матимуть нижчий пріоритет і довший час очікування в черзі.

Якщо інстанс перевищив своє виділення, у розділі використання з'являється попередження.

Інстанс плану Premium

План Premium є платним. Щоб скористатися цим планом, спочатку зв'яжись з IBM для реєстрації. Потім створи інстанс і прив'яжи його до плану. Усі навантаження, надіслані на QPU в рамках цього плану, зараховуються до твоєї підписки.

Адміністратор може встановити ліміт використання для інстансу Premium Plan, що діє в межах 28-денного ковзного вікна використання плану. Якщо адміністратор позначив інстанс як «обмежений» (у розділі використання з'явиться стовпець «Remaining») і інстанс перевищує своє виділення (визначене адміністратором), всі активні навантаження продовжать виконуватися (включно із сесіями), але нові навантаження залишатимуться в черзі до появи вільного часу. Якщо інстанс не є обмеженим і перевищує своє виділення, завдання, що виконуються з цим інстансом, швидше за все, матимуть нижчий пріоритет і довший час очікування в черзі.

Якщо інстанс перевищив своє виділення, у розділі використання з'являється попередження.

Вказати інстанс у коді

Ти можеш використовувати CRN або ім'я інстансу, щоб вказати інстанс — або під час ініціалізації сервісу, або під час надсилання навантаження на QPU (наприклад, за допомогою `QiskitRuntimeService.backend()). Інструкції щодо вказання інстансу в коді дивись у розділі Ініціалізація облікового запису.

Коли інстанс передається явно, доступні лише Backend'и та завдання цього інстансу (дозволено в Qiskit Runtime v0.40.1 і пізніших версіях).

Якщо інстанс не вказано під час ініціалізації сервісу, доступні всі Backend'и та завдання в усіх інстансах твого облікового запису. У цьому випадку, коли вказано Backend, знаходиться та використовується інстанс, що має до нього доступ, як описано в розділі Автоматичний вибір інстансу.

Необхідні версії

Для наступного потрібна Qiskit Runtime v0.40.1 або пізніша версія:

• Використання імені інстансу для вказання інстансу
• Робота без передачі інстансу
• Встановлення бажаного типу інстансу та регіону

Для Qiskit Runtime v0.42 і пізніших версій безкоштовні плани отримують пріоритет за замовчуванням при автоматичному виборі інстансу.

Створити інстанс

Виконай ці кроки, щоб створити інстанс і додати його до свого облікового запису. Якщо ти адміністратор і тобі потрібно налаштувати Qiskit Runtime на Cloud для своєї організації, звернись до розділу Планування Qiskit Runtime для організації.

1. Щоб додати інстанс до свого облікового запису, спочатку переконайся, що в перемикачі облікових записів у заголовку вибрано правильний обліковий запис і регіон.

   • Ти можеш мати (або бути частиною) кілька облікових записів IBM Cloud. Якщо ти не бачиш очікуваних інстансів або завдань, спробуй інший обліковий запис.
   • Ти можеш отримати доступ до будь-якого регіону за допомогою одного й того самого ключа API, але можеш бачити та отримувати доступ лише до інстансів, створених у регіоні, до якого ти увійшов.
   • Якщо хочеш створити Open-інстанс, вибери регіон us-east.

   

   Про регіони

   Інстанс буде створено у вибраному регіоні. Цей регіон визначає такі важливі характеристики:

   • Які QPU доступні.
   • Де відбуваються класичні обчислення завдань, наприклад компіляція.
   • Де зберігаються дані робочого процесу користувача.

   Дані робочого процесу включають вхідні схеми, параметри схем і результати квантових обчислень. Вони не включають метадані, такі як кількість вимірювань, розмір схем та інша статистика завдань.

   Щоб уникнути витоку даних робочого процесу користувача через глобальний шар захисту від розподілених атак на відмову в обслуговуванні, можна використовувати Virtual Private Endpoints. qiskit-ibm-runtime підтримує це через параметр private_endpoint.

2. На панелі Instances панелі керування натисни View all або перейди на сторінку Instances через головне меню.

3. На сторінці Instances натисни Create instance.

   • Введи назву та за бажанням додай теги.
   • Якщо в IBM Cloud® тобі доступно кілька груп ресурсів, можеш змінити групу ресурсів, до якої належатиме цей інстанс. Детальніше дивись у розділах Managing resource groups та Giving access to resources in resource groups.

4. Вибери ціновий план, з яким пов'язаний цей інстанс (наприклад, Pay-As-You-Go). Залежно від вибраного цінового плану можна вказати додаткові параметри, наприклад ліміт витрат або кількість хвилин, виділених для цього інстансу. Зверни увагу: якщо цей інстанс не пов'язаний із безкоштовним планом, за його використання для запуску навантажень стягуватиметься плата.

5. Натисни Next. З'явиться список QPU, до яких матиме доступ інстанс.

   • Якщо хочеш, щоб інстанс мав доступ до всіх перелічених QPU (і всіх QPU, доданих до цього плану в майбутньому), натисни Next.
   • Якщо ти не налаштовуєш Open-інстанс, можеш вибрати, до яких QPU матиме доступ цей інстанс. Увімкни перемикач «Customize allocated compute resources». Вибери конкретні QPU, до яких матиме доступ цей інстанс, і натисни Next.
     примітка

     Якщо ти налаштовуєш виділені обчислювальні ресурси вручну, доступні QPU ніколи не оновлюватимуться автоматично, незалежно від змін у батьківському плані. Однак ти можеш вручну додавати або видаляти QPU пізніше. Якщо ж ти не налаштовуєш їх вручну, у тебе завжди буде доступ до будь-якого QPU, до якого має доступ обліковий запис за цим планом. Тобто, якщо в майбутньому до плану буде додано новий QPU, інстанс автоматично отримає до нього доступ.

6. Відкриється панель Access group. Для цього інстансу автоматично створюється група доступу «collaborators». Користувачі, додані до цієї групи доступу, можуть використовувати час, виділений для цього інстансу. Ти можеш змінити або створити додаткові групи доступу за допомогою консолі IBM Cloud. Інструкції дивись у розділі Setting up access groups.

7. Натисни Create instance. Тепер інстанс можна переглянути на сторінці Instances. Якщо в твоєму обліковому записі налаштовано кілька планів, кожен тип плану має власну вкладку в таблиці Instances.

Завдання в черзі

Стовпець Pending workloads у таблиці Instances показує кількість навантажень, що наразі очікують у черзі цього інстансу на всіх QPU.

Редагувати інстанс та його розподіл

Знайди інстанс на сторінці Instances. Натисни меню переповнення в кінці рядка інстансу та вибери Edit details.

примітка

Редагувати інстанс можуть лише адміністратори та власники. Інформацію про призначення доступу дивись у посібнику Створення політик доступу та груп доступу.

Архівні інстанси

Архівний інстанс — це результат одного з таких сценаріїв.

Привілейований користувач заархівував обліковий запис

Користувач із достатніми правами для облікового запису заархівував інстанс.

• Усі завдання в черзі в цьому інстансі скасовуються.
• Архівні інстанси відображаються в окремому розділі «Archive» на сторінці Instances.
• Завдання можна переглядати.
• Користувачі не можуть надсилати нові завдання до архівного інстансу.
• Архівний інстанс не враховується у виділенні твого плану.
• Користувач із достатніми правами може в будь-який момент реактивувати інстанс, заархівований ним (або іншим привілейованим користувачем).

Щоб заархівувати інстанс, яким ти керуєш, перейди на сторінку Instances. В кінці рядка цього інстансу натисни меню з трьома крапками праворуч, а потім вибери Archive instance.

Обліковий запис більше не має доступу до плану інстансу

Обліковий запис більше не має доступу до плану, в рамках якого було створено інстанс.

• Архівні інстанси відображаються в окремому розділі «Archive» на сторінці Instances.
• Завдання можна переглядати.
• Користувачі не можуть надсилати нові завдання до архівного інстансу.
• Архівний інстанс не враховується у виділенні твого плану.
• Інстанси, заархівовані через відсутність доступу до плану, не можуть бути реактивовані.

Наступні кроки

Рекомендації

• Робота з групами доступу.
• Управління користувачами.
• Збережи свої облікові дані.
• Ініціалізуй сервіс Qiskit Runtime у надійному середовищі Python.
• Ініціалізуй сервіс Qiskit Runtime у ненадійному середовищі.