Affichage des demandes de travail

Découvrez comment visualiser les opérations de Kubernetes Engine (OKE) en tant que demandes de travail.

De nombreuses demandes de service Kubernetes Engine ne prennent pas effet immédiatement. Par exemple, la création d'un pool de noeuds n'est pas terminée tant que tous les noeuds requis ne sont pas actifs. Dans ce cas, la demande est exécutée de manière asynchrone et sa progression est suivie par une demande de travail associée. Une demande de travail est un journal d'activités qui fournit une visibilité sur les opérations asynchrones en cours, ce qui vous permet de suivre chaque étape de la progression de l'opération. Chaque demande de travail possède un OCID qui permet d'interagir avec elle par programmation et de l'utiliser à des fins d'automatisation.

Les demandes de travail incluent des informations sur l'heure de début et de fin de la demande. En cas d'échec d'une opération, une demande de travail peut vous aider à déterminer l'étape du processus qui comportait une erreur. Certaines opérations ont une incidence sur plusieurs ressources. Par exemple, la création d'un pool de noeuds affecte également les noeuds. Une demande de travail fournit la liste des ressources impactées par une opération.

Pour plus d'informations, reportez-vous à Demandes de travail et à API des demandes de travail.

Demandes de travail de pool de noeuds

Les ressources gérées par Kubernetes Engine ne peuvent prendre en charge qu'une seule demande de travail à la fois. Les demandes de travail lancées alors qu'une autre demande de travail est en cours échoueront et renverront un conflit. Etant donné que certaines opérations dépendent de l'exécution d'autres opérations, vous devez surveiller la demande de travail de chaque opération et vérifier qu'elle aboutit avant de passer à l'opération suivante. Une demande de travail de création de pool de noeuds a le statut Succès lorsque le workflow crée un noeud et que le noeud est inscrit avec le statut Actif.

Statut de demande de travail

Le tableau suivant répertorie les états des demandes de travail :

Statut

Description

Accepté

La demande se trouve dans la file d'attente des demandes de travail à traiter.

En cours

Il existe un enregistrement de demande de travail pour la demande spécifiée, mais aucun enregistrement WORK_COMPLETED associé n'existe.

Terminé

Un enregistrement de demande de travail existe pour cette demande et un enregistrement WORK_COMPLETED associé a l'état Succès.

Echec

Un enregistrement de demande de travail existe pour cette demande et un enregistrement WORK_COMPLETED associé a l'état En échec.

Annulation

La demande de travail est en cours d'annulation.

Annulé

La demande de travail a été annulée.

Stratégie IAM requise pour visualiser les demandes de travail

Pour utiliser Oracle Cloud Infrastructure, un administrateur doit être membre d'un groupe auquel un administrateur de location a accordé un accès de sécurité dans une stratégie . Cet accès est requis, que vous utilisiez la console ou l'API REST avec un kit SDK, une interface de ligne de commande ou un autre outil. Si un message vous informe que vous n'avez pas d'autorisation ou que vous n'êtes pas autorisé, vérifiez auprès de l'utilisateur le type d'accès qui vous est accordé et le compartiment dans lequel vous travaillez.

Pour les administrateurs : les demandes de travail héritent des droits d'accès de l'opération qui génère la demande de travail de façon dynamique. Afin de permettre aux utilisateurs de visualiser les demandes de travail, les journaux et les messages d'erreur d'une opération, écrivez une stratégie qui les autorise à effectuer cette opération. Par exemple, pour que les utilisateurs puissent consulter les demandes de travail associées au lancement d'instances, écrivez une stratégie qui leur permet de lancer des instances.

Pour permettre aux utilisateurs de répertorier toutes les demandes de travail dans une location, utilisez la stratégie suivante :

Allow group SupportTeam to inspect work-requests in tenancy

Si vous ne connaissez pas les stratégies, reportez-vous à Gestion des domaines d'identité et à Stratégies courantes.

Liste des demandes de travail

Découvrez comment répertorier les demandes de travail pour une ressource de cluster ou de pool de noeuds à l'aide de Kubernetes Engine (OKE).

Vous pouvez afficher la liste des demandes de travail pour une ressource de cluster ou de pool de noeuds sélectionnée à l'aide de la console, de l'interface de ligne de commande et de l'API.

    1. Sur la page de liste Clusters, sélectionnez le nom du cluster pour lequel vous souhaitez répertorier les demandes de travail. Si vous avez besoin d'aide pour trouver la page de liste ou le cluster, reportez-vous à Liste des clusters.
    2. Si vous souhaitez répertorier les demandes de travail pour un pool de noeuds particulier dans le cluster, sélectionnez Pools de noeuds sous Ressources, puis sélectionnez le nom du pool de noeuds.
    3. Sous Ressources, sélectionnez Demandes de travail.

      La liste Demandes de travail affiche les demandes de travail récentes.

  • Utilisez l'interface de ligne de commande afin de répertorier les demandes de travail pour une ressource de cluster ou de pool de noeuds.

    Saisissez la commande suivante :

    oci ce work-request list --compartment-id compartment-OCID --resource-type CLUSTER|NODEPOOL --cluster-id cluster-OCID --resource-id resource-OCID [OPTIONS]

    Pour obtenir la liste des options, reportez-vous à l'aide en ligne de l'interface de ligne de commande :

    oci ce work-request list --help

    Pour obtenir une description complète de la commande, reportez-vous à oci ce work-request list.

  • Exécutez la méthode ListWorkRequests pour répertorier les demandes de travail d'une ressource de cluster ou de pool de noeuds.

Obtention des détails d'une demande de travail

Découvrez comment obtenir les détails d'une demande de travail pour une ressource de cluster ou de pool de noeuds à l'aide de Kubernetes Engine (OKE).

Vous pouvez obtenir les détails d'une demande de travail pour une ressource de cluster ou de pool de noeuds sélectionnée à l'aide de la console, de l'interface de ligne de commande et de l'API.

    1. Sur la page de liste Clusters, sélectionnez le nom du cluster pour lequel vous souhaitez obtenir les détails de la demande de travail. Si vous avez besoin d'aide pour trouver la page de liste ou le cluster, reportez-vous à Liste des clusters.
    2. Pour obtenir les détails d'une demande de travail pour un pool de noeuds particulier dans le cluster, sélectionnez Pools de noeuds sous Ressources, puis sélectionnez le nom du pool de noeuds.
    3. Sous Ressources, sélectionnez Demandes de travail.

      La liste Demandes de travail affiche les demandes de travail récentes.

    4. Dans la liste Demandes de travail, recherchez la demande de travail pour laquelle vous souhaitez obtenir des détails. Pour chaque demande de travail récente, vous pouvez consulter les éléments suivants :

      • Type d'opération : Opération effectuée par la demande de travail.
      • Statut : reportez-vous à Statut de demande de travail pour obtenir la liste des statuts et leur description.
      • ID : OCID de la demande de travail.
      • Ressource : Nom de la ressource.
      • Heure de début : groupe date/heure de début de la demande de travail au format UTC.
      • Heure de fin : groupe date/heure de fin de la demande de travail au format UTC.
    5. Sélectionnez une demande de travail particulière pour voir :
      • Messages de journal : informations sur l'étape du workflow et un horodatage pour chaque étape.
      • Messages d'erreur : informations sur les erreurs et l'horodatage de l'erreur.
      • Ressources associées : nom, type et OCID des ressources concernées par la demande de travail.
  • Utilisez l'interface de ligne de commande afin d'obtenir les détails d'une demande de travail pour une ressource de cluster ou de pool de noeuds.

    Saisissez la commande suivante :

    oci ce work-request get --work-request-id work_request_id [OPTIONS]

    Pour obtenir la liste des options, reportez-vous à l'aide en ligne de l'interface de ligne de commande :

    oci ce work-request get --help

    Pour obtenir une description complète de la commande, reportez-vous à oci ce work-request get.

  • Exécutez la méthode GetWorkRequest pour obtenir les détails d'une demande de travail pour un cluster ou un pool de noeuds.