Remarques :

Utilisation d'OCI Functions et de Python pour ouvrir des tickets dans Jira Service Management

Introduction

Le tutoriel suivant s'adresse aux utilisateurs d'Oracle Cloud Infrastructure (OCI) qui utilisent à la fois le service OCI Monitoring et Jira Service Management pour ouvrir des tickets et suivre les incidents. Disons que vous disposez d'une instance OCI et que vous voulez savoir quand l'instance tombe en panne de manière inattendue en raison d'une erreur. Vous voulez être averti et un ticket ouvert dans Jira Service Management immédiatement afin que l'ingénieur en service puisse commencer à enquêter et à résoudre le problème dès que possible. A l'aide du service OCI Functions, les tickets peuvent être automatiquement ouverts dans Jira Service Management lorsque des problèmes sont détectés avec les systèmes de votre organisation.

Objectifs

Prérequis

Tâche 1 : création d'un réseau cloud virtuel

Un réseau cloud virtuel (VCN) est un réseau que vous définissez dans OCI. Il inclut les sous-réseaux, les tables de routage et les passerelles.

  1. Cliquez sur le menu des services Menu Services dans l'angle supérieur gauche de la console OCI.

  2. Sous Networking, sélectionnez Réseaux cloud virtuels.

  3. Sur la page Réseaux cloud virtuels, cliquez sur Lancer l'assistant de réseau cloud virtuel.

  4. Sélectionnez Créer un VCN avec la connectivité Internet et cliquez sur Démarrer l'assistant VCN.

  5. Terminez la configuration du VCN, cliquez sur Suivant et sur Créer.

Tâche 2 : créer un groupe dynamique

Les groupes dynamiques vous permettent de regrouper des instances OCI Compute en tant qu'acteurs principaux (comme des groupes d'utilisateurs).

Remarque : vous devez disposer de privilèges d'administrateur pour créer des groupes dynamiques.

  1. Dans le menu Services, accédez à Identité et sécurité, à Identité et cliquez sur Groupes dynamiques.

  2. Cliquez sur Créer un groupe dynamique.

  3. Entrez un nom et une description explicites.

  4. Dans la section Règle 1, ajoutez la ligne suivante :

    ALL {resource.type = 'fnfunc', resource.compartment.id = 'ocid1.compartment.oc1', instance.compartment.id = 'ocid1.compartment.oc1'}

    Remarque : remplacez l'ID de compartiment par l'ID de compartiment souhaité.

  5. Cliquez sur Créer.

Tâche 3 : création de stratégies OCI IAM

Oracle Cloud Infrastructure Identity and Access Management (OCI IAM) vous permet de contrôler qui a accès à vos ressources cloud. Pour que cette intégration fonctionne, nous devons accorder l'accès aux services Fonction en tant que service (FaaS) (service fonctionnel) au coffre-fort, aux référentiels et à plusieurs autres services.

  1. Dans le menu Services, accédez à Identité et sécurité, à Identité et cliquez sur Stratégies.

  2. Cliquez sur Créer une stratégie.

  3. Entrez le nom et la description appropriés, et veillez à sélectionner le compartiment approprié (dans cet exemple, nous utiliserons le compartiment nommé DEV).

  4. Dans la section Générateur de stratégies, veillez à activer l'option Afficher l'éditeur manuel et à ajouter les lignes suivantes :

    Allow service faas to read repos in tenancy

Allow service faas to read secret-family in compartment DEV

Allow service faas to read vaults in compartment DEV

Allow service faas to use keys in compartment DEV

Allow service faas to use apm-domains in compartment DEV

Allow dynamic-group DGNAME to read secret-family in compartment DEV

Allow dynamic-group DGNAME to read vaults in compartment DEV

Allow dynamic-group DGNAME to use keys in compartment DEV

    Remarque : remplacez le nom du groupe dynamique (DGNAME) et le nom du compartiment (DEV) par les noms souhaités.

  5. Cliquez sur Créer.

Tâche 4 : créer un référentiel pour stocker la fonction

OCI Container Registry vous permet de stocker, de partager et de gérer des images de conteneur (telles que des images Docker) dans un registre géré par Oracle.

  1. Accédez à la console OCI, ouvrez le menu Service et cliquez sur Services de développeur. Sous Conteneurs, cliquez sur registre du conteneur.

  2. Cliquez sur Créer un référentiel.

  3. Dans la boîte de dialogue Créer un référentiel, indiquez le compartiment et le nom du référentiel de votre choix, puis laissez-le privé.

  4. Cliquez sur Créer un référentiel.

Tâche 5 : création d'un coffre pour stocker l'utilisateur et le jeton d'API pour la connexion à Jira Service Management

Oracle Cloud Infrastructure Vault est un service de gestion de clés qui stocke et gère des clés de cryptage maître ainsi que des clés secrètes pour sécuriser l'accès aux ressources.

  1. Ouvrez le menu de service, cliquez sur Identité et sécurité et sur Coffre.

  2. Cliquez sur Créer un coffre.

  3. Dans la boîte de dialogue Créer un coffre, sélectionnez le compartiment de votre choix et entrez le nom approprié. Vous pouvez également choisir si vous voulez le rendre privé ou non.

    Remarque : vous ne pouvez pas modifier le type de coffre après sa création.

  4. Cliquez ensuite sur Créer un coffre.

    Remarque : enregistrez les fichiers api-token et api-user de Jira Service Management séparément dans le coffre.

