View a markdown version of this page

Compartir HealthOmics flujos de trabajo - AWS HealthOmics

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Compartir HealthOmics flujos de trabajo

Como propietario de un flujo de trabajo privado, puedes compartir el flujo de trabajo con alguien Cuenta de AWS de la misma región. Para compartir un flujo de trabajo con más de uno Cuenta de AWS, debes crear varios recursos compartidos del mismo flujo de trabajo.

Como propietario, puedes revocar el acceso a un flujo de trabajo compartido eliminando el recurso compartido.

nota

HealthOmics permite automáticamente que un flujo de trabajo compartido acceda al repositorio de Amazon ECR mientras el flujo de trabajo se esté ejecutando en la cuenta del suscriptor. No es necesario conceder acceso adicional al repositorio para los flujos de trabajo compartidos.

Cuando compartes un flujo de trabajo, el suscriptor puede usar cualquiera de las versiones del flujo de trabajo. Si necesitas un control de acceso a nivel de versión para un flujo de trabajo compartido, te recomendamos que crees flujos de trabajo independientes en lugar de usar versiones de flujo de trabajo.

Confía en el propietario del flujo de trabajo

Asegúrate de confiar en el propietario del flujo de trabajo antes de aceptar compartir algo. Cuando ejecutas un flujo de trabajo compartido, la definición del flujo de trabajo y las imágenes del contenedor que proporcionó el propietario se ejecutan en tu Cuenta de AWS. Se ejecutan con los permisos del rol de servicio de IAM que especifiques para la ejecución. El contenido del flujo de trabajo y sus imágenes de contenedor no están visibles para ti. Ejecutar un flujo de trabajo compartido equivale a ejecutar código de terceros en tu cuenta. Proporcione una función de servicio con privilegios mínimos y utilice una política de sesión para restringir aún más los permisos de ejecución. Para obtener más información, consulte Utilice las políticas de sesión para reducir los permisos.

Suscribirse a un flujo de trabajo compartido

Para suscribirse a un flujo de trabajo compartido, siga estos pasos generales para aceptar y usar el flujo de trabajo:

  1. Usa la consola o la API para aceptar el uso compartido. Configura tu región actual en la misma región que la solicitud para compartir.

    • Para encontrar la solicitud de compartir en la consola, dirígete a la página Todos los recursos compartidos y, a continuación, selecciona la pestaña Compartido conmigo.

  2. Usa la consola o la API para crear una ejecución para el flujo de trabajo compartido.

    • Para encontrar la página de detalles del flujo de trabajo en la consola, vaya a Compartido conmigo (consulte el paso 1) y, a continuación, seleccione el enlace de recursos para el flujo de trabajo compartido.

  3. Tú proporcionas tus propios datos de entrada para el flujo de trabajo.

  4. El flujo de trabajo compartido se ejecuta en su Cuenta de AWS.

Como suscriptor de un flujo de trabajo compartido, el sistema impide que realices las siguientes acciones de flujo de trabajo:

  • Exportación de un flujo de trabajo compartido

  • Re-running el flujo de trabajo compartido

    • Se crea una nueva ejecución para el flujo de trabajo compartido.

  • Re-sharing el flujo de trabajo.

  • Asignar una etiqueta al flujo de trabajo.

  • Eliminar el flujo de trabajo.

    • Cuando ya no necesites el flujo de trabajo, eliminas el recurso compartido del flujo de trabajo.

Consulte Cross-account uso compartido de recursos en AWS HealthOmics para obtener información adicional sobre el uso compartido de recursos.

Supervisar el estado de un flujo de trabajo compartido

HealthOmics envía un evento a EventBridge por cada cambio de estado de un recurso compartido de flujo de trabajo. Si desea recibir notificaciones sobre cambios de estado específicos, configure una EventBridge regla para supervisar los eventos de cambio de estado del intercambio de flujo de trabajo. Por ejemplo:

  • Quieres recibir una notificación cada vez que recibas una solicitud para compartir un flujo de trabajo y cada vez que un usuario revoque un flujo de trabajo compartido.

  • Después de iniciar una solicitud para compartir un flujo de trabajo, desea recibir una notificación cuando el usuario acepte o rechace la solicitud.

