Condivisione dei HealthOmics flussi di lavoro

In qualità di proprietario di un flusso di lavoro privato, puoi condividerlo con un Account AWS utente della stessa regione. Per condividere un flusso di lavoro con più di uno Account AWS, crei 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 alla pagina Tutte le condivisioni di risorse, quindi scegli la scheda Condivisa con me.

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 su Condiviso con me (vedi passaggio 1), quindi scegli il link 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 ti impedisce 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.

Cross-account condivisione delle risorse in AWS HealthOmicsPer ulteriori informazioni sulla condivisione delle risorse, consulta.

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, imposta una EventBridge regola per monitorare gli eventi di modifica dello stato di Workflow share. 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, consulta. Usare EventBridge con AWS HealthOmics

Condivisione di un flusso di lavoro privato tramite la console

Dalla console, puoi condividere un flusso di lavoro privato con una persona che si Account AWS trova nella stessa regione del flusso di lavoro.

Per condividere un flusso di lavoro privato

1. Apri la HealthOmics console.

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

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

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

5. Scegli Condividi risorsa. La console visualizza le condivisioni di risorse nella pagina Tutte le condivisioni di risorse.

Lo stato iniziale della condivisione è in sospeso. Dopo l'accettazione della condivisione da parte del sottoscrittore, lo stato diventa attivo.

Condivisione di un flusso di lavoro privato tramite la CLI

Utilizza l'operazione API create-share per creare una condivisione del flusso di lavoro. L'abbonato principale è Account AWS l'utente che avrà 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"
}     

Lo stato della condivisione rimane in sospeso finché l'abbonato non l'accetta utilizzando l'operazione accept-share API.

Vedi Cross-account condivisione delle risorse in AWS HealthOmics per altri esempi di utilizzo dell'API.

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 HealthOmics console.

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

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

Dopo aver accettato il flusso di lavoro, scegli il link Risorsa per il flusso di lavoro condiviso per 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 HealthOmics console.

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

3. Dalla tabella Risorse condivise con me, scegli il link Risorse per il flusso di lavoro condiviso.

4. Nella pagina dei dettagli del flusso di lavoro, scegli Crea esecuzione.

   La console apre la pagina Crea esecuzione, con il tipo di flusso di lavoro (condiviso) e l'ID del flusso di lavoro precompilati.

5. Configura i campi rimanenti nel modulo Create run. 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 l' Account AWS ID del proprietario del flusso di lavoro e l'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