Analyse automatique

Analyse automatique remplace l'export à la main : une tâche que vous exécutez lit vos flux avec votre propre jeton d'API Atlassian, remplace chaque texte par un marqueur, et les envoie, par morceaux, à votre application TuneCraft, qui s'exécute dans le cloud d'Atlassian. Les administrateurs Jira la configurent sur la page Analyse, et Plugincraft ne reçoit jamais les flux.

Où le trouver

Où vont les données

La tâche s'exécute là où vous la mettez en place : votre propre machine, votre planificateur ou votre CI, ou, pour le programme d'envoi ScriptRunner, une tâche planifiée dans une application d'un autre éditeur que votre site a installée. Elle n'appelle que trois endroits : votre propre site Jira, l'API d'Atlassian, et l'adresse de réception de votre application TuneCraft. La tâche ne fait que lire vos flux et ne change aucun flux ni réglage dans Jira. Tout ce que l'application reçoit est traité dans le cloud d'Atlassian.

• La tâche remplace chaque texte par un marqueur avant d'envoyer quoi que ce soit, avec les mêmes règles que la page Analyse. L'application revérifie chaque flux et refuse tout l'envoi si l'un contient encore un texte.
• Votre jeton d'API n'atteint jamais l'application ni Plugincraft. La tâche ne l'utilise que pour appeler Atlassian. Avec le programme d'envoi ScriptRunner, le jeton est conservé dans les Script Variables de cette application.
• La clé que vous créez sur la page Analyse est autre chose : elle permet à la tâche d'envoyer à votre application. TuneCraft l'affiche une fois et n'en conserve qu'une empreinte.
• La seule chose que la tâche ScriptRunner écrit est une propriété utilisateur Jira, tunecraft-scan (des compteurs et un curseur, aucun texte de flux), sur le compte qui l'exécute, pour qu'un grand site soit envoyé en plusieurs exécutions. La tâche l'efface quand un envoi est terminé.

Configurer un programme d'envoi

Étape 1 : créer une clé

Ouvrez Analyse, trouvez Analyse automatique et choisissez Créer une clé. Copiez la clé maintenant.

Important : La clé n'est affichée qu'une fois. Si vous la perdez, choisissez Remplacer la clé : l'ancienne clé cesse de fonctionner aussitôt, donc mettez à jour chaque tâche qui l'utilise.

Étape 2 : choisir un programme d'envoi

Sous Configurer un programme d'envoi, choisissez-en un : Node.js, PowerShell, Python ou ScriptRunner. La section suivante dit ce que chacun envoie. Pour ScriptRunner, suivez les sept étapes de sa carte, décrites plus bas, au lieu des étapes 3 à 7.

Étape 3 : télécharger le fichier

Téléchargez le fichier et placez-le là où la tâche s'exécute.

Étape 4 : définir les cinq réglages

