Crea tu propio flujo de trabajo

Cuando las plantillas no se ajustan a tus necesidades, Crea la tuya propia te permite crear un flujo de trabajo personalizado. Emplee la interfaz de arrastrar y soltar para encadenar acciones del catálogo de acciones en una automatización que se ajuste 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:

• Primero aprende los conceptos básicos → Lee los conceptos básicos y los patrones de flujo de trabajo para comprender los fundamentos y luego aplícalos.

• Siga el ejemplo → Vaya al tutorial del ejemplo para crear paso a paso un flujo de trabajo de redimensionamiento automático de EC2

• Patrones de referencia → Emplee la sección de patrones de flujo de trabajo como referencia rápida al crear su propio flujo de trabajo.

  Sugerencia

  ¿Eres nuevo en el flujo de trabajo? Empieza por los conceptos básicos y luego sigue el ejemplo. El flujo de trabajo de EC2 demuestra todos los patrones clave en un escenario del mundo real.

¿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:

Para conocer 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 el parámetro para las credenciales (del administrador de secretos: ${{ :secrets:keyName }}), configuración (regiones, tipo de instancia) y datos de tiempo de ejecución (ID de cuenta, ID de alerta)
3. Arrastra acciones del catálogo y conéctalas con la sintaxis ${{ .steps.stepName.outputs.field }} para pasar datos.
4. Inserte interruptores para bifurcación condicional, bucles para procesar listas o realizar sondeos, y puertas de aprobación para decisiones humanas.
5. Correr el programa luego de cada sección para detectar errores a tiempo y, a continuación, inicia o programa tu flujo de trabajo.

Patrones clave del flujo de trabajo

Cuatro patrones esenciales permiten gestionar la mayoría de los escenarios de automatización. Cada patrón se muestra en el 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

Véalo en acción: las secciones "Gestionar la respuesta del equipo" y "Verificar y limpiar" muestran el enrutamiento de los conmutadores en función de las reacciones de Slack y el estado de AWS SSM.

Bucles para procesar listas

Emplee bucles cuando: procese varios elementos o repita acciones.

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

Véalo en acción: Ejecute la sección de redimensionamiento que emplea progressLoop para las actualizaciones de estado.

Puertas de aprobación y espera

Emplee puntos de aprobación cuando: se requiera criterio humano antes de operaciones destructivas o se necesite 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

Véalo en acción: La sección de solicitud de aprobación del equipo implementa el flujo de trabajo completo de aprobación de Slack.

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

Véalo en acción: Todas las secciones demuestran la transferencia de datos; cada paso se basa en los resultados anteriores.

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

Este ejemplo completo muestra cómo crear un flujo de trabajo que redimensione automáticamente las instancias EC2 cuando se produzcan picos de uso de CPU, tras obtener la aprobación del equipo a través de Slack. Muestra la recopilación de datos, la lógica condicional, la integración externa y el manejo de errores en un escenario del mundo real.

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 (ver gestión de secretos)

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.

Este ejemplo muestra patrones clave que empleará en un flujo de trabajo personalizado: consultas a API, ramificación condicional, integración externa, bucles de sondeo y manejo de errores.

Entradas del flujo de trabajo

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

Categorías de entrada:

• Autenticación: credenciales de AWS y Slack del administrador de secretos
• 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

Crea el flujo de trabajo paso a paso

Ahora vamos a construir cada parte del flujo de trabajo. Cada paso incluye las acciones específicas que se deben agregar y los patrones de flujo de trabajo que demuestran.

Próximos pasos

Ejecutar y gestionar

• Iniciar y programar el flujo de trabajo: Activar manualmente o programar automáticamente.
• Gestionar el flujo de trabajo: editar, versionar, clonar o desactivar el flujo de trabajo.

Mejorar

• mejores prácticas: Manejo de errores, gestión de secretos, rendimiento, testing.
• Catálogo de acciones: AWS, Azure, GCP, HTTP, transformaciones de datos.
• Ejemplos de flujo de trabajo: más escenarios de automatización del mundo real.

Escala

• flujo de trabajo API de automatización: desplegar vía API para infraestructura como código.
• Límites del flujo de trabajo: Tiempos de espera, límites de acciones, restricciones de carga útil.