Skip to main content
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Prepárese para usar los flujos de trabajo

Colaboradores

Debe estar familiarizado con la organización y el formato de los flujos de trabajo de Astra antes de utilizarlos con una implementación en directo.

Introducción

Un Workflow es una secuencia de uno o más pasos necesarios para llevar a cabo una tarea o un objetivo administrativos específicos. Cada paso de un flujo de trabajo de Astra Control es uno de los siguientes:

  • Llamada a API REST (con detalles como ejemplos curl y JSON)

  • Invocación de otro flujo de trabajo de Astra

  • Tareas relacionadas varias (como tomar una decisión de diseño necesaria)

Los flujos de trabajo incluyen los pasos principales y los parámetros necesarios para realizar cada tarea. Proporcionan un punto de partida para personalizar el entorno de automatización.

Nota Un flujo de trabajo sólo puede contener un paso. Estos flujos de trabajo de un solo paso tienen un formato ligeramente diferente al de los flujos de trabajo que contienen varios pasos. Por ejemplo, se elimina el nombre explícito del paso. La acción u operación debe ser clara en función del título del flujo de trabajo.

Categorías de flujo de trabajo

Existen dos amplias categorías de flujos de trabajo de Astra disponibles en función de su modelo de puesta en marcha. Si utiliza Astra Control Center, debería empezar con los flujos de trabajo de la infraestructura y, a continuación, proceder a los flujos de trabajo de gestión. Cuando utilice Astra Control Service, normalmente puede dirigirse directamente a los flujos de trabajo de gestión.

Nota Los ejemplos de cURL de los flujos de trabajo utilizan la URL para Astra Control Service. Debe cambiar la dirección URL cuando utilice el Centro de control Astra de las instalaciones según sea necesario para su entorno.

Flujos de trabajo de infraestructura

Estos flujos de trabajo hacen frente a la infraestructura Astra, que incluye credenciales, bloques y back-ends. Se necesitan con Astra Control Center, pero en la mayoría de los casos también se pueden utilizar con Astra Control Service. Los flujos de trabajo se centran en las tareas necesarias para establecer y mantener un clúster gestionado por Astra.

Flujos de trabajo de gestión

Puede usar estos flujos de trabajo después de configurar un clúster gestionado. Los flujos de trabajo de gestión se centran en la protección de las aplicaciones y en operaciones de soporte, como la realización de backups, la restauración y el clonado de una aplicación.

Parámetros de entrada comunes

Los parámetros de entrada descritos a continuación son comunes a todas las muestras de curl utilizadas para ilustrar una llamada a la API DE REST.

Nota Debido a que estos parámetros de entrada son universalmente necesarios, no se describen más adelante en los flujos de trabajo individuales. Si se utilizan parámetros de entrada adicionales para un ejemplo de rizo específico, se describen en la sección parámetros de entrada adicionales.

Parámetros de ruta

La ruta de extremo utilizada con cada llamada de API DE REST incluye los siguientes parámetros. Consulte también "Formato de URL" si quiere más información.

ID de cuenta

Este es el valor UUIDv4 que identifica la cuenta Astra en la que se ejecuta la operación API. Consulte "Obtenga un token de API" Para obtener más información acerca de cómo localizar su ID de cuenta.

Solicitar encabezados

Existen varios encabezados de solicitud que puede necesitar incluir en función de la llamada a la API DE REST.

Autorización

Todas las llamadas API de los flujos de trabajo necesitan un token de API para identificar al usuario. Debe incluir el token en el Authorization solicite el encabezado. Consulte "Obtenga un token de API" Para obtener más información acerca de la generación de un token de API.

Tipo de contenido

Con LA POST HTTP y LAS peticiones DE PONER donde JSON está incluido en el cuerpo de la solicitud, debe declarar el tipo de medio basado en el recurso Astra. Por ejemplo, puede incluir el encabezado Content-Type: application/astra-appSnap+json al crear una instantánea para una aplicación administrada.

Acepte

Puede declarar el tipo de medio específico del contenido que espera en la respuesta en función del recurso Astra. Por ejemplo, puede incluir el encabezado Accept: application/astra-appBackup+json al enumerar los backups de una aplicación gestionada. Sin embargo, para mayor simplicidad, las muestras curl de los flujos de trabajo aceptan todos los tipos de medios.

Presentación de tokens e identificadores

El token de la API y otros valores de ID utilizados con los ejemplos curl son opacos sin significado discernible. Para mejorar la legibilidad de las muestras, no se utilizan los valores de identificador y token reales. Más bien, se utilizan palabras clave reservadas más pequeñas que tiene varias ventajas:

  • Las muestras curl y JSON son más claras y fáciles de entender.

  • Puesto que todas las palabras clave utilizan el mismo formato con corchetes y letras mayúsculas, puede identificar rápidamente la ubicación y el contenido que se debe insertar o extraer.

  • No se pierde ningún valor porque los parámetros originales no se pueden copiar y utilizar con una implementación real.

Las variables se formatean para su uso en un entorno de shell Bash. Cada variable comienza con un signo de dólar y está encerrada entre comillas dobles según sea necesario. Esto los hace reconocibles a Bash. Las mayúsculas se utilizan sistemáticamente para los nombres.

Aquí están algunas de las palabras clave reservadas comunes usadas en los ejemplos curl. Esta lista no es exhaustiva y se utilizan palabras clave adicionales según sea necesario. Su significado debe ser obvio basado en el contexto.

Palabra clave Tipo Descripción

$ACCOUNT_ID

Ruta

El valor UUIDv4 que identifica la cuenta en la que se ejecuta la operación API.

$API_TOKEN

Encabezado

El token del portador identifica y autoriza al llamante.

$APP_ID

Ruta

El valor UUIDv4 que identifica la aplicación para la llamada API.

Usando los ejemplos con Bash

Si utiliza los ejemplos de cURL de flujo de trabajo directamente, debe actualizar las variables que contienen con los valores adecuados para su entorno. Puede editar manualmente los ejemplos o confiar en el shell Bash para realizar la sustitución por usted, como se describe a continuación.

Nota Una ventaja del uso de Bash es que puede establecer los valores de variable una vez en una sesión de shell en lugar de una vez por comando cURL.
Pasos

  1. Abra el shell Bash proporcionado con Linux o un sistema operativo similar.

  2. Establezca los valores de variable incluidos en el ejemplo de cURL que desea ejecutar. Por ejemplo:

    $API_TOKEN=SGgpXHeco6M8PLxzIlgbztA4k3_eX4UCa842hOXHBFA=

  3. Copie el ejemplo cURL de la página de flujo de trabajo y péguelo en el terminal del shell.

  4. Presione ENTER para realizar las siguientes tareas:

    1. Sustituya los valores de variable establecidos.

    2. Ejecute el comando cURL.