Créez votre propre workflow

Créez des workflows personnalisés à partir de zéro lorsque les modèles ne répondent pas à vos besoins. Utilisez le générateur créez le vôtre pour glisser-déposer des actions du catalogue d'actions dans une automatisation qui correspond à votre processus.

Comment utiliser ce guide

Ce guide vous montre comment construire un workflow à l'aide de concepts et d'un exemple complet. Choisissez votre parcours d'apprentissage :

• Apprenez d'abord les concepts fondamentaux: Lisez Concepts fondamentaux et modèles de workflow pour comprendre les bases, puis appliquez-les
• Suivez l'exemple: Accédez à Procédure pas à pas de l'exemple pour créer un workflow de redimensionnement automatique EC2 étape par étape
• Modèles de référence: Utilisez la section modèles de workflow comme référence rapide lors de la création de vos propres workflows

Pourquoi créer un workflow personnalisé ?

Créez votre propre workflow pour :

• Implémenter une logique métier unique que les modèles ne prennent pas en charge
• Intégrez plusieurs systèmes au-delà des modèles standards
• Gérer les décisions complexes grâce à la branchement conditionnel
• Alignez vos processus d'approbation et de notification avec ceux de votre équipe.

Concepts de base

Comprenez ces principes fondamentaux avant de construire :

Exemples de syntaxe

Utilisez ces modèles lors de la création de workflows :

Pour des modèles détaillés de gestion des erreurs, consultez les Bonnes pratiques.

Démarrage rapide

Créez votre premier workflow en cinq étapes :

1. Accédez à one.newrelic.com > All Capabilities > Workflow Automation et sélectionnez Create Your Own
2. Définir les paramètres pour les identifiants (depuis le gestionnaire de secrets: ${{ :secrets:keyName }}), la configuration (régions, types d'instance) et les données d'exécution (ID de compte, ID d'alerte)
3. Faites glisser des actions depuis le catalogue, connectez-les avec la syntaxe ${{ .steps.stepName.outputs.field }} pour transmettre des données
4. Insérez des commutateurs pour le branchement conditionnel, des boucles pour le traitement de listes ou l'interrogation, des portes d'approbation pour les décisions humaines
5. Exécutez après chaque section pour détecter les erreurs rapidement, puis démarrez ou planifiez votre workflow

Modèles workflow clés

Quatre modèles essentiels couvrent la plupart des scénarios d'automatisation. Chaque modèle est illustré dans l'exemple détaillé ci-dessous.

Branchement conditionnel avec commutateurs

Utilisez des commutateurs lorsque : les résultats varient en fonction des données (vérifications de seuil, réponses d’API, décisions de l’utilisateur).

Syntaxe clé :

- name: hasCompleted
    type: switch
    switch:
      - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}"
        next: displayError
      - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}"
        next: displaySuccess
    next: displayUnexpected  # Default path when no condition matches

Exemple : Gérer la réponse de l'équipe, Vérifier et nettoyer

Boucles pour le traitement des listes

Utilisez les boucles lorsque vous traitez plusieurs éléments ou répétez des actions.

Pour des informations détaillées sur la structure des boucles, les paramètres et l'utilisation avancée (y compris break/continue), consultez Structure de la boucle.

Syntaxe clé :

# Send progress updates using range loop
  - name: progressLoop
    type: loop
    for:
      in: "${{ [range(1; 5)] }}"  # Loop 5 times
      steps:
        - name: wait
          type: wait
          seconds: 10
        - name: progressMessage
          type: action
          action: slack.chat.postMessage
          version: 1
          inputs:
            channel: "${{ .workflowInputs.channel }}"
            text: "Resizing in progress..."

Exemple : Exécuter le redimensionnement

Portails d'approbation et attente

Utilisez les portes d'approbation lorsque : Un jugement humain est nécessaire avant les opérations destructrices ou une validation de conformité est requise

Syntaxe clé :

