Crear un flujo de trabajo privado

Cree un flujo de trabajo mediante la HealthOmics consola, los comandos AWS CLI o uno de los AWS SDKs.

nota

No incluya ninguna información de identificación personal (PII) en los nombres de los flujos de trabajo. Estos nombres están visibles en CloudWatch los registros.

Al crear un flujo de trabajo, HealthOmics asigna un identificador único universal (UUID) al flujo de trabajo. El UUID del flujo de trabajo es un identificador único global (GUID) que es único en todos los flujos de trabajo y versiones del flujo de trabajo. Para la procedencia de los datos, le recomendamos que utilice el UUID del flujo de trabajo para identificar los flujos de trabajo de forma exclusiva.

Crear un flujo de trabajo mediante la consola

Pasos para crear un flujo de trabajo

1. Abra la consola de HealthOmics .

2. Seleccione el panel de navegación (≡) en la parte superior izquierda y seleccione Flujos de trabajo privados.

3. En la página Flujos de trabajo privados, selecciona Crear flujo de trabajo.

4. En la página Definir flujo de trabajo, proporciona la siguiente información:

   1. Nombre del flujo de trabajo: nombre distintivo de este flujo de trabajo. Recomendamos configurar los nombres de los flujos de trabajo para organizar las ejecuciones en la AWS HealthOmics consola y en CloudWatch los registros.

   2. Descripción (opcional): descripción de este flujo de trabajo.

5. En el panel de definición del flujo de trabajo, proporcione la siguiente información:

   1. Idioma del flujo de trabajo (opcional): seleccione el idioma de especificación del flujo de trabajo. De lo contrario, HealthOmics determina el idioma a partir de la definición del flujo de trabajo.

   2. Para la fuente de definición de flujo de trabajo, elija importar la carpeta de definición desde un repositorio basado en Git, una ubicación de Amazon S3 o desde una unidad local.

      1. Para importar desde un servicio de repositorio:

         nota

         HealthOmics admite repositorios públicos y privados paraGitHub,GitLab, BitbucketGitHub self-managed,GitLab self-managed.

         1. Elija una conexión para conectar sus AWS recursos al repositorio externo. Para crear una conexión, consulteConéctese con repositorios de código externos.

            nota

            Los clientes de la TLV región deben crear una conexión en la región IAD (us-east-1) para crear un flujo de trabajo.

         2. En ID de repositorio completo, introduce tu ID de repositorio como nombre de usuario/nombre de repositorio. Comprueba que tienes acceso a los archivos de este repositorio.

         3. En Referencia de origen (opcional), introduce una referencia de origen del repositorio (rama, etiqueta o ID de confirmación). HealthOmics usa la rama predeterminada si no se especifica ninguna referencia a la fuente.

         4. En Excluir patrones de archivos, introduzca los patrones de archivo para excluir carpetas, archivos o extensiones específicos. Esto ayuda a administrar el tamaño de los datos al importar archivos del repositorio. Hay un máximo de 50 patrones y los patrones deben seguir la sintaxis del patrón global. Por ejemplo:

            1. tests/

            2. *.jpeg

            3. large_data.zip

      2. Para seleccionar la carpeta de definiciones de S3:

         1. Introduzca la ubicación de Amazon S3 que contiene la carpeta comprimida de definiciones de flujos de trabajo. El bucket de Amazon S3 debe estar en la misma región que el flujo de trabajo.

         2. Si su cuenta no es propietaria del depósito de Amazon S3, introduzca el ID de AWS cuenta del propietario del depósito en el ID de cuenta del propietario del depósito de S3. Esta información es necesaria para HealthOmics poder verificar la propiedad del bucket.

      3. Para seleccionar la carpeta de definiciones de una fuente local:

         1. Introduzca la ubicación de la unidad local de la carpeta comprimida de definiciones de flujo de trabajo.

   3. Ruta principal del archivo de definición del flujo de trabajo (opcional): introduzca la ruta del archivo desde la carpeta o el repositorio de definiciones de flujo de trabajo comprimido hasta el main archivo. Este parámetro no es necesario si solo hay un archivo en la carpeta de definición del flujo de trabajo o si el archivo principal se denomina «principal».

6. En el panel del archivo README (opcional), proporcione la siguiente información:

   1. Seleccione la fuente del archivo README.

      1. Para Importar desde un servicio de repositorio, en la ruta del archivo README, introduzca la ruta al archivo README del repositorio.

      2. En Seleccione un archivo de S3, en el archivo README de S3, introduzca el URI de Amazon S3 para el archivo README.

      3. En Seleccione un archivo de una fuente local: en el archivo README de una fuente local, cargue un archivo README de una fuente local.

   2. En la ruta del archivo README, introduzca la ruta al archivo README de la fuente.

7. En el panel de configuración del almacenamiento de ejecución predeterminado, indique el tipo y la capacidad de almacenamiento de ejecución predeterminados para las ejecuciones que utilizan este flujo de trabajo:

   1. Tipo de almacenamiento de ejecución: elija si desea utilizar el almacenamiento estático o dinámico como predeterminado para el almacenamiento de ejecución temporal. El valor predeterminado es el almacenamiento estático.

   2. Capacidad de almacenamiento de ejecución (opcional): para el tipo de almacenamiento de ejecución estático, puede introducir la cantidad predeterminada de almacenamiento de ejecución necesaria para este flujo de trabajo. El valor predeterminado de este parámetro es 1200 GiB. Puede anular estos valores predeterminados al iniciar una ejecución.

8. Etiquetas (opcional): puedes asociar hasta 50 etiquetas a este flujo de trabajo.

9. Elija Siguiente.

10. En la página Añadir parámetros de flujo de trabajo (opcional), seleccione la fuente de parámetros:

    1. Para analizar desde un archivo de definición de flujo de trabajo, HealthOmics analizará automáticamente los parámetros del flujo de trabajo del archivo de definición del flujo de trabajo.

    2. Para Proporcionar una plantilla de parámetros desde el repositorio de Git, usa la ruta al archivo de plantillas de parámetros de tu repositorio.

    3. Para seleccionar un archivo JSON de una fuente local, sube un JSON archivo de una fuente local que especifique los parámetros.

    4. En Introducir manualmente los parámetros del flujo de trabajo, introduzca manualmente los nombres y las descripciones de los parámetros.

11. En el panel de vista previa de los parámetros, puede revisar o cambiar los parámetros de esta versión del flujo de trabajo. Si restaura el JSON archivo, perderá todos los cambios locales que haya realizado.

12. Elija Siguiente.

13. Revise la configuración del flujo de trabajo y, a continuación, seleccione Crear flujo de trabajo.

Creación de un flujo de trabajo mediante la CLI

Después de definir el flujo de trabajo y los parámetros, puede crear un flujo de trabajo mediante la CLI, como se muestra.

aws omics create-workflow  \
  --name "my_workflow"   \
  --definition-zip fileb://my-definition.zip \
  --parameter-template file://my-parameter-template.json 

Si el archivo de definición de flujo de trabajo se encuentra en una carpeta de Amazon S3, introduzca la ubicación mediante el definition-uri parámetro en lugar dedefinition-zip. Para obtener más información, consulte CreateWorkflowla referencia de la HealthOmics API de AWS.

La create-workflow solicitud responde con lo siguiente:

{
  "arn": "arn:aws:omics:us-west-2:....",
  "id": "1234567",
  "status": "CREATING",
  "tags": {
      "resourceArn": "arn:aws:omics:us-west-2:...."
  },
  "uuid": "64c9a39e-8302-cc45-0262-2ea7116d854f"
}   

Parámetros opcionales que se deben usar al crear un flujo de trabajo

Puede especificar cualquiera de los parámetros opcionales al crear un flujo de trabajo. Para obtener más información, consulte CreateWorkflowla referencia de la HealthOmics API de AWS.

Si incluye varios archivos de definición de flujo de trabajo, utilice el main parámetro para especificar qué archivo es el archivo de definición principal de su flujo de trabajo.

Si ha cargado el archivo de definición de flujo de trabajo en una carpeta de Amazon S3, especifique la ubicación mediante el definition-uri parámetro, como se muestra en el siguiente ejemplo. Si su cuenta no es propietaria del bucket de Amazon S3, proporcione el Cuenta de AWS ID del propietario.

aws omics create-workflow  \
  --name Test  \
  --main multi_workflow/workflow2.wdl  \
  --definition-uri s3://omics-bucket/workflow-definition/  \
  --owner-id  123456789012  \
  --parameter-template file://params_sample_description.json 

Puede especificar el tipo de almacenamiento de ejecución predeterminado (DINÁMICO o ESTÁTICO) y la capacidad de almacenamiento de ejecución (necesaria para el almacenamiento estático). Para obtener más información sobre los tipos de almacenamiento de ejecución, consulteEjecute tipos de almacenamiento en HealthOmics flujos de trabajo.

aws omics create-workflow  \
  --name my_workflow   \
  --definition-zip fileb://my-definition.zip \
  --parameter-template file://my-parameter-template.json   \
  --storage-type 'STATIC'  \
  --storage-capacity 1200  \

Utilice el parámetro accelerators para crear un flujo de trabajo que se ejecute en una instancia de procesamiento acelerado. En el siguiente ejemplo, se muestra cómo utilizar el parámetro. --accelerators

aws omics create-workflow --name workflow name \
   --definition-uri s3://amzn-s3-demo-bucket1/GPUWorkflow.zip \
   --accelerators GPU  

Crear un flujo de trabajo mediante un SDK

Puede crear un flujo de trabajo mediante uno de los SDKs. El siguiente ejemplo muestra cómo crear un flujo de trabajo mediante el SDK de Python.

import boto3

omics = boto3.client('omics')

with open('definition.zip', 'rb') as f:
   definition = f.read()

response = omics.create_workflow(
   name='my_workflow',
   definitionZip=definition,
   parameterTemplate={ ... }
)