View a markdown version of this page

Compartilhando HealthOmics fluxos de trabalho - AWS HealthOmics

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Compartilhando HealthOmics fluxos de trabalho

Como proprietário de um fluxo de trabalho privado, você pode compartilhar o fluxo de trabalho com um Conta da AWS na mesma região. Para compartilhar um fluxo de trabalho com mais de um Conta da AWS, você cria vários compartilhamentos do mesmo fluxo de trabalho.

Como proprietário, você pode revogar o acesso a um fluxo de trabalho compartilhado excluindo o compartilhamento.

nota

HealthOmics permite automaticamente que um fluxo de trabalho compartilhado acesse o repositório do Amazon ECR enquanto o fluxo de trabalho está sendo executado na conta do assinante. Você não precisa conceder acesso adicional ao repositório para fluxos de trabalho compartilhados.

Quando você compartilha um fluxo de trabalho, o assinante pode usar qualquer uma das versões do fluxo de trabalho. Se você precisar de controle de acesso em nível de versão para um fluxo de trabalho compartilhado, recomendamos criar fluxos de trabalho separados em vez de usar versões de fluxo de trabalho.

Confie no proprietário do fluxo de trabalho

Certifique-se de confiar no proprietário do fluxo de trabalho antes de aceitar um compartilhamento. Quando você executa um fluxo de trabalho compartilhado, a definição do fluxo de trabalho e as imagens do contêiner fornecidas pelo proprietário são executadas em seu Conta da AWS. Eles são executados com as permissões da função de serviço do IAM que você especifica para a execução. O conteúdo do fluxo de trabalho e suas imagens de contêiner não estão visíveis para você. Executar um fluxo de trabalho compartilhado equivale a executar um código de terceiros em sua conta. Forneça uma função de serviço com menos privilégios e use uma política de sessão para restringir ainda mais as permissões para a execução. Para obter mais informações, consulte Use políticas de sessão para reduzir as permissões.

Inscrever-se em um fluxo de trabalho compartilhado

Para assinar um fluxo de trabalho compartilhado, siga estas etapas gerais para aceitar e usar o fluxo de trabalho:

  1. Use o console ou a API para aceitar o compartilhamento. Defina sua região atual como a mesma região da solicitação de compartilhamento.

    • Para encontrar a solicitação de compartilhamento no console, navegue até o Todos os compartilhamentos de recursos página e, em seguida, escolha a Compartilhado comigo aba.

  2. Use o console ou a API para criar uma execução para o fluxo de trabalho compartilhado.

    • Para encontrar a página de detalhes do fluxo de trabalho no console, navegue até Compartilhado comigo (veja a etapa 1) e, em seguida, escolha o Link do recurso para o fluxo de trabalho compartilhado.

  3. Você fornece seus próprios dados de entrada para o fluxo de trabalho.

  4. O fluxo de trabalho compartilhado é executado em seu Conta da AWS.

Como assinante de um fluxo de trabalho compartilhado, o sistema impede que você execute as seguintes ações de fluxo de trabalho:

  • Exportação de um fluxo de trabalho compartilhado

  • Re-running o fluxo de trabalho compartilhado

    • Você cria uma nova execução para o fluxo de trabalho compartilhado.

  • Re-sharing o fluxo de trabalho.

  • Atribuir uma tag ao fluxo de trabalho.

  • Excluindo o fluxo de trabalho.

    • Quando você não precisar mais do fluxo de trabalho, exclua o compartilhamento do fluxo de trabalho.

Veja Cross-account compartilhamento de recursos em AWS HealthOmics para obter informações adicionais sobre compartilhamento de recursos.

Monitoramento do status de um compartilhamento de fluxo de trabalho

HealthOmics envia um evento para EventBridge para cada alteração de status de um compartilhamento de fluxo de trabalho. Se você quiser receber notificações sobre mudanças de status específicas, configure um EventBridge regra para monitorar Mudança de status do compartilhamento de fluxo de eventos. Por exemplo:

  • Você quer uma notificação sempre que receber uma solicitação de compartilhamento de fluxo de trabalho e sempre que um usuário revoga um compartilhamento de fluxo de trabalho.

  • Depois de iniciar uma solicitação de compartilhamento de fluxo de trabalho, você deseja receber uma notificação quando o usuário aceitar ou recusar a solicitação.

Para obter detalhes sobre o uso de eventos, consulte Usando EventBridge com AWS HealthOmics.

Compartilhando um fluxo de trabalho privado

nota

Non-PTC o suporte a contêineres não é compatível com fluxos de trabalho compartilhados, então, quando um assinante executa um fluxo de trabalho que você compartilhou, HealthOmics ignora mapeamentos de registro que incluem credentialArn. Para obter mais informações, consulte O uso de registros de terceiros não é suportado pelo pull through cache.

Console

Você pode compartilhar um fluxo de trabalho privado com um Conta da AWS na mesma região do fluxo de trabalho.

Para compartilhar um fluxo de trabalho privado
  1. Abra o console do HealthOmics .

  2. Se necessário, abra o painel de navegação esquerdo (≡). Escolha Fluxos de trabalho privados.

  3. A partir do Fluxos de trabalho mesa na Fluxos de trabalho privados página, selecione o fluxo de trabalho a ser compartilhado e escolha Compartilhe.

  4. Na Compartilhe detalhes painel do Compartilhe o fluxo de trabalho página, insira um nome descritivo para o compartilhamento e insira o Conta da AWS do assinante.

  5. Escolha Compartilhar recursos. O console exibe compartilhamentos de recursos no Todos os compartilhamentos de recursos página.

O estado inicial da ação é PENDING. Depois que o assinante aceita o compartilhamento, o estado muda para ACTIVE.

CLI

Use o create-share AWS CLI comando para criar um compartilhamento de fluxo de trabalho. O assinante principal é o Conta da AWS do usuário que obtém acesso ao fluxo de trabalho.

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

Se a criação for bem-sucedida, você receberá uma resposta com o ID e o status do compartilhamento.

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

A participação permanece em PENDING estado até que o assinante o aceite usando o accept-share AWS CLI comando.

Para mais exemplos de uso da API, consulte Cross-account compartilhamento de recursos em AWS HealthOmics.

Aceitando um fluxo de trabalho compartilhado usando o console

Você pode usar o console para aceitar um compartilhamento de fluxo de trabalho oferecido. Certifique-se de configurar o console para a mesma região do fluxo de trabalho.

  1. Abra o console do HealthOmics .

  2. Se necessário, abra o painel de navegação esquerdo (≡). Escolha Todos os compartilhamentos de recursos, em seguida, escolha o Compartilhado comigo aba.

  3. A partir do Recursos compartilhados comigo tabela, selecione o compartilhamento do fluxo de trabalho e escolha Aceitar.

Depois de aceitar o fluxo de trabalho, escolha o Link do recurso para que o fluxo de trabalho compartilhado veja seus detalhes.

Executando um fluxo de trabalho compartilhado usando o console

Depois de aceitar um compartilhamento de fluxo de trabalho, você pode iniciar uma execução no fluxo de trabalho.

  1. Abra o console do HealthOmics .

  2. Se necessário, abra o painel de navegação esquerdo (≡). Escolha Todos os compartilhamentos de recursos, em seguida, escolha o Compartilhado comigo aba.

  3. A partir do Recursos compartilhados comigo tabela, escolha o Link do recurso para o fluxo de trabalho compartilhado.

  4. Na Detalhes do fluxo de trabalho página, escolha Crie uma corrida.

    O console abre o Crie uma corrida página, com o tipo de fluxo de trabalho (compartilhado) e ID do fluxo de trabalho pré-povoado.

  5. Configure os campos restantes no Crie uma corrida formulário. Para obter informações adicionais, consulte Iniciando uma corrida usando o console.

Executar um fluxo de trabalho compartilhado usando a API

Use get-workflow para recuperar o ARN do fluxo de trabalho compartilhado.

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

Ao executar o fluxo de trabalho, forneça os dados do proprietário do fluxo de trabalho Conta da AWS ID e o ARN do fluxo de trabalho compartilhado.

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