Para obtener más información sobre el uso de eventos, consulteUtilización EventBridge con AWS HealthOmics.

Compartir un flujo de trabajo privado mediante la consola

Desde la consola, puedes compartir un flujo de trabajo privado con alguien de Cuenta de AWS la misma región que el flujo de trabajo.

Para compartir un flujo de trabajo privado
  1. Abra la consola de HealthOmics .

  2. Si es necesario, abre el panel de navegación izquierdo (≡). Elige Flujos de trabajo privados.

  3. En la tabla Flujos de trabajo de la página Flujos de trabajo privados, seleccione el flujo de trabajo que desea compartir y elija Compartir.

  4. En el panel de detalles para compartir de la página de flujo de trabajo para compartir, introduzca un nombre descriptivo para el recurso compartido e introduzca el nombre Cuenta de AWS del suscriptor.

  5. Elija Compartir recurso. La consola muestra los recursos compartidos en la página Todos los recursos compartidos.

El estado inicial del recurso compartido está pendiente. Una vez que el suscriptor acepta la acción, el estado cambia a activo.

Compartir un flujo de trabajo privado mediante la CLI

Utilice la operación de creación y uso compartido de la API para crear un recurso compartido de flujo de trabajo. El suscriptor principal es el Cuenta de AWS del usuario que tendrá acceso al flujo de trabajo.

aws omics create-share \ --resource-arn "arn:aws:omics:us-west-2:555555555555:workflow/123456" \ --principal-subscriber "123456789012" \ --name "my_Share-123"

Si la creación se realiza correctamente, recibirá una respuesta con el ID y el estado del recurso compartido.

{ "shareId": "495c21bedc889d07d0ab69d710a6841e-dd75ab7a1a9c384fa848b5bd8e5a7e0a", "name": "my_Share-123", "status": "PENDING" }

El recurso compartido permanece en estado pendiente hasta que el suscriptor lo acepte mediante la operación de la accept-share API.

Consulta otros ejemplos Cross-account uso compartido de recursos en AWS HealthOmics de uso de la API.

Aceptar un flujo de trabajo compartido mediante la consola

Puede usar la consola para aceptar un flujo de trabajo compartido ofrecido. Asegúrese de configurar la consola en la misma región que el flujo de trabajo.

  1. Abra la consola de HealthOmics .

  2. Si es necesario, abre el panel de navegación izquierdo (≡). Selecciona Todos los recursos compartidos y, a continuación, selecciona la pestaña Compartidos conmigo.

  3. En la tabla Recursos compartidos conmigo, selecciona el flujo de trabajo compartido y, a continuación, elige Aceptar.

Tras aceptar el flujo de trabajo, elige el enlace Recurso del flujo de trabajo compartido para ver sus detalles.

Ejecución de un flujo de trabajo compartido mediante la consola

Tras aceptar un flujo de trabajo compartido, puede iniciar una ejecución en el flujo de trabajo.

  1. Abra la consola de HealthOmics .

  2. Si es necesario, abre el panel de navegación izquierdo (≡). Selecciona Todos los recursos compartidos y, a continuación, selecciona la pestaña Compartidos conmigo.

  3. En la tabla Recursos compartidos conmigo, elige el enlace Recursos para el flujo de trabajo compartido.

  4. En la página de detalles del flujo de trabajo, selecciona Crear ejecución.

    La consola abre la página Crear ejecución, con el tipo de flujo de trabajo (compartido) y el identificador del flujo de trabajo rellenados previamente.

  5. Configure los campos restantes en el formulario Crear una ejecución. Para obtener información adicional, consulta Iniciar una ejecución con la consola.

Ejecución de un flujo de trabajo compartido mediante la API

Utilice get-workflow para recuperar el ARN del flujo de trabajo compartido.

aws omics get-workflow --id 1234567 \ --workflow-owner-id 55555555555

Cuando ejecutes el flujo de trabajo, proporciona el Cuenta de AWS ID del propietario del flujo de trabajo y el ARN del flujo de trabajo compartido.

aws omics start-run --id 1234567 --workflow-owner-id 55555555555 \ --role-arn arn:aws:iam::1234567892012:role/service-role/OmicsWorkflow-20221004T164236 \ --name ArchiveTest --retention-mode REMOVE