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.
# Hängen Sie ein benutzerdefiniertes SageMaker Bild an
**Wichtig**
Benutzerdefinierte IAM-Richtlinien, die es Amazon SageMaker Studio oder Amazon SageMaker Studio Classic ermöglichen, SageMaker Amazon-Ressourcen zu erstellen, müssen auch Berechtigungen zum Hinzufügen von Tags zu diesen Ressourcen gewähren. Die Berechtigung zum Hinzufügen von Tags zu Ressourcen ist erforderlich, da Studio und Studio Classic automatisch alle von ihnen erstellten Ressourcen taggen. Wenn eine IAM-Richtlinie Studio und Studio Classic das Erstellen von Ressourcen, aber kein Tagging erlaubt, können "AccessDenied" Fehler beim Versuch, Ressourcen zu erstellen, auftreten. Weitere Informationen finden Sie unter [Erteilen Sie Berechtigungen für das Taggen von SageMaker KI-Ressourcen](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS verwaltete Richtlinien für Amazon SageMaker AI](security-iam-awsmanpol.md)die Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, beinhalten bereits Berechtigungen zum Hinzufügen von Tags beim Erstellen dieser Ressourcen.
Diese Anleitung zeigt, wie Sie mithilfe der SageMaker AI-Konsole oder der AWS Command Line Interface (AWS CLI) ein benutzerdefiniertes RStudio Bild an Ihre Amazon SageMaker AI-Domain anhängen.
Um ein benutzerdefiniertes SageMaker Bild zu verwenden, müssen Sie ein benutzerdefiniertes RStudio Bild an Ihre Domain anhängen. Wenn Sie eine Image-Version anhängen, wird sie im RStudio Launcher angezeigt und ist in der Dropdownliste **Bild auswählen** verfügbar. Sie verwenden das Drop-down-Menü, um das von verwendete Bild zu ändern. RStudio
Es gibt ein Limit für die Anzahl der Imageversionen, die Sie anhängen können. Wenn Sie das Limit erreicht haben, müssen Sie zuerst eine Version trennen, damit Sie eine andere Version des Images anhängen können.
**Topics**
+ [Anfügen einer Image-Version an Ihre Domain mithilfe der Konsole](#rstudio-byoi-attach-console)
+ [Hängen Sie eine bestehende Image-Version an Ihre Domain an, indem Sie den AWS CLI](#rstudio-byoi-attach-cli)
## Anfügen einer Image-Version an Ihre Domain mithilfe der Konsole
Sie können über das Control Panel der SageMaker AI-Konsole eine benutzerdefinierte SageMaker Image-Version an Ihre Domain anhängen. Sie können auch ein benutzerdefiniertes SageMaker Image und eine Image-Version erstellen und diese Version dann an Ihre Domain anhängen.
**Um ein vorhandenes Image anzuhängen**
1. Öffnen Sie die Amazon SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Wählen Sie im linken Navigationsbereich **Admin-Konfigurationen**.
1. Wählen Sie unter **Admin-Konfigurationen** **Domains** aus.
1. Wählen Sie die gewünschte Domain aus.
1. Wählen Sie **Environment** (Umgebung) aus.
1. Wählen Sie unter **Benutzerdefinierte SageMaker Studio Classic-Bilder, die an die Domain angehängt** sind, die Option **Bild anhängen** aus.
1. Wählen Sie für **Image-Quelle** die Option **Bestehendes Image** oder **Neues Image**aus.
Wenn Sie **Existierendes Bild** auswählen, wählen Sie ein Bild aus dem Amazon SageMaker Image Store aus.
Wenn Sie **Neues Image** auswählen, geben Sie den Amazon ECR-Registry-Pfad für Ihr Docker-Image an. Der Pfad muss sich in der gleichen AWS-Region wie die Domain befinden. Das Amazon ECR-Repo muss sich in demselben Konto wie Ihre Domain befinden, oder es müssen kontoübergreifende Berechtigungen für SageMaker KI aktiviert sein.
1. Wählen Sie einen vorhandenen Benutzer aus der Liste aus.
1. Wählen Sie eine Version des Images aus der Liste aus.
1. Wählen Sie **Weiter** aus.
1. Geben Sie Werte für **Image-Name**, **Image-Anzeigename** und **Beschreibung** ein.
1. Wählen Sie die IAM-Rolle. Weitere Informationen finden Sie unter [Erstellen Sie ein benutzerdefiniertes RStudio Bild](rstudio-byoi-create.md).
1. (Optional) Fügen Sie Tags für das Image hinzu.
1. (Optional) Wählen Sie **Neues Tag hinzufügen** und fügen Sie dann ein Konfigurations-Tag hinzu.
1. **Wählen Sie als **Bildtyp** die Option Bild aus. RStudio**
1. Wählen Sie **Absenden** aus.
Warten Sie, bis die Image-Version an die Domain angehängt ist. Nachdem die Version angehängt wurde, wird sie in der Liste der **benutzerdefinierten Images** angezeigt und kurz hervorgehoben.
## Hängen Sie eine bestehende Image-Version an Ihre Domain an, indem Sie den AWS CLI
Es werden zwei Methoden vorgestellt, um die Image-Version mithilfe der AWS CLI an Ihre Domain anzuhängen. Bei der ersten Methode erstellen Sie eine neue Domain mit der angehängten Version. Diese Methode ist einfacher, aber Sie müssen die Informationen und die Ausführungsrolle für Amazon Virtual Private Cloud (Amazon VPC) angeben, die für die Erstellung der Domain erforderlich sind.
Wenn Sie bereits Mitglied der Domain sind, können Sie die zweite Methode verwenden, um die Image-Version an Ihre aktuelle Domain anzuhängen. In diesem Fall müssen Sie die Amazon VPC-Informationen und die Ausführungsrolle nicht festlegen. Nachdem Sie die Version angehängt haben, löschen Sie alle Anwendungen in Ihrer Domain und starten Sie sie neu RStudio.
### Hängen Sie das SageMaker Bild an eine neue Domain an
Um diese Methode verwenden zu können, müssen Sie eine Ausführungsrolle angeben, der die [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)Richtlinie angehängt ist.
Gehen Sie wie folgt vor, um die Domain zu erstellen und das benutzerdefinierte SageMaker AI-Image anzuhängen:
+ Holen Sie sich Ihre Standard-VPC-ID und Ihr IDs Subnetz.
+ Erstellen Sie die Konfigurationsdatei für die Domain, die das Image spezifiziert.
+ Erstellen Sie die Domain mit der Konfigurationsdatei.
**Um das benutzerdefinierte SageMaker Image zu Ihrer Domain hinzuzufügen**
1. Holen Sie sich Ihre Standard-VPC-ID.
```
aws ec2 describe-vpcs \
--filters Name=isDefault,Values=true \
--query "Vpcs[0].VpcId" --output text
```
Antwort:
```
vpc-xxxxxxxx
```
1. Rufen Sie Ihr Standardsubnetz IDs mit der VPC-ID aus dem vorherigen Schritt ab.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values={{}} \
--query "Subnets[*].SubnetId" --output json
```
Antwort:
```
[
"subnet-b55171dd",
"subnet-8a5f99c6",
"subnet-e88d1392"
]
```
1. Erstellen Sie eine Konfigurationsdatei namens `create-domain-input.json`. Fügen Sie die VPC-ID, das Subnetz IDs und `AppImageConfigName` aus den vorherigen Schritten ein. `ImageName` Da `ImageVersionNumber` nicht angegeben ist, wird die neueste Version des Images verwendet, was in diesem Fall die einzige Version ist. Ihre Ausführungsrolle muss die Anforderungen in [Erfüllen der Voraussetzungen](rstudio-byoi-prerequisites.md) erfüllen.
```
{
"DomainName": "domain-with-custom-r-image",
"VpcId": "{{}}",
"SubnetIds": [
"{{}}"
],
"DomainSettings": {
"RStudioServerProDomainSettings": {
"DomainExecutionRoleArn": "{{}}"
}
},
"DefaultUserSettings": {
"ExecutionRole": "{{}}",
"RSessionAppSettings": {
"CustomImages": [
{
"AppImageConfigName": "rstudio-custom-config",
"ImageName": "rstudio-custom-image"
}
]
}
},
"AuthMode": "IAM"
}
```
1. Erstellen Sie die Domain mit dem angehängten benutzerdefinierten SageMaker Image.
```
aws sagemaker create-domain \
--cli-input-json file://create-domain-input.json
```
Antwort:
```
{
"DomainArn": "arn:aws:sagemaker:{{region}}:acct-id:domain/{{domain-id}}",
"Url": "https://{{domain-id}}.studio.{{region}}.sagemaker.aws/..."
}
```
### Hängen Sie das SageMaker Bild an eine bestehende Domain an
Bei dieser Methode wird davon ausgegangen, dass Sie bereits bei der Domain angemeldet sind. Weitere Informationen finden Sie unter [Überblick über die Amazon SageMaker AI-Domain](gs-studio-onboard.md).
**Anmerkung**
Sie müssen alle Anwendungen in Ihrer Domain löschen, um die Domain mit der neuen Image-Version zu aktualisieren. Informationen zum Löschen dieser Anwendungen finden Sie unter [Löschen Sie eine Amazon SageMaker AI-Domain](gs-studio-delete-domain.md).
Gehen Sie wie folgt vor, um das SageMaker Bild zu Ihrer aktuellen Domain hinzuzufügen.
+ Holen Sie sich Ihr `DomainID` von der SageMaker AI-Konsole.
+ Verwenden Sie das `DomainID`, um das `DefaultUserSettings` für die Domain abzurufen.
+ Fügen Sie das `ImageName` und `AppImageConfig` als ein `CustomImage` zum `DefaultUserSettings` hinzu.
+ Aktualisieren Sie Ihre Domain so, dass sie das benutzerdefinierte Image enthält.
**Um das benutzerdefinierte SageMaker Bild zu Ihrer Domain hinzuzufügen**
1. Öffnen Sie die Amazon SageMaker AI-Konsole unter [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Wählen Sie im linken Navigationsbereich **Admin-Konfigurationen**.
1. Wählen Sie unter **Admin-Konfigurationen** **Domains** aus.
1. Wählen Sie die gewünschte Domain aus.
1. Wählen Sie **Domaineinstellungen** aus.
1. Suchen Sie unter **Allgemeine Einstellungen** nach der **Domain-ID**. Die ID hat das folgende Format: `d-xxxxxxxxxxxx`.
1. Verwenden Sie die Domain-ID, um die Beschreibung der Domain abzurufen.
```
aws sagemaker describe-domain \
--domain-id {{}}
```
Antwort:
```
{
"DomainId": "{{d-xxxxxxxxxxxx}}",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Speichern Sie den `DefaultUserSettings` Abschnitt der Antwort in einer Datei mit dem Namen `update-domain-input.json`.
1. Fügen Sie das `ImageName` und `AppImageConfigName` aus den vorherigen Schritten als benutzerdefiniertes Image ein. Da `ImageVersionNumber` nicht angegeben ist, wird die neueste Version des Images verwendet, was in diesem Fall die einzige Version ist.
```
{
"DefaultUserSettings": {
"RSessionAppSettings": {
"CustomImages": [
{
"ImageName": "rstudio-custom-image",
"AppImageConfigName": "rstudio-custom-config"
}
]
}
}
}
```
1. Verwenden Sie die Domain-ID und die Datei mit den Standardbenutzereinstellungen, um Ihre Domain zu aktualisieren.
```
aws sagemaker update-domain \
--domain-id {{}} \
--cli-input-json file://update-domain-input.json
```
Antwort:
```
{
"DomainArn": "arn:aws:sagemaker:{{region}}:acct-id:domain/{{domain-id}}"
}
```
1. Löschen Sie die `RStudioServerPro`-Anwendung. Sie müssen die `RStudioServerPro` gemeinsam genutzte Domainanwendung neu starten, damit die RStudio Launcher-Benutzeroberfläche die neuesten Änderungen übernimmt.
```
aws sagemaker delete-app \
--domain-id {{}} --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
1. Erstellen Sie eine neue `RStudioServerPro`-Anwendung. Sie müssen diese Anwendung mit Hilfe von AWS CLI erstellen.
```
aws sagemaker create-app \
--domain-id {{}} --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```