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á.

# Adicionar contêineres privados ou de terceiros durante a criação do fluxo de trabalho
<a name="containers-workflow-creation"></a>

Ao criar um novo fluxo de trabalho, você pode definir os mapeamentos de registro e imagem exigidos pelo seu fluxo de trabalho. Para obter mais informações, consulte [Crie um fluxo de trabalho privado](create-private-workflow.md). Você também pode atualizar os mapeamentos de registro e imagem ao criar uma nova versão do fluxo de trabalho. Para obter mais informações, consulte [Crie uma versão do fluxo de trabalho](workflows-version-create.md).

As seções a seguir descrevem os mapeamentos do registro e os mapeamentos de imagens.

## Mapeamentos de registro
<a name="ecr-pull-through-registry-mapping"></a>

Você define mapeamentos de registro para mapear entre prefixos em seu registro privado do Amazon ECR e os nomes de registro upstream. Um mapa de registro pode conter mapeamentos de cache extraídos e mapeamentos para registros que HealthOmics cópias de.

O exemplo a seguir mapeia o Docker Hub, o Quay e o Amazon ECR Public por meio do cache pull through e mapeia os contêineres Seqera (`community.wave.seqera.io`) com uma credencial para que HealthOmics copia suas imagens.

```
{
    "registryMappings": [
        {
            "upstreamRegistryUrl": "registry-1.docker.io",
            "ecrRepositoryPrefix": "docker-hub"
        },
        {
            "upstreamRegistryUrl": "quay.io",
            "ecrRepositoryPrefix": "quay"
        },
        {
            "upstreamRegistryUrl": "public.ecr.aws",
            "ecrRepositoryPrefix": "ecr-public"
        },
        {
            "upstreamRegistryUrl": "community.wave.seqera.io",
            "ecrRepositoryPrefix": "wave-seqera",
            "credentialArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:omics-registry/seqera-EXAMPLE"
        }
    ]
}
```

As regras a seguir se aplicam aos mapeamentos do registro:
+ `upstreamRegistryUrl` deve corresponder exatamente ao host do registro no início do URI da imagem. Por exemplo, um mapeamento para `wave.seqera.io` não cobre imagens em `community.wave.seqera.io`.
+ Cada host de registro upstream ao qual o fluxo de trabalho faz referência precisa de um mapeamento. As imagens que você faz referência pelo URI privado do Amazon ECR não precisam de uma.
+ Os mapeamentos de cache extraídos não usam `credentialArn`. Se você adicionar `credentialArn` para um mapeamento de cache extraído, HealthOmics ignora isso.
+ Mapeamentos para registros que HealthOmics cópias de devem incluir `credentialArn`. Se um desses mapeamentos não tiver `credentialArn`, o fluxo de trabalho falha com um erro que nomeia o registro.
+ Mantenha `upstreamRepositoryPrefix` Não definido para Wave ()`wave.seqera.io`).

`CreateWorkflow` e `CreateWorkflowVersion` são assíncronos. Se o status for `FAILED`, o erro aparece em `statusMessage` na `GetWorkflow` resposta para um fluxo de trabalho, ou o `GetWorkflowVersion` resposta para uma versão do fluxo de trabalho.

Forneça o mapa em linha com `containerRegistryMap`, ou como um URI do Amazon S3 com `containerRegistryMapUri`, não ambos. Para exemplos de CLI, consulte [Configurar parâmetros de mapeamento de cache de extração](create-private-workflow.md#create-prefix-mapping-parameters) e [Configurar parâmetros de mapeamento de cache sem extração](create-private-workflow.md#create-non-ptc-mapping-parameters).

A execução usa o mapa de registro do fluxo de trabalho ou da versão do fluxo de trabalho que você executa, para que você não adicione nada ao `StartRun`.

## Mapeamentos de imagens
<a name="ecr-pull-through-mapping-format"></a>

Você define mapeamentos de imagem para mapear entre os nomes das imagens, conforme definido em seus fluxos de trabalho privados do Amazon ECR, e os nomes das imagens no registro upstream.

Você pode usar mapeamentos de imagem com registros que o Amazon ECR extrai do cache suporta, como o Quay, e com registros que o cache extraído não suporta, como o Seqera. HealthOmics não copia imagens para mapeamento de imagens, então você mesmo mantém seu repositório privado sincronizado com o registro upstream.

**nota**  
Um mapeamento de imagem tem precedência sobre os mapeamentos de registro.

O exemplo a seguir mostra mapeamentos de imagens privadas do Amazon ECR para uma imagem genômica pública e a imagem mais recente do Ubuntu.

```
{
    "imageMappings": [
        {
            "sourceImage": "public.ecr.aws/aws-genomics/broadinstitute/gatk:4.6.0.2",
            "destinationImage": "111122223333.dkr.ecr.us-east-1.amazonaws.com/broadinstitute/gatk:4.6.0.2"
        },
        {
            "sourceImage": "ubuntu:latest",
            "destinationImage": "111122223333.dkr.ecr.us-east-1.amazonaws.com/custom/ubuntu:latest"
        }
    ]
}
```

Para obter mais informações sobre como usar mapeamentos de registro e imagem ao criar um fluxo de trabalho, consulte [Configurar parâmetros de mapeamento de cache de extração](create-private-workflow.md#create-prefix-mapping-parameters).