View a markdown version of this page

Condivisione HealthOmics flussi di lavoro - AWS HealthOmics

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Condivisione HealthOmics flussi di lavoro

In qualità di proprietario di un flusso di lavoro privato, puoi condividerlo con un Account AWS nella stessa regione. Per condividere un flusso di lavoro con più di uno Account AWS, si creano più condivisioni dello stesso flusso di lavoro.

In qualità di proprietario, puoi revocare l'accesso a un flusso di lavoro condiviso eliminando la condivisione.

Nota

HealthOmics consente automaticamente a un flusso di lavoro condiviso di accedere al repository Amazon ECR mentre il flusso di lavoro è in esecuzione nell'account dell'abbonato. Non è necessario concedere un accesso aggiuntivo al repository per i flussi di lavoro condivisi.

Quando condividi un flusso di lavoro, l'abbonato può utilizzare una qualsiasi delle versioni del flusso di lavoro. Se hai bisogno del controllo dell'accesso a livello di versione per un flusso di lavoro condiviso, ti consigliamo di creare flussi di lavoro separati anziché utilizzare versioni del flusso di lavoro.

Affidati al proprietario del flusso di lavoro

Assicurati di fidarti del proprietario del flusso di lavoro prima di accettare una condivisione. Quando esegui un flusso di lavoro condiviso, la definizione del flusso di lavoro e le immagini del contenitore fornite dal proprietario vengono eseguite nel tuo Account AWS. Vengono eseguiti con le autorizzazioni del ruolo del servizio IAM specificato per l'esecuzione. I contenuti del flusso di lavoro e le relative immagini del contenitore non sono visibili all'utente. L'esecuzione di un flusso di lavoro condiviso equivale all'esecuzione di codice di terze parti nel tuo account. Fornisci un ruolo di servizio con privilegi minimi e utilizza una policy di sessione per limitare ulteriormente le autorizzazioni per l'esecuzione. Per ulteriori informazioni, consulta Utilizza i criteri di sessione per limitare le autorizzazioni.

Sottoscrizione a un flusso di lavoro condiviso

Per iscriverti a un flusso di lavoro condiviso, segui questi passaggi generali per accettare e utilizzare il flusso di lavoro:

  1. Usa la console o l'API per accettare la condivisione. Imposta la tua regione attuale sulla stessa regione della richiesta di condivisione.

    • Per trovare la richiesta di condivisione nella console, vai a Tutte le condivisioni di risorse pagina, quindi scegli Condiviso con me scheda.

  2. Usa la console o l'API per creare un'esecuzione per il flusso di lavoro condiviso.

    • Per trovare la pagina dei dettagli del flusso di lavoro nella console, vai a Condiviso con me (vedi passaggio 1), quindi scegli Link alla risorsa per il flusso di lavoro condiviso.

  3. Fornisci i tuoi dati di input per il flusso di lavoro.

  4. Il flusso di lavoro condiviso viene eseguito nel tuo Account AWS.

In qualità di abbonato a un flusso di lavoro condiviso, il sistema impedisce all'utente di eseguire le seguenti azioni del flusso di lavoro:

  • Esportazione di un flusso di lavoro condiviso

  • Re-running il flusso di lavoro condiviso

    • Si crea una nuova esecuzione per il flusso di lavoro condiviso.

  • Re-sharing il flusso di lavoro.

  • Assegnazione di un tag al flusso di lavoro.

  • Eliminazione del flusso di lavoro.

    • Quando il flusso di lavoro non è più necessario, si elimina la condivisione del flusso di lavoro.

Vedi Cross-account condivisione delle risorse in AWS HealthOmics per ulteriori informazioni sulla condivisione delle risorse.

Monitoraggio dello stato di una condivisione del flusso di lavoro

HealthOmics invia un evento a EventBridge per ogni modifica dello stato di una condivisione del flusso di lavoro. Se desideri ricevere notifiche su modifiche di stato specifiche, configura un EventBridge regola da monitorare Modifica dello stato di condivisione del flusso di lavoro eventi. Ad esempio:

  • Desideri ricevere una notifica ogni volta che ricevi una richiesta di condivisione del flusso di lavoro e ogni volta che un utente revoca una condivisione del flusso di lavoro.

  • Dopo aver avviato una richiesta di condivisione del flusso di lavoro, desideri ricevere una notifica quando l'utente accetta o rifiuta la richiesta.

