Crea tu propio flujo de trabajo

Cree flujos de trabajo personalizados desde cero cuando las plantillas no satisfagan sus necesidades. Utilice el generador crear su propio para arrastrar y soltar acciones del catálogo de acciones en una automatización que se adapte a su proceso.

Cómo usar esta guía

Esta guía te muestra cómo construir un flujo de trabajo empleando conceptos y un ejemplo completo. Elige tu ruta de aprendizaje:

• Aprenda primero los conceptos básicos: Lea Conceptos básicos y patrones de flujo de trabajo para comprender los fundamentos, luego aplíquelos
• Siga el ejemplo: Vaya al tutorial de ejemplo para crear un flujo de trabajo de cambio de tamaño automático de EC2 paso a paso
• Patrones de referencia: Utilice la sección de patrones de flujo de trabajo como referencia rápida al crear sus propios flujos de trabajo

¿Por qué crear un flujo de trabajo personalizado?

Crea tu propio flujo de trabajo para:

• Implemente una lógica de negocio única que las plantillas no admitan.
• Integrar múltiples sistemas más allá de las plantillas estándar
• Gestionar decisiones complejas con ramificación condicional
• Adapta el proceso de aprobación y notificación a las necesidades de tu equipo.

Conceptos básicos

Comprenda estos fundamentos antes de construir:

Ejemplos de sintaxis

Use estos patrones al crear flujos de trabajo:

Para obtener patrones detallados de manejo de errores, consulte Mejores prácticas.

Inicio rápido

Crea tu primer flujo de trabajo en cinco pasos:

1. Navegue a one.newrelic.com > All Capabilities > Workflow Automation y seleccione Create Your Own
2. Defina parámetros para credenciales (del administrador de secretos: ${{ :secrets:keyName }}), configuración (regiones, tipos de instancia) y datos de tiempo de ejecución (ID de cuenta, ID de alerta)
3. Arrastre acciones desde el catálogo, conéctelas con la sintaxis ${{ .steps.stepName.outputs.field }} para pasar datos
4. Inserte conmutadores para ramificación condicional, bucles para procesar listas o sondeos, puertas de aprobación para decisiones humanas
5. Ejecuta después de cada sección para detectar errores a tiempo, luego inicia o programa tu flujo de trabajo

Patrones clave del flujo de trabajo

Cuatro patrones esenciales manejan la mayoría de los escenarios de automatización. Cada patrón se demuestra en el recorrido de ejemplo a continuación.

Ramificación condicional con interruptores

Emplee interruptores cuando: Los resultados varíen en función de los datos (comprobaciones de umbral, respuestas de la API, decisiones del usuario).

Sintaxis clave:

- 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

Ejemplo: Gestionar la respuesta del equipo, Verificar y limpiar

Bucles para procesar listas

Emplee bucles cuando: procese varios elementos o repita acciones.

Para obtener información detallada sobre la estructura de bucles, los parámetros y el uso avanzado (incluidos break/continue), consulte Estructura de bucles.

Sintaxis clave:

# 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..."

Ejemplo: Ejecutar el cambio de tamaño

Puertas de aprobación y espera

Emplee puertas de aprobación cuando: Se necesita el juicio humano antes de realizar operaciones destructivas o se requiere la aprobación de cumplimiento

Sintaxis clave:

- 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

Para retrasos simples:

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

Ejemplo: Solicitar aprobación del equipo

Pasar datos entre pasos

Emplee el paso de datos cuando: La salida de un paso se convierte en la entrada de otro (la base de todo flujo de trabajo).

Sintaxis clave:

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

Ejemplo: Todos los pasos del flujo de trabajo

Asignación de variables con asignar

El tipo de paso de asignación le permite inicializar y asignar valores a variables que se pueden usar en los pasos posteriores del flujo de trabajo. Este paso admite múltiples tipos de datos, incluidos cadenas, enteros, booleanos, mapas (objetos) y listas (matrices).

Estructura básica:

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

Ejemplo:

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

Ejemplo práctico: Redimensionamiento automático de EC2 con aprobación

Este ejemplo crea un flujo de trabajo que redimensiona instancias EC2 cuando hay picos de CPU, después de obtener la aprobación del equipo a través de Slack. Demuestra la recopilación de datos, la lógica condicional, las integraciones externas y el manejo de errores.

Descripción general del flujo de trabajo

Flujo de alto nivel:

1. Recopilar datos: Obtener detalles de alertas e instancias de New Relic
2. Aplicar aprobación: Enviar mensaje por Slack, esperar respuesta del equipo
3. Ejecutar cambio de tamaño: Emplee AWS Systems Manager para cambiar el tamaño de las instancias EC2.
4. Verificar y limpiar: Comprobar los resultados, notificar al equipo, eliminar los recursos temporales.

Requisitos previos

Antes de crear este flujo de trabajo, cerciorar de tener lo siguiente:

• AWS: Credenciales con licencias de EC2 y Systems Manager
• Slack: token de bot y canal de notificación
• New Relic: condición de alerta monitoreo CPU EC2
• Gestor de secretos: Configurado, consulte gestor de secretos

Crea el flujo de trabajo paso a paso

Construya cada parte del flujo de trabajo. Cada paso incluye acciones específicas y demuestra patrones de flujo de trabajo.

Referencia completa de parámetros

Este flujo de trabajo requiere credenciales, configuración y contexto de tiempo de ejecución como entradas. Los valores sensibles provienen del administrador de secretos usando la sintaxis ${{ :secrets:keyName }}.

Categorías de entrada:

• Autenticación: credenciales de AWS y Slack
• Contexto de la alerta: ID de cuenta e ID de incidencia de New Relic
• Configuración: Región, tipo de instancia, zona horaria, canal Slack

Próximos pasos

Después de completar este ejemplo, explore estos recursos: