Ein benutzerdefiniertes SageMaker Bild anhängen - Amazon SageMaker
Hängen Sie über die Konsole eine Image-Version an Ihre Domain anHängen Sie eine bestehende Image-Version an Ihre Domain an, indem Sie 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.

Ein benutzerdefiniertes SageMaker Bild anhängen

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 auftreten, wenn versucht wird, Ressourcen zu erstellen. Weitere Informationen finden Sie unter Stellen Sie Berechtigungen für das Taggen von Ressourcen SageMaker bereit.

AWS Verwaltete Richtlinien für Amazon SageMakerdie 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 mit der SageMaker Konsole oder der AWS Command Line Interface (AWS CLI) ein benutzerdefiniertes RStudio-Image an Ihre SageMaker Amazon-Domain anhängen.

Um ein benutzerdefiniertes SageMaker Image zu verwenden, müssen Sie ein benutzerdefiniertes RStudio-Image 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.

Hängen Sie über die Konsole eine Image-Version an Ihre Domain an

Sie können über das Control Panel der SageMaker 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 SageMaker Amazon-Konsole unter https://console.aws.amazon.com/sagemaker/.

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

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

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

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

  6. Wählen Sie unter Benutzerdefinierte 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 mit der Domain AWS-Region identisch sein. Das Amazon ECR-Repo muss sich in demselben Konto wie Ihre Domain befinden, oder es SageMaker müssen kontoübergreifende Berechtigungen für 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 bestehende Image-Version an Ihre Domain an, indem Sie AWS CLI

Es werden zwei Methoden vorgestellt, um die Image-Version mithilfe von an Ihre Domain anzuhängen AWS CLI. 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 sich bereits für die Domain angemeldet haben, 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 verwenden zu können, müssen Sie eine Ausführungsrolle angeben, der die AmazonSageMakerFullAccessRichtlinie angehängt ist.

Gehen Sie wie folgt vor, um die Domäne zu erstellen und das benutzerdefinierte SageMaker 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 sich bereits für eine Domain angemeldet haben. Weitere Informationen finden Sie unter SageMaker Amazon-Domain-Übersicht.

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 SageMaker Amazon-Domain.

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

  • Holen Sie sich Ihr DomainID von der SageMaker 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 SageMaker Amazon-Konsole unter https://console.aws.amazon.com/sagemaker/.

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

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

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

  5. Wählen Sie Domain-Einstellungen.

  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