Aller au contenu principal

Créer et gérer des instances

L'accès aux services d'IBM Quantum Platform est contrôlé par les instances auxquelles tu es assigné·e. Les utilisateurs peuvent appartenir à plusieurs instances.

Les instances sont des serveurs virtuels (des déploiements de Qiskit Runtime) qui gèrent l'exécution de tes charges de travail, notamment l'exécution de programmes quantiques et de tâches de calcul classique (comme le traitement de la mitigation d'erreurs). Les instances sont identifiées par leur Cloud Resource Name (CRN). Ce CRN peut être utilisé lors de l'envoi de charges de travail depuis tes programmes Qiskit.

Tu peux voir les instances auxquelles tu as accès sur le tableau de bord, ou en cliquant sur l'onglet « Instances » depuis le tableau de bord. Chaque instance est répertoriée avec son identifiant CRN.

Tu as besoin d'une instance différente pour chaque plan de service (comme Open ou Pay-As-You-Go) que tu utilises dans chaque région que tu souhaites utiliser. Le gestionnaire de compte et toute personne disposant des autorisations suffisantes peut créer une instance et définir sa configuration, comme ses allocations, ses limites d'utilisation, ses ordinateurs quantiques et ses autorisations utilisateur.

Le tableau de bord d'IBM Quantum Platform affiche les instances auxquelles tu as accès. Selon tes droits d'accès, tu peux consulter tous les détails, modifier et supprimer des instances sur la page Instances.

Il est important de savoir quelle instance tu utilises, car toutes les instances qui ne sont pas associées au plan Open entraînent un coût.

Instance du plan Open​

Les utilisateurs du plan Open peuvent exécuter des circuits quantiques sur les meilleurs QPU du monde gratuitement (jusqu'à 10 minutes de temps quantique par fenêtre glissante de 28 jours). L'utilisation des QPU peut être suivie sur les pages Tableau de bord de la plateforme et Charges de travail.

Instance du plan Pay-As-You-Go​

Le plan Pay-As-You-Go est un plan payant. Pour utiliser ce plan, tu dois créer une instance et l'affecter au plan. Toutes les charges de travail envoyées aux QPU avec ce plan entraînent des frais.

Les jobs que tu exécutes et les jobs exécutés par d'autres collaborateurs dans la même instance sont comptabilisés dans l'utilisation signalée pour cette instance. Tu peux consulter l'utilisation d'une instance sur la page Instances, ou, pour ceux disposant des droits appropriés, sur la page Analytics. Remarque que les pages peuvent afficher des chiffres d'utilisation différents, car la page Instance affiche l'utilisation dans une fenêtre glissante de 28 jours avant l'horodatage actuel, tandis que la page Analytics utilise des limites de journées complètes.

Si une instance a été marquée comme « limitée » par ton administrateur (tu verras une colonne « Restant » dans la zone d'utilisation) et que l'instance dépasse son allocation (définie par ton administrateur) dans la fenêtre glissante de 28 jours, toute charge de travail active continuera de s'exécuter (y compris les sessions), mais les charges de travail en attente resteront dans la file d'attente jusqu'à ce que davantage de temps soit disponible. Si une instance n'est pas limitée et qu'elle dépasse son allocation, les jobs exécutés avec cette instance seront probablement exécutés avec une priorité plus basse et subiront des temps d'attente plus longs.

Une alerte s'affiche sur l'utilisation d'une instance lorsqu'elle a dépassé son allocation.

Spécifier une instance dans ton code​

Tu peux utiliser le CRN ou le nom de l'instance pour spécifier une instance à utiliser — soit lors de l'initialisation du service, soit lors de l'envoi de la charge de travail vers un QPU (par exemple, avec `QiskitRuntimeService.backend()). Pour les instructions permettant de spécifier une instance dans ton code, consulte Initialiser ton compte.

Lorsqu'une instance est transmise, seuls les backends et les jobs de cette instance sont disponibles (autorisé dans Qiskit Runtime v0.40.1 et versions ultérieures).

Si aucune instance n'est incluse lors de l'initialisation du service, tous les backends et jobs de toutes les instances de ton compte sont disponibles. Dans ce cas, lorsqu'un backend est spécifié, une instance pouvant accéder au backend est trouvée et utilisée comme décrit dans Sélectionner automatiquement l'instance.

Versions requises

Qiskit Runtime v0.40.1 ou version ultérieure est requis pour les éléments suivants :

  • Utiliser le nom de l'instance pour spécifier une instance
  • Ne pas transmettre d'instance
  • Définir un type d'instance et une région préférés

Pour Qiskit Runtime v0.42 ou version ultérieure, les plans gratuits sont prioritaires par défaut lorsque la sélection automatique d'instance est utilisée.

Créer une instance​

Suis ces étapes pour créer une instance et l'ajouter à ton compte. Si tu es un administrateur qui doit configurer Qiskit Runtime sur Cloud pour ton organisation, consulte Planifier Qiskit Runtime pour une organisation.

  1. Pour ajouter une instance à ton compte, assure-toi d'abord d'avoir sélectionné le bon compte et la bonne région dans le sélecteur de compte dans l'en-tête.

    • Tu peux avoir (ou faire partie de) plusieurs comptes IBM Cloud. Si tu ne vois pas les instances ou les jobs que tu attends, essaie un autre compte.
    • Tu peux accéder à l'une ou l'autre région en utilisant la même clé API, mais tu ne peux voir et accéder qu'aux instances créées dans la région à laquelle tu es connecté·e.
    • Si tu veux créer une instance Open, tu dois choisir la région us-east.

    L'en-tête IBM Quantum Platform est affiché. Le sélecteur de compte est immédiatement à droite de la barre de recherche. Le sélecteur de région est immédiatement à droite du sélecteur de compte.

    À propos des régions

    L'instance sera créée dans la région sélectionnée. Cette région détermine ces caractéristiques importantes :

    • Quels QPU sont disponibles.
    • Où le calcul classique des jobs, comme la compilation, a lieu.
    • Où les données de flux de travail de l'utilisateur sont conservées.

    Les données de flux de travail comprennent les circuits d'entrée, les paramètres de circuit et les résultats de calcul quantique. Elles n'incluent pas les métadonnées, comme le nombre de shots, la taille des circuits ou d'autres statistiques de jobs.

    Pour éviter l'exposition des données de flux de travail de l'utilisateur à une couche de protection mondiale contre les attaques par déni de service distribué, tu peux utiliser les Virtual Private Endpoints. qiskit-ibm-runtime prend en charge cela via le paramètre private_endpoint.

  2. Depuis le volet Instances du tableau de bord, clique sur Tout afficher, ou accède à la page Instances depuis le menu principal.

  3. Depuis la page Instances, clique sur Créer une instance.

  4. Sélectionne le plan tarifaire auquel cette instance est associée (par exemple, Pay-As-You-Go). Selon le plan tarifaire sélectionné, tu peux spécifier d'autres options, comme la limite de coût ou le nombre de minutes à allouer à cette instance. Remarque que si cette instance n'est pas associée à un plan gratuit, un coût sera engagé lorsque cette instance est utilisée pour exécuter des charges de travail.

  5. Clique sur Suivant. Une liste des QPU auxquels l'instance peut accéder s'affiche.

    • Si tu veux que l'instance ait accès à tous les QPU répertoriés (et à tous les QPU ajoutés à ce plan à l'avenir), clique sur Suivant.
    • Si tu ne configures pas une instance open, tu peux personnaliser les QPU auxquels cette instance peut accéder. Clique sur le bouton bascule « Personnaliser les ressources de calcul allouées ». Sélectionne les QPU spécifiques auxquels cette instance peut accéder, puis clique sur Suivant.
      remarque

      Si tu personnalises les ressources de calcul allouées, les QPU disponibles ne seront jamais mis à jour automatiquement, quelles que soient les modifications apportées au plan parent. Cependant, tu peux ajouter ou supprimer des QPU manuellement ultérieurement. Si tu ne les personnalises pas, tu auras toujours accès à tout QPU auquel le compte a accès sur le plan. Ainsi, si un nouveau QPU est ajouté au plan à l'avenir, l'instance y aura automatiquement accès.

  6. Le volet Groupe d'accès s'ouvre. Un groupe d'accès « collaborateurs » est automatiquement créé pour cette instance. Les utilisateurs ajoutés à ce groupe d'accès peuvent utiliser le temps alloué à cette instance. Tu peux modifier ou créer des groupes d'accès supplémentaires en utilisant la console IBM Cloud. Consulte Configurer des groupes d'accès pour les instructions.

  7. Clique sur Créer une instance. Tu peux maintenant voir l'instance sur la page Instances. Si tu as configuré plusieurs plans sur ton compte, chaque type de plan a son propre onglet dans le tableau Instances.

Modifier une instance et son allocation​

Trouve l'instance sur la page Instances. Clique sur le menu de débordement à la fin de la ligne de l'instance, et sélectionne Modifier les détails.

remarque

Seuls les administrateurs et les propriétaires peuvent modifier l'instance. Consulte le guide Créer des politiques d'accès et des groupes d'accès pour des informations sur l'attribution des accès.

Étapes suivantes​

Recommandations