View a markdown version of this page

Hängen Sie ein benutzerdefiniertes SageMaker Bild an - Amazon SageMaker KI
Anfügen einer Image-Version an Ihre Domain mithilfe der KonsoleHängen Sie eine vorhandene Image-Version an Ihre Domain an. Verwenden Sie dazu AWS CLI

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 ebenfalls 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 zwar das Erstellen von Ressourcen erlaubt, das Taggen jedoch nicht zulässt, können AccessDenied "“ -Fehler auftreten, wenn versucht wird, Ressourcen zu erstellen. Weitere Informationen finden Sie unter Stellen Sie Berechtigungen für das Taggen von SageMaker KI-Ressourcen bereit.

AWS verwaltete Richtlinien für Amazon AI SageMakerdie Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, enthalten bereits Berechtigungen zum Hinzufügen von Tags bei der Erstellung dieser Ressourcen.

Diese Anleitung zeigt, wie Sie mithilfe der AI-Konsole oder der AWS Command Line Interface (AWS CLI) ein benutzerdefiniertes RStudio-Image an Ihre Amazon SageMaker 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 Dropdown-Liste Image auswählen verfügbar. Sie verwenden die Dropdown-Liste, um das von RStudio verwendete Image zu ändern.

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.

Anfügen einer Image-Version an Ihre Domain mithilfe der Konsole

Sie können Ihrer Domain über das Control Panel der SageMaker AI-Konsole eine benutzerdefinierte SageMaker Image-Version 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/.

  2. Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.

  3. Wählen Sie unter Admin-Konfigurationen Domains aus.

  4. Wählen Sie die gewünschte Domain aus.

  5. Wählen Sie Environment (Umgebung) aus.

  6. Wählen Sie unter Custom SageMaker Studio Classic-Bilder, die an die Domain angehängt sind, die Option Bild anhängen aus.

  7. Wählen Sie für Image-Quelle die Option Bestehendes Image oder Neues Imageaus.

    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 im selben Konto wie Ihre Domain befinden, oder es müssen kontoübergreifende Berechtigungen für SageMaker KI aktiviert sein.

  8. Wählen Sie einen vorhandenen Benutzer aus der Liste aus.

  9. Wählen Sie eine Version des Images aus der Liste aus.

  10. Wählen Sie Weiter aus.

  11. Geben Sie Werte für Image-Name, Image-Anzeigename und Beschreibung ein.

  12. Wählen Sie die IAM-Rolle. Weitere Informationen finden Sie unter Erstellen Sie ein benutzerdefiniertes RStudio-Image.

  13. (Optional) Fügen Sie Tags für das Image hinzu.

  14. (Optional) Wählen Sie Neues Tag hinzufügen und fügen Sie dann ein Konfigurations-Tag hinzu.

  15. Wählen Sie als Image-Typ RStudio Image aus.

  16. 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 vorhandene Image-Version an Ihre Domain an. Verwenden Sie dazu 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 RStudio neu.

Hängen Sie das SageMaker Bild an eine neue Domain an

Um diese Methode zu verwenden, müssen Sie eine Ausführungsrolle angeben, an die die 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 Subnetz-IDs.

  • Erstellen Sie die Konfigurationsdatei für die Domain, die das Image spezifiziert.

  • Erstellen Sie die Domain mit der Konfigurationsdatei.

Um das benutzerdefinierte SageMaker Bild 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

  2. Rufen Sie Ihre Standard-Subnetz-IDs ab, indem Sie die VPC-ID aus dem vorherigen Schritt verwenden.

    aws ec2 describe-subnets \
    --filters Name=vpc-id,Values=<vpc-id> \
    --query "Subnets[*].SubnetId" --output json

    Antwort:

    [
    "subnet-b55171dd",
    "subnet-8a5f99c6",
    "subnet-e88d1392"
]

  3. Erstellen Sie eine Konfigurationsdatei namens create-domain-input.json. Fügen Sie die VPC-ID, die Subnetz-IDs ImageName und AppImageConfigName aus den vorherigen Schritten ein. 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 erfüllen.

    {
  "DomainName": "domain-with-custom-r-image",
  "VpcId": "<vpc-id>",
  "SubnetIds": [
    "<subnet-ids>"
  ],
  "DomainSettings": {
    "RStudioServerProDomainSettings": {
      "DomainExecutionRoleArn": "<execution-role>"
    }
  },
  "DefaultUserSettings": {
    "ExecutionRole": "<execution-role>",
    "RSessionAppSettings": {
      "CustomImages": [
        {
         "AppImageConfigName": "rstudio-custom-config",
         "ImageName": "rstudio-custom-image"
        }
      ]
     }
  },
  "AuthMode": "IAM"
}

  4. Erstellen Sie die Domain mit dem angehängten benutzerdefinierten SageMaker Bild.

    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 Übersicht über die Amazon SageMaker AI-Domain.

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.

Gehen Sie wie folgt vor, um das SageMaker Bild zu Ihrer aktuellen Domain hinzuzufügen.

  • Hol dir deine DomainID von der SageMaker KI-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/.

  2. Wählen Sie im linken Navigationsbereich Admin-Konfigurationen.

  3. Wählen Sie unter Admin-Konfigurationen Domains aus.

  4. Wählen Sie die gewünschte Domain aus.

  5. Wählen Sie Domaineinstellungen aus.

  6. Suchen Sie unter Allgemeine Einstellungen nach der Domain-ID. Die ID hat das folgende Format: d-xxxxxxxxxxxx.

  7. Verwenden Sie die Domain-ID, um die Beschreibung der Domain abzurufen.

    aws sagemaker describe-domain \
    --domain-id <d-xxxxxxxxxxxx>

    Antwort:

    {
    "DomainId": "d-xxxxxxxxxxxx",
    "DefaultUserSettings": {
      "KernelGatewayAppSettings": {
        "CustomImages": [
        ],
        ...
      }
    }
}

  8. Speichern Sie den DefaultUserSettings Abschnitt der Antwort in einer Datei mit dem Namen update-domain-input.json.

  9. 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"
              }
           ]
        }
    }
}

  10. Verwenden Sie die Domain-ID und die Datei mit den Standardbenutzereinstellungen, um Ihre Domain zu aktualisieren.

    aws sagemaker update-domain \
    --domain-id <d-xxxxxxxxxxxx> \
    --cli-input-json file://update-domain-input.json

    Antwort:

    {
    "DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}

  11. 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 <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default

  12. Erstellen Sie eine neue RStudioServerPro-Anwendung. Sie müssen diese Anwendung mit Hilfe von AWS CLI erstellen.

    aws sagemaker create-app \
    --domain-id <d-xxxxxxxxxxxx> --user-profile-name domain-shared \
    --app-type RStudioServerPro --app-name default