Définissez cinq réglages dans l'environnement : ATLASSIAN_SITE (l'adresse de votre site, celle de votre adresse web Jira), ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN, TUNECRAFT_URL (l'Adresse du récepteur) et TUNECRAFT_KEY (la clé). Créez le jeton sur la page des jetons d'Atlassian : personne ne peut en créer un pour vous.

Important : Gardez les réglages dans le coffre à secrets de votre planificateur, jamais dans un fichier sous contrôle de version.

Étape 5 : lancer à blanc

Lancez le programme d'envoi à blanc. Il lit et masque vos flux, affiche des totaux et n'envoie rien.

Étape 6 : le lancer pour de bon

Lancez-le de nouveau sans l'essai à blanc. La carte affiche l'envoi à son arrivée, sous Dernier envoi.

Étape 7 : le planifier

Lancez-le chaque jour. N'importe quel planificateur que vous utilisez déjà peut démarrer le programme d'envoi, et la carte donne des exemples.

Pour arrêter l'analyse automatique aussitôt, choisissez Désactiver. La clé cesse de fonctionner et aucun envoi n'est accepté. Les analyses déjà enregistrées restent.

Les quatre programmes d'envoi et ce que chacun envoie

Chaque programme d'envoi lit chaque flux en entier, remplace ses textes là où il s'exécute (sur votre machine, votre planificateur ou votre CI, ou, pour ScriptRunner, dans cette application d'un autre éditeur), et envoie ses étapes avec chaque texte remplacé, par morceaux, avec un résumé de chaque flux. Trois d'entre eux envoient aussi ce dont les vérifications au-delà des résumés ont besoin : ce que vos flux nomment (par l'identifiant de Jira ou par un code à clé du nom, jamais le nom), les totaux des identifiants, adresses et requêtes web, et les identifiants de compte que les étapes nomment. Ces textes se trouvent dans le vrai texte de chaque flux, là où le programme d'envoi s'exécute. Chacun a un essai à blanc qui n'envoie rien.

Le programme d'envoi ScriptRunner

• La carte a sept étapes numérotées, chacune avec une case à cocher, et un dessin de l'endroit où cliquer quand une étape en a besoin. Gardez la carte ouverte dans un onglet et utilisez Jira dans un second.
• Un essai à blanc dans cette application prend environ 2 minutes.
• La tâche s'arrête après 240 secondes : le script arrête de lire à 180 secondes, envoie ce qu'il a et reprend à l'exécution suivante, donc un grand site est envoyé en plusieurs exécutions.
• Une tâche n'est conservée que si vous appuyez sur Save dans cette application.
• La carte n'affiche aucune tâche à copier tant qu'aucune clé n'est dans la page, car une clé n'est affichée qu'une fois. Si votre tâche s'exécute déjà, vous n'avez rien à faire et vous ne devez pas remplacer la clé.

Ce qu'un programme d'envoi de résumés seulement laisse de côté

Avec PowerShell, une analyse ne conserve aucune étape de flux, aucun total et aucune trace de ce que vos flux nomment. Vérifier avant de supprimer, Gouvernance et Flux cassés utilisent donc la dernière analyse antérieure qui les contenait et disent sa date, jusqu'à l'arrivée d'une analyse plus récente qui les contient. Un envoi qui ne conserve aucune référence ne remplace jamais celles d'une analyse antérieure. Ce que contient cette analyse dit, pour chaque partie, Conservé ou Non conservé. Si une analyse contient moins qu'elle ne pourrait, la carte dit quels programmes d'envoi envoient tout.

Ce qu'aucun programme d'envoi ne peut faire

• Aucun programme d'envoi n'envoie le vrai texte de vos flux, et aucun ne vérifie votre JQL. Optimiser, Corrigez avec moi et les vérifications du JQL ont toujours besoin de votre export sur la page Analyse.
• La page Carte, les dépendances, les boucles et les flux qu'un autre flux ne peut pas démarrer sont calculés à partir des étapes avec chaque texte remplacé, que chaque programme d'envoi envoie. Ils peuvent différer d'une analyse de votre export : une étape qui définit des champs par les champs avancés (JSON) compte comme pouvant changer n'importe quel champ, et un nom de champ dans une autre casse ne correspond pas. Une analyse de votre export donne la réponse exacte.
• Un site accepte jusqu'à 6 envois par jour (UTC), une limite fixe. Les flux qu'un programme d'envoi ne peut pas envoyer sont comptés et laissés de côté. Un envoi de nombreux flux est enregistré en plusieurs passes, en arrière-plan.

Garder un œil dessus

• Dernier envoi montre quand il est arrivé, combien de flux ont été enregistrés et ce qui a été laissé de côté. Un envoi refusé dit pourquoi et quoi faire : par exemple « Refusé : un flux contenait encore un texte. Mettez le programme d'envoi à jour et relancez-le. »
• Attendre un envoi au moins tous les propose 1 jour, 2 jours ou 7 jours. Quand aucun envoi n'a été enregistré depuis plus longtemps que cela, plus 6 heures, la carte dit L'analyse automatique est en retard. Si l'option « Utilisation de l'automatisation » est cochée sur la page Alertes, TuneCraft crée aussi un ticket Jira par période de retard.
• Le calendrier est tenu par votre programme d'envoi, pas par TuneCraft. Pour envoyer plus ou moins souvent, changez le calendrier là où il s'exécute.

Ce que cela change dans Jira et comment l'annuler

La tâche ne change aucun flux ni réglage dans Jira. Deux choses écrivent dans Jira : l'alerte d'un envoi en retard, qui vient de TuneCraft et seulement si un administrateur Jira l'a activée, et l'unique propriété utilisateur de la tâche ScriptRunner.

Pages liées

• Automatisation : la page Analyse, les constats et les économies.
• Confidentialité et données : ce qui quitte votre navigateur et ce qui est conservé.
• Tâches en arrière-plan : les envois et le compte du jour.

Des questions sur l’application? Écrivez à info@plugincraft.ca.