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.

# Benutzerdefinierte Image-Daten
<a name="studio-updated-byoi-specs"></a>

Das Image, das Sie in Ihrer Dockerfile-Datei angeben, muss den Spezifikationen in den folgenden Abschnitten entsprechen, damit das Image erfolgreich erstellt werden kann.

**Topics**
+ [Das Image wird ausgeführt](#studio-updated-byoi-specs-run)
+ [Spezifikationen für den Benutzer und das Dateisystem](#studio-updated-byoi-specs-user-and-filesystem)
+ [Zustandsprüfung und URL für Anwendungen](#studio-updated-byoi-specs-app-healthcheck)
+ [Dockerfile-Beispiele](#studio-updated-byoi-specs-dockerfile-templates)

## Das Image wird ausgeführt
<a name="studio-updated-byoi-specs-run"></a>

Die folgenden Konfigurationen können vorgenommen werden, indem Sie Ihre [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ContainerConfig.html) aktualisieren. Ein Beispiel finden Sie unter [Aktualisieren der Container-Konfiguration](studio-updated-byoi-how-to-container-configuration.md).
+ `Entrypoint`: Sie können `ContainerEntrypoint` und `ContainerArguments` konfigurieren, die zur Laufzeit an den Container übergeben werden. Wir empfehlen, Ihren Einstiegspunkt mithilfe der `ContainerConfig` zu konfigurieren. Ein Beispiel finden Sie unter dem obigen Link.
+ `EnvVariables`: Wenn Sie Studio verwenden, können Sie benutzerdefinierte `ContainerEnvironment`-Variablen für Ihren Container festlegen. Sie können Ihre Umgebungsvariablen optional mit `ContainerConfig` aktualisieren. Ein Beispiel finden Sie unter dem obigen Link.

  SageMaker KI-spezifische Umgebungsvariablen haben Vorrang und überschreiben alle Variablen mit demselben Namen. SageMaker KI stellt beispielsweise automatisch Umgebungsvariablen mit dem Präfix `AWS_` und bereit, `SAGEMAKER_` um eine korrekte Integration mit AWS Diensten und SageMaker KI-Funktionen sicherzustellen. Im Folgenden finden Sie einige Beispiele für SageMaker KI-spezifische Umgebungsvariablen:
  + `AWS_ACCOUNT_ID`
  + `AWS_REGION`
  + `AWS_DEFAULT_REGION`
  + `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`
  + `SAGEMAKER_SPACE_NAME`
  + `SAGEMAKER_APP_TYPE`

## Spezifikationen für den Benutzer und das Dateisystem
<a name="studio-updated-byoi-specs-user-and-filesystem"></a>
+ `WorkingDirectory`: Das Amazon-EBS-Volume für Ihren Bereich ist unter dem Pfad `/home/sagemaker-user` gemountet. Sie können den Mount-Pfad nicht ändern. Verwenden Sie die `WORKDIR`-Anleitung, um das Arbeitsverzeichnis Ihres Images auf einen Ordner innerhalb von `/home/sagemaker-user` festzulegen.
+ `UID`: Die Benutzer-ID des Docker-Containers. UID=1000 ist ein unterstützter Wert. Sie können Ihren Benutzern sudo-Zugriff hinzufügen. Sie IDs werden neu zugeordnet, um zu verhindern, dass ein im Container ausgeführter Prozess mehr Rechte als nötig hat.
+ `GID`: Die Gruppen-ID des Docker-Containers. GID=100 ist ein unterstützter Wert. Sie können Ihren Benutzern sudo-Zugriff hinzufügen. Sie IDs werden neu zugeordnet, um zu verhindern, dass ein im Container ausgeführter Prozess mehr Rechte als nötig hat.
+ Metadaten-Verzeichnisse — Die `/opt/ml` Verzeichnisse `/opt/.sagemakerinternal` und, die von AWS verwendet werden. Die Metadatendatei in `/opt/ml` enthält Metadaten zu Ressourcen wie `DomainId`.

  Verwenden Sie den folgenden Befehl, um den Inhalt des Dateisystems anzuzeigen:

  ```
  cat /opt/ml/metadata/resource-metadata.json
  ```
+ Protokollverzeichnisse: `/var/log/studio` sind für die Protokollverzeichnisse Ihrer Anwendungen und die damit verbundenen Erweiterungen reserviert. Es wird empfohlen, diese Ordner nicht bei der Erstellung Ihres Images zu verwenden.

## Zustandsprüfung und URL für Anwendungen
<a name="studio-updated-byoi-specs-app-healthcheck"></a>

Die Zustandsprüfung und die URL hängen von den Anwendungen ab. Wählen Sie den folgenden Link aus, der mit der Anwendung verknüpft ist, für die Sie das Image erstellen.
+ [Zustandsprüfung und URL für Anwendungen](code-editor-custom-images.md#code-editor-custom-images-app-healthcheck) für Code Editor
+ [Zustandsprüfung und URL für Anwendungen](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-admin-guide-custom-images-app-healthcheck) für JupyterLab

## Dockerfile-Beispiele
<a name="studio-updated-byoi-specs-dockerfile-templates"></a>

Dockerfile-Beispiele, die sowohl die Anforderungen auf dieser Seite als auch Ihre spezifischen Anwendungsanforderungen erfüllen, finden Sie unter den Beispiel-Dockerfiles im Abschnitt der jeweiligen Anwendung. Die folgenden Optionen beinhalten Amazon SageMaker Studio-Anwendungen. 
+ [Dockerfile-Beispiele](code-editor-custom-images.md#code-editor-custom-images-dockerfile-templates) für Code Editor
+ [Dockerfile-Beispiele](studio-updated-jl-admin-guide-custom-images.md#studio-updated-jl-custom-images-dockerfile-templates)für JupyterLab

**Anmerkung**  
Wenn Sie Ihr eigenes Image in SageMaker Unified Studio verwenden, müssen Sie die [Dockerfile-Spezifikationen](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html) im *Amazon SageMaker Unified Studio-Benutzerhandbuch* befolgen.  
`Dockerfile`Beispiele für SageMaker Unified Studio finden Sie im [Dockerfile-Beispiel](https://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/byoi-specifications.html#byoi-specifications-example) im *Amazon SageMaker Unified Studio-Benutzerhandbuch*.