Note :

Utiliser le service des fonctions pour OCI et Python pour ouvrir des tickets dans Jira Service Management

Présentation

Le tutoriel suivant s'adresse aux utilisateurs d'Oracle Cloud Infrastructure (OCI) qui utilisent à la fois le service de surveillance OCI et Jira Service Management pour ouvrir des tickets et suivre les incidents. Supposons que vous ayez une instance OCI et que vous vouliez 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. À l'aide du service des fonctions pour OCI, les tickets peuvent être automatiquement ouverts dans Jira Service Management lorsque des problèmes sont détectés dans vos systèmes d'organisation.

Objectifs

Préalables

Tâche 1 : Créer un réseau en nuage virtuel

Un réseau en nuage 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 des services dans le coin supérieur gauche de la console OCI.

  2. Sous Réseaux, sélectionnez Réseaux en nuage virtuels.

  3. Dans la page Réseaux en nuage virtuels, cliquez sur Démarrer l'Assistant VCN.

  4. Sélectionnez Créer un VCN avec 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 de calcul OCI en tant qu'acteurs principaux (comme les groupes d'utilisateurs).

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

  1. Dans le menu des services, naviguez jusqu'à 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 significatifs.

  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'}

    Note : Remplacez l'ID compartiment par l'ID de compartiment souhaité.

  5. Cliquez sur Créer.

Tâche 3 : Créer des politiques IAM pour OCI

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

  1. Dans le menu des services, naviguez jusqu'à Identité et sécurité, Identité et cliquez sur Politiques.

  2. Cliquez sur Créer une politique.

  3. Entrez un nom et une description appropriés et assurez-vous de sélectionner le compartiment approprié (dans cet exemple, nous utiliserons le compartiment nommé DEV).

  4. Dans la section Générateur de politiques, assurez-vous d'activer Afficher l'éditeur manuel et d'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

    Note : Remplacez le nom du groupe dynamique (DGNAME) et le nom du compartiment (DEV) par les noms de votre choix.

  5. Cliquez sur Créer.

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

Le service de registre de conteneurs pour OCI permet de stocker, de partager et de gérer des images de conteneurs (comme des images Docker) dans un registre géré par Oracle.

  1. Allez à la console OCI, ouvrez le menu du service et cliquez sur Services de développement. Sous Conteneurs, cliquez sur Container Registry.

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

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

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

Tâche 5 : Créer une chambre forte 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 les clés principales de chiffrement et les clés secrètes pour un accès sécurisé aux ressources.

  1. Ouvrez le menu du service, cliquez sur Identité et sécurité et sur Chambre forte.

  2. Cliquez sur Créer une chambre forte.

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

    Note : Vous ne pouvez pas modifier le type de chambre forte après la création de la chambre forte.

  4. Lorsque vous avez terminé, cliquez sur Créer une chambre forte.

    Note : Enregistrez les fichiers Jira Service Management api-token et api-user séparément dans la chambre forte.

Tâche 6 : Créer une application

  1. Ouvrez le menu du service et cliquez sur Services de développement. 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 la 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 utilisera l'archive zip qui peut être téléchargée à partir de la section Préalables.

  1. Sélectionnez la nouvelle application dans Tâche 6 dans la liste.

  2. Dans la fenêtre Application, suivez les étapes disponibles dans l'option Démarrage sous Ressources.

    Note :

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

    • À l'étape 4 de la configuration, assurez-vous de spécifier le nom du référentiel créé dans la tâche 4.

  3. Lorsque vous cliquez sur Lancer Cloud Shell, une nouvelle petite fenêtre d'interpréteur de commandes s'affiche au bas de la page. Dans le coin supérieur droit de cette fenêtre, cliquez sur le menu roue dentée et sélectionnez Charger

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

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

    unzip jsm-ticket-function.zip

  6. Passez au 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, allez à l'application créée dans la tâche 6 et sélectionnez Fonctions dans le côté gauche sous Ressources.

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

  3. Cliquez sur Configuration sous Ressources. Vous pourrez 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 de la chambre forte où est stocké l'api-token du compte d'utilisateur pour lequel le ticket est créé. Pour plus d'informations, voir Gérer les jetons d'API pour votre compte Atlassian.

    • api-user : Le nom de la clé secrète de la chambre forte était l'adresse de courriel 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 les adresses service_desk_id et request_type_id consiste à visiter le portail que vous voulez utiliser et à consulter les URL. Par exemple, allez à un portail et cliquez sur une demande à soulever et vous verrez une URL comme : https://somewhere.atlassian.net/servicedesk/customer/portal/10/group/229/create/664

    Les chiffres sont :

    • 10 : Portail/servicedesk.
    • 229 : Groupe d'arrivée de la demande (utilisé uniquement par la navigation, cela ne vous dérange pas 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 du service et cliquez sur Services de développement. Sous Intégration d'applications, cliquez sur Avis.

    Note : Assurez-vous d'être dans le compartiment approprié.

  2. Cliquez sur Créer un sujet.

  3. Entrez le 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, puis 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 la 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 du service et cliquez sur Observabilité et gestion. Sous Surveillance, cliquez sur Définition d'alarmes.

  2. Cliquez sur Créer une alarme.

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

  4. Sous Définir des avis d'alarme, assurez-vous de sélectionner le sujet créé dans la tâche 9.

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

  6. Cliquez sur Enregistrer l'alarme.

Confirmation

Autres ressources d'apprentissage

Explorez d'autres laboratoires sur la page docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal YouTube d'Oracle Learning. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir de la documentation sur le produit, visitez Oracle Help Center.