Per informazioni dettagliate sull'utilizzo degli eventi, vedi Usando EventBridge con AWS HealthOmics.

Condivisione di un flusso di lavoro privato

Nota

Non-PTC Il supporto per i contenitori non è supportato per i flussi di lavoro condivisi, quindi quando un abbonato esegue un flusso di lavoro che hai condiviso, HealthOmics ignora le mappature del registro che includono credentialArn. Per ulteriori informazioni, consulta Utilizzo di registri di terze parti non supportati dalla cache pull through.

Console

Puoi condividere un flusso di lavoro privato con un Account AWS nella stessa regione del flusso di lavoro.

Per condividere un flusso di lavoro privato
  1. Apri la console HealthOmics .

  2. Se necessario, apri il pannello di navigazione a sinistra (≡). Scegli Flussi di lavoro privati.

  3. Dal Flussi di lavoro tabella sul Flussi di lavoro privati pagina, seleziona il flusso di lavoro da condividere e scegli Condividi.

  4. Nel Condividi i dettagli pannello di Condividi il flusso di lavoro pagina, inserisci un nome descrittivo per la condivisione e inserisci Account AWS del sottoscrittore.

  5. Scegli Condividi risorsa. La console mostra le condivisioni di risorse in Tutte le condivisioni di risorse pagina.

Lo stato iniziale della condivisione è PENDING. Dopo che l'abbonato ha accettato la condivisione, lo stato cambia in ACTIVE.

CLI

Usa il create-share AWS CLI comando per creare una condivisione del flusso di lavoro. L'abbonato principale è Account AWS dell'utente che ottiene l'accesso al flusso di lavoro.

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

Se la creazione ha esito positivo, riceverai una risposta con l'ID e lo stato della condivisione.

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

La condivisione rimane attiva PENDING stato finché l'abbonato non lo accetta utilizzando il accept-share AWS CLI comando.

Per altri esempi di utilizzo delle API, vedi Cross-account condivisione delle risorse in AWS HealthOmics.

Accettazione di un flusso di lavoro condiviso tramite la console

È possibile utilizzare la console per accettare una condivisione del flusso di lavoro offerta. Assicurati di impostare la console sulla stessa regione del flusso di lavoro.

  1. Apri la console HealthOmics .

  2. Se necessario, apri il pannello di navigazione a sinistra (≡). Scegli Tutte le condivisioni delle risorse, quindi scegli Condiviso con me scheda.

  3. Dal Risorse condivise con me tabella, seleziona la condivisione del flusso di lavoro e quindi scegli Accetta.

Dopo aver accettato il flusso di lavoro, scegli Link alla risorsa per consentire al flusso di lavoro condiviso di visualizzarne i dettagli.

Esecuzione di un flusso di lavoro condiviso utilizzando la console

Dopo aver accettato la condivisione di un flusso di lavoro, è possibile avviare un'esecuzione sul flusso di lavoro.

  1. Apri la console HealthOmics .

  2. Se necessario, apri il pannello di navigazione a sinistra (≡). Scegli Tutte le condivisioni delle risorse, quindi scegli Condiviso con me scheda.

  3. Dal Risorse condivise con me tavolo, scegli il Link alla risorsa per il flusso di lavoro condiviso.

  4. Nel Dettagli del flusso di lavoro pagina, scegli Crea corsa.

    La console apre il Crea corsa pagina, con il tipo di flusso di lavoro (condiviso) e ID del flusso di lavoro precompilato.

  5. Configura i campi rimanenti in Crea corsa modulo. Per ulteriori informazioni, consulta Avvio di una corsa utilizzando la console.

Esecuzione di un flusso di lavoro condiviso utilizzando l'API

Usa get-workflow per recuperare l'ARN del flusso di lavoro condiviso.

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

Quando esegui il flusso di lavoro, fornisci i dati del proprietario del flusso di lavoro Account AWS ID e ARN del flusso di lavoro condiviso.

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