- name: requestApproval
    type: action
    action: slack.chat.postMessage
    version: 1
    inputs:
      channel: "#approvals"
      text: "Approve? React with :thumbsup: or :thumbsdown:"

  - name: getReactions
    type: action
    action: slack.chat.getReactions
    version: 1
    inputs:
      token: "${{ .workflowInputs.slackToken }}"
      channelID: "${{ .steps.requestApproval.outputs.channelID }}"
      threadTs: "${{ .steps.requestApproval.outputs.threadTs }}"
      timeout: 300  # Wait 5 minutes for reaction

  - name: checkApproval
    type: switch
    switch:
      - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}'
        next: handleApproval
      - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}'
        next: handleRejection

Pour les retards simples :

- name: waitBeforeRetry
    type: wait
    seconds: 60  # Wait 60 seconds before continuing

Exemple : Demander l'approbation de l'équipe

Transmission de données entre les étapes

Utilisez le passage de données lorsque : la sortie d'une étape devient l'entrée d'une autre (la base de tout workflow).

Syntaxe clé :

# Reference previous step outputs
  awsRegion: "${{ .inputs.region }}"
  instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}"

Exemple : Toutes les étapes du workflow

Affectation de variables avec assign

Le type d'étape d'affectation vous permet d'initialiser et d'affecter des valeurs à des variables qui peuvent être utilisées dans les étapes de workflow suivantes. Cette étape prend en charge plusieurs types de données, notamment les chaînes, les entiers, les booléens, les cartes (objets) et les listes (tableaux).

Structure de base :

- name: <step_name>
    type: assign
    inputs:
      <variable_name>: <value_or_expression>

Exemple:

- name: variableInitialization
    type: assign
    inputs:
      stringVar: "${{ .workflowInputs.initialValue }}"
      intVar: "${{ .workflowInputs.anotherValue }}"
      concatenationVar: "${{ .workflowInputs.initialValue }} - concatenated"
      booleanVar: true
      mapVar:
        key1: "value1"
        key2: "${{ .workflowInputs.initialValue }}"
      listVar:
        - "listItem1"
        - "${{ .workflowInputs.initialValue }}"
        - "${{ .workflowInputs.anotherValue }}"
      statusCode: ${{ .steps.runAction.outputs.statusCode }}

Exemple de procédure pas à pas : redimensionnement automatique des instances EC2 avec approbation

Cet exemple crée un workflow qui redimensionne les instances EC2 en cas de pic d'utilisation du CPU, après avoir obtenu l'approbation de l'équipe via Slack. Il démontre la collecte de données, la logique conditionnelle, les intégrations externes et la gestion des erreurs.

aperçu du flux de travail

Flux de haut niveau :

1. Collecte de données: Récupérer les détails de l'alerte et de l'instance auprès de New Relic
2. Demande d'approbation: Envoyer un message Slack, attendre la réponse de l'équipe
3. Exécuter le redimensionnement: Utilisez AWS Systems Manager pour redimensionner instanceEC2.
4. Vérification et nettoyage: Vérifier les résultats, informer l'équipe, supprimer les ressources temporaires

Prérequis

Avant de mettre en place ce workflow, assurez-vous d'avoir :

• AWS: Identifiants avec autorisations EC2 et système Manager
• Slack: Bot Jeton et canal de notification
• New Relic: état d'alerte monitoring du processeur EC2
• Gestionnaire de secrets: Configuré, voir gestionnaire de secrets

Élaborez le workflow étape par étape

Construisez chaque partie du workflow. Chaque étape comprend des actions spécifiques et illustre des modèles de workflow.

Référence complète des paramètres

Ce workflow nécessite des identifiants, une configuration et un contexte d'exécution en entrée. Les valeurs sensibles proviennent du gestionnaire de secrets en utilisant la syntaxe ${{ :secrets:keyName }}.

Catégories d'entrée :

• Authentification: identifiants AWS et Slack
• Contexte de l'alerte: ID du compte et ID du problème provenant de New Relic
• Configuration: Région, type d'instance, fuseau horaire, canal Slack

Prochaines étapes

Après avoir terminé cet exemple, consultez ces ressources :