Tâche 6 : créer une application

  1. Ouvrez le menu de service et cliquez sur Services de développeur. Sous Fonctions, cliquez sur Applications.

  2. Cliquez sur Créer une application.

  3. Dans la fenêtre Créer une application, entrez le nom de l'application (par exemple, Jira-Ticketing), sélectionnez le VCN créé dans Tâche 1 et sélectionnez le sous-réseau public.

  4. Cliquez sur Créer.

Tâche 7 : déployer la fonction

Cette tâche utilise l'archive ZIP qui peut être téléchargée à partir de la section Prérequis.

  1. Sélectionnez l'application que vous venez de créer dans Tâche 6 dans la liste.

  2. Dans les fenêtres Application, suivez les étapes disponibles dans l'option Mise en route sous Ressources.

    Remarque :

    • Dans ce tutoriel, nous utilisons la configuration d'OCI Cloud Shell.

    • A l'étape 4 de la configuration, veillez à indiquer le nom du référentiel créé dans Tâche 4.

  3. Une fois que vous avez cliqué sur Lancer Cloud Shell, une nouvelle petite fenêtre de shell apparaît en bas de la page. Dans le coin supérieur droit de cette fenêtre, cliquez sur le menu de roue dentée et sélectionnez Télécharger.

  4. Glissez-déplacez le fichier jsm-ticket-function.zip qui sera téléchargé dans le répertoire de base.

  5. Décompressez l'archive à l'aide de la commande suivante.

    unzip jsm-ticket-function.zip

  6. Basculez vers le répertoire des fonctions à l'aide de la commande cd jsm-ticket-function et suivez les étapes décrites dans la console OCI.

Tâche 8 : modifier la configuration de la fonction

Les fonctions ont quelques paramètres configurables qui doivent être modifiés pour que la fonction fonctionne correctement.

  1. Dans la console OCI, accédez à l'application créée dans Tâche 6 et sélectionnez Fonctions sur le côté gauche sous Ressources.

  2. Cliquez sur le nom de la fonction jsm-ticket-function.

  3. Cliquez sur Configuration sous Ressources. Vous pouvez voir cinq clés : api-token, api-user, service_desk_id, request_type_id et vault_ocid.

    Toutes ces clés doivent être modifiées avec votre configuration :

    • api-token : nom de la clé secrète du coffre dans lequel est stocké l'api-token du compte utilisateur dont le ticket est créé pour le compte. Pour plus d'informations, reportez-vous à Gestion des jetons d'API pour votre compte Atlassian.

    • api-user : le nom de la clé secrète du coffre était l'adresse électronique de l'utilisateur dont le ticket sera créé pour le compte est stocké.

    • service_desk_id : projet dans lequel le ticket sera créé.

    • request_type_id : type de demande sous lequel le ticket sera créé (il doit avoir un titre et une description).

    • vault_ocid : vault_ocid où les clés secrètes api-token et api-user sont stockées.

    Le moyen simple et rapide d'obtenir service_desk_id et request_type_id consiste à visiter le portail à utiliser et à consulter les URL. Par exemple, accédez à un portail, puis cliquez sur une demande à générer et vous verrez une URL telle que : https://somewhere.atlassian.net/servicedesk/customer/portal/10/group/229/create/664

    Les chiffres sont les suivants :

    • 10 : portail/servicedesk.
    • 229 : groupe par lequel la demande est envoyée (uniquement utilisé par la navigation, cela n'est pas important dans REST).
    • 664 : ID du type de demande sur lequel j'ai cliqué.

Tâche 9 : Abonner la fonction à un sujet

  1. Ouvrez le menu de service et cliquez sur Services de développeur. Sous Intégration d'application, cliquez sur Notifications.

    Remarque : veillez à être dans le compartiment de droite.

  2. Cliquez sur Créer une rubrique.

  3. Entrez un nom approprié et cliquez sur Créer.

  4. Une fois le sujet créé, sélectionnez-le dans la liste des sujets.

  5. Dans la fenêtre Sujets, sélectionnez Abonnements dans la partie gauche sous Ressources et cliquez sur Créer un abonnement.

  6. Dans la fenêtre Créer un abonnement, sélectionnez le protocole à Fonctions, sélectionnez le compartiment, l'application et la fonction créés dans Tâche 6.

  7. Cliquez sur Créer.

Tâche 10 : créer une alarme pour la mesure souhaitée dont vous avez besoin surveillée

Vous pouvez créer plusieurs types d'alarme. Dans ce tutoriel, nous avons choisi une alarme d'absence.

  1. Ouvrez le menu Service et cliquez sur Observation & gestion. Sous Surveillance, cliquez sur Définitions d'alarme.

  2. Cliquez sur Créer une alarme.

  3. Sur la page Créer une alerte, sous Définir une alerte, entrez ou mettez à jour les paramètres d'alarme.

  4. Sous Définir des notifications d'alarme, veillez à sélectionner le sujet créé dans Tâche 9.

  5. Sélectionnez le Format de message comme Envoyer des messages JSON lisibles (texte brut avec des sauts de ligne).

  6. Cliquez sur Enregistrer l'alarme.

Remerciements

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à d'autres contenus de formation gratuits sur le canal Oracle Learning YouTube. De plus, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation produit, consultez le site Oracle Help Center.