View a markdown version of this page

Crie uma versão do fluxo 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á.

Crie uma versão do fluxo de trabalho

Ao criar uma nova versão de um fluxo de trabalho, você precisa especificar os valores de configuração para a nova versão. Ele não herda nenhum valor de configuração do fluxo de trabalho.

Ao criar a versão, forneça um nome de versão exclusivo para esse fluxo de trabalho. Você não pode alterar o nome depois HealthOmics cria a versão.

O nome da versão deve começar com uma letra ou um número e pode incluir letras maiúsculas e minúsculas, números, hífens, pontos e sublinhados. O tamanho máximo é de 64 caracteres. Por exemplo, você pode usar um esquema de nomenclatura simples, como versão1, versão2, versão3. Você também pode combinar suas versões de fluxo de trabalho com suas próprias convenções internas de controle de versão, como 2.7.0, 2.7.1, 2.7.2.

Opcionalmente, use o campo de descrição da versão para adicionar notas sobre essa versão. Por exemplo: Fix for syntax error in workflow definition.

nota

Não inclua nenhuma informação de identificação pessoal (PII) no nome da versão. Os nomes das versões aparecem no ARN da versão do fluxo de trabalho.

HealthOmics atribui um ARN exclusivo à versão do fluxo de trabalho. O ARN é exclusivo com base na combinação de ID do fluxo de trabalho e nome da versão.

Atenção

Depois de excluir uma versão do fluxo de trabalho, HealthOmics permite que você reutilize o nome da versão para uma versão diferente do fluxo de trabalho. A melhor prática é não reutilizar nomes de versões. Se você reutilizar um nome, o fluxo de trabalho e cada versão terão um UUID exclusivo que você poderá usar como proveniência.

Crie uma versão do fluxo de trabalho usando o console

Etapas para criar uma versão do fluxo de trabalho
  1. Abra o console do HealthOmics .

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

  3. Na Fluxos de trabalho privados página, escolha o fluxo de trabalho para a nova versão.

  4. Na Detalhes do fluxo de trabalho página, escolha Criar nova versão.

  5. Na Criar versão página, forneça as seguintes informações:

    1. Nome da versão: insira um nome para a versão do fluxo de trabalho que seja exclusivo em todo o fluxo de trabalho.

    2. Descrição da versão (opcional): você pode usar o campo de descrição para adicionar notas sobre essa versão.

  6. Na Definição de fluxo de trabalho painel, forneça as seguintes informações:

    1. Idioma do fluxo (opcional): selecione o idioma de especificação para a versão do fluxo de trabalho. Caso contrário, HealthOmics determina o idioma a partir da definição do fluxo de trabalho.

    2. Para Fonte de definição de fluxo de trabalho, opte por importar a pasta de definição de um Git-based repositório, um local do Amazon S3 ou de uma unidade local.

      1. Para Importar de um serviço de repositório:

        nota

        HealthOmics suporta repositórios públicos e privados para GitHub, GitLab, Bitbucket, GitHub self-managed, GitLab self-managed.

        1. Escolha um Conexão para conectar seu AWS recursos para o repositório externo. Para criar uma conexão, consulte Conecte-se com repositórios de código externos.

          nota

          Clientes na TLV região precisa criar uma conexão no IAD região (us-east-1) para criar um fluxo de trabalho.

        2. Em ID completo do repositório, insira seu ID do repositório como usuário-name/repo-nome. Verifique se você tem acesso aos arquivos neste repositório.

        3. Em Referência da fonte (opcional), insira uma referência de origem do repositório (branch, tag ou ID do commit). HealthOmics usa a ramificação padrão se nenhuma referência de origem for especificada.

        4. Em Excluir padrões de arquivo, insira os padrões de arquivo para excluir pastas, arquivos ou extensões específicos. Isso ajuda a gerenciar o tamanho dos dados ao importar arquivos do repositório. Há um máximo de 50 padrões, e os padrões devem seguir o sintaxe do padrão global. Por exemplo:

          1. tests/

          2. *.jpeg

          3. large_data.zip

      2. Para Selecione a pasta de definição do S3:

        1. Insira o local do Amazon S3 que contém a pasta de definição de fluxo de trabalho compactada. O bucket do Amazon S3 deve estar na mesma região do fluxo de trabalho.

        2. Se sua conta não for proprietária do bucket Amazon S3, insira o do proprietário do bucket AWS ID da conta no ID da conta do proprietário do bucket S3. Essas informações são necessárias para que HealthOmics pode verificar a propriedade do bucket.

      3. Para Selecione a pasta de definição de uma fonte local:

        1. Insira a localização da unidade local da pasta de definição do fluxo de trabalho compactada.

    3. Caminho do arquivo de definição do fluxo de trabalho principal (opcional): insira o caminho do arquivo da pasta ou repositório de definição do fluxo de trabalho compactado até o main arquivo. Esse parâmetro não é necessário se houver somente um arquivo na pasta de definição do fluxo de trabalho ou se o arquivo principal tiver o nome “principal”.

  7. Na Arquivo README painel (opcional), selecione o Fonte do arquivo README e forneça as seguintes informações:

    • Para Importar de um serviço de repositório, em Caminho do arquivo README, insira o caminho para o arquivo README no repositório.

    • Para Selecionar arquivo do S3, em Arquivo README no S3, insira o URI do Amazon S3 para o arquivo README.

    • Para Selecionar arquivo de uma fonte local: em README - opcional, escolheu Escolha o arquivo para selecionar o arquivo markdown (.md) a ser carregado.

  8. Na Configuração padrão de armazenamento de execução painel, forneça o tipo de armazenamento de execução padrão e a capacidade para execuções que usam esse fluxo de trabalho:

    1. Execute o tipo de armazenamento: escolha se deseja usar armazenamento estático ou dinâmico como padrão para o armazenamento de execução temporária. O padrão é armazenamento estático.

    2. Execute a capacidade de armazenamento (opcional): para o tipo de armazenamento de execução estático, você pode inserir a quantidade padrão de armazenamento de execução necessária para esse fluxo de trabalho. O valor padrão para esse parâmetro é 1200 GiB. Você pode substituir esses valores padrão ao iniciar uma execução.

  9. Etiquetas (opcional): você pode associar até 50 tags a essa versão do fluxo de trabalho.

  10. Escolha Próximo.

  11. Na Adicionar parâmetros de fluxo de trabalho página (opcional), selecione a Fonte do parâmetro:

    1. Para Análise a partir do arquivo de definição de fluxo de trabalho, HealthOmics analisará automaticamente os parâmetros do fluxo de trabalho do arquivo de definição do fluxo de trabalho.

    2. Para Forneça um modelo de parâmetro do repositório Git, use o caminho para o arquivo de modelo de parâmetros do seu repositório.

    3. Para Selecione o arquivo JSON da fonte local, faça o upload de um JSON arquivo de uma fonte local que especifica os parâmetros.

    4. Para Insira manualmente os parâmetros do fluxo de trabalho, insira manualmente os nomes e as descrições dos parâmetros.

  12. Na Pré-visualização de parâmetros painel, você pode revisar ou alterar os parâmetros dessa versão do fluxo de trabalho. Se você restaurar o JSON arquivo, você perde todas as alterações locais que você fez.

  13. Na Remapeamento do URI do contêiner página, na Regras de mapeamento No painel, você pode definir regras de mapeamento de URI para seu fluxo de trabalho.

    Para Fonte do arquivo de mapeamento, selecione uma das seguintes opções:

    • Nenhum — Não são necessárias regras de mapeamento.

    • Selecione o arquivo JSON do S3 — Especifique a localização do S3 para o arquivo de mapeamento.

    • Selecione o arquivo JSON de uma fonte local — Especifique a localização do arquivo de mapeamento em seu dispositivo local.

    • Inserir mapeamentos manualmente — insira os mapeamentos do registro e os mapeamentos de imagens no Mapeamentos painel.

  14. O console exibe o Mapeamentos painel. Se você escolher um arquivo de origem de mapeamento, o console exibirá os valores do arquivo.

    1. Em Mapeamentos de registro, você pode editar os mapeamentos ou adicionar mapeamentos (máximo de 20 mapeamentos de registro).

      Cada mapeamento do registro contém os seguintes campos:

      • URL de registro upstream — O URI do registro upstream.

      • Prefixo do repositório ECR — O prefixo do repositório a ser usado no repositório privado do Amazon ECR.

      • (Opcional) Prefixo do repositório upstream — O prefixo do repositório no registro upstream.

      • (Opcional) ID da conta ECR — ID da conta que possui a imagem do contêiner upstream.

      • (Opcional) ARN credencial — O ARN do segredo do Secrets Manager que contém suas credenciais para o registro. Obrigatório para registros que o Amazon ECR extrai do cache não suporta, como Seqera, NVIDIA NGC, Google Artifact Registry e Google Container Registry. Para obter mais informações, consulte O uso de registros de terceiros não é suportado pelo pull through cache.

    2. Em Mapeamentos de imagens, você pode editar os mapeamentos de imagem ou adicionar mapeamentos (máximo de 100 mapeamentos de imagem).

      Cada mapeamento de imagem contém os seguintes campos:

      • Imagem de origem — Especifica o URI da imagem de origem no registro upstream.

      • Imagem de destino — Especifica o URI da imagem correspondente no registro privado do Amazon ECR.

  15. Escolha Próximo.

  16. Revise a configuração da versão e escolha Criar versão.

Quando a versão é criada, o console retorna à página de detalhes do fluxo de trabalho e exibe a nova versão no Fluxos de trabalho e versões mesa.

Crie uma versão do fluxo de trabalho usando a CLI

Você pode criar uma versão do fluxo de trabalho usando o CreateWorkflowVersion Operação da API. Para parâmetros opcionais, HealthOmics usa os seguintes padrões:

Parâmetro Padrão
Mecanismo Determinado a partir da definição do fluxo de trabalho
Tipo de armazenamento STATIC
Capacidade de armazenamento (para armazenamento estático) 1.200 GiB
Principal Determinado com base no conteúdo da pasta de definição do fluxo de trabalho. Para obter detalhes, consulte HealthOmics requisitos de definição de fluxo de trabalho.
Aceleradores nenhuma
Tags nenhuma

O exemplo de CLI a seguir cria uma versão de fluxo de trabalho com armazenamento estático como armazenamento de execução padrão:

aws omics create-workflow-version \ --workflow-id 1234567 \ --version-name "my_version" \ --engine WDL \ --definition-zip fileb://workflow-crambam.zip \ --description "my version description" \ --main file://workflow-params.json \ --parameter-template file://workflow-params.json \ --storage-type='STATIC' \ --storage-capacity 1200 \ --tags example123=string \ --accelerators GPU

Se seu arquivo de definição de fluxo de trabalho estiver localizado em uma pasta do Amazon S3, insira o local usando o definition-uri parâmetro em vez de definition-zip. Para obter mais informações, consulte CreateWorkflowVersion na AWS HealthOmics Referência da API.

Você recebe a seguinte resposta ao create-workflow-version solicitação.

{ "workflowId": "1234567", "versionName": "my_version", "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567/version/3", "status": "ACTIVE", "tags": { "environment": "production", "owner": "team-alpha" }, "uuid": "0ac9a563-355c-fc7a-1b47-a115167af8a2" }

Crie uma versão do fluxo de trabalho usando um SDK

Você pode criar um fluxo de trabalho usando um dos SDKs.

O exemplo a seguir mostra como criar uma versão de fluxo de trabalho usando o SDK do Python.

import boto3 omics = boto3.client('omics') with open('definition.zip', 'rb') as f: definition = f.read() response = omics.create_workflow_version( workflowId='1234567', versionName='my_version', requestId='my_request_1' definitionZip=definition, parameterTemplate={ ... } )

Verificar o status de uma versão do fluxo de trabalho

Depois de criar sua versão do fluxo de trabalho, você pode verificar o status e visualizar outros detalhes do fluxo de trabalho usando obter versão de fluxo de trabalho, conforme mostrado.

aws omics get-workflow-version --workflow-id 9876543 --version-name "my_version"

A resposta fornece detalhes do seu fluxo de trabalho, incluindo o status, conforme mostrado.

{ "workflowId": "1234567", "versionName": "3.0.0", "arn": "arn:aws:omics:us-west-2:123456789012:workflow/1234567/version/3.0.0", "status": "ACTIVE", "description": ... "uuid": "0ac9a563-355c-fc7a-1b47-a115167af8a2" }

Antes de iniciar uma execução com essa versão do fluxo de trabalho, o status deve passar para ACTIVE.