Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Hinzufügen von privaten Containern oder Containern von Drittanbietern während der Workflow-Erstellung
<a name="containers-workflow-creation"></a>

Wenn Sie einen neuen Workflow erstellen, können Sie die Registrierungs- und Image-Zuordnungen definieren, die für Ihren Workflow erforderlich sind. Weitere Informationen finden Sie unter [Erstellen Sie einen privaten Workflow](create-private-workflow.md). Sie können Registrierungs- und Image-Zuordnungen auch aktualisieren, wenn Sie eine neue Workflow-Version erstellen. Weitere Informationen finden Sie unter [Eine Workflow-Version erstellen](workflows-version-create.md).

In den folgenden Abschnitten werden Registrierungs- und Image-Zuordnungen beschrieben.

## Zuordnungen in der Registrierung
<a name="ecr-pull-through-registry-mapping"></a>

Sie definieren Registrierungszuordnungen, um Präfixe in Ihrer privaten Amazon ECR-Registrierung und den Namen der Upstream-Registry zuzuordnen. Eine Registrierungsübersicht kann sowohl Pull-Through-Cache-Zuordnungen als auch Zuordnungen für Registries enthalten, die HealthOmics Kopien von.

Das folgende Beispiel ordnet Docker Hub, Quay und Amazon ECR Public über den Pull-Through-Cache zu und ordnet Seqera Containers zu (`community.wave.seqera.io`) mit einem Berechtigungsnachweis, sodass HealthOmics kopiert seine Bilder.

```
{
    "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"
        }
    ]
}
```

Die folgenden Regeln gelten für Registrierungszuordnungen:
+ `upstreamRegistryUrl` muss exakt mit dem Registrierungshost am Anfang der Image-URI übereinstimmen. Zum Beispiel ein Mapping für `wave.seqera.io` deckt keine Bilder ab `community.wave.seqera.io`.
+ Jeder Upstream-Registrierungshost, auf den der Workflow verweist, benötigt eine Zuordnung. Bilder, auf die Sie mit ihrer privaten Amazon ECR-URI verweisen, benötigen keine.
+ Pull-Through-Cache-Zuordnungen werden nicht verwendet `credentialArn`. Wenn du hinzufügst `credentialArn` zu einem Pull-Through-Cache-Mapping, HealthOmics ignoriert es.
+ Zuordnungen für Registries, die HealthOmics Kopien von müssen Folgendes enthalten `credentialArn`. Wenn eine dieser Zuordnungen keine hat `credentialArn`schlägt der Workflow mit einem Fehler fehl, der die Registrierung benennt.
+ Behalten `upstreamRepositoryPrefix` Sonnenuntergang für Wave (`wave.seqera.io`).

`CreateWorkflow` und `CreateWorkflowVersion` sind asynchron. Wenn der Status lautet `FAILED`, der Fehler erscheint in `statusMessage` in der `GetWorkflow` Antwort für einen Workflow, oder `GetWorkflowVersion` Antwort für eine Workflow-Version.

Stellen Sie die Karte im Inline-Format bereit mit `containerRegistryMap`oder als Amazon S3-URI mit `containerRegistryMapUri`, nicht beides. CLI-Beispiele finden Sie unter [Konfigurieren Sie die Parameter für die Pull-through-Cache-Zuordnung](create-private-workflow.md#create-prefix-mapping-parameters) und [Konfigurieren Sie Cache-Mapping-Parameter ohne Pull-Through-Cache](create-private-workflow.md#create-non-ptc-mapping-parameters).

Der Lauf verwendet die Registrierungsübersicht des Workflows oder der Workflow-Version, den Sie ausführen, sodass Sie nichts hinzufügen `StartRun`.

## Bildzuordnungen
<a name="ecr-pull-through-mapping-format"></a>

Sie definieren Image-Zuordnungen zur Zuordnung zwischen den Image-Namen, wie sie in Ihren privaten Amazon ECR-Workflows definiert sind, und den Image-Namen in der Upstream-Registrierung.

Sie können Image-Zuordnungen mit Registries verwenden, die Amazon ECR Pull Through-Cache-Unterstützungen wie Quay unterstützt, und mit Registrierungen, die Pull-Through-Cache nicht unterstützen, wie Seqera. HealthOmics kopiert keine Bilder für Image-Zuordnungen, sodass Sie Ihr privates Repository selbst mit der Upstream-Registrierung synchronisieren.

**Anmerkung**  
Eine Image-Zuordnung hat Vorrang vor Registrierungszuordnungen.

Das folgende Beispiel zeigt Zuordnungen von privaten Amazon ECR-Images zu einem öffentlichen Genomics-Image und dem neuesten Ubuntu-Image.

```
{
    "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"
        }
    ]
}
```

Weitere Informationen zur Verwendung von Registrierungs- und Image-Zuordnungen beim Erstellen eines Workflows finden Sie unter [Konfigurieren Sie die Parameter für die Pull-through-Cache-Zuordnung](create-private-workflow.md#create-prefix-mapping-parameters).