Erstellen Sie ein benutzerdefiniertes RStudio Bild - Amazon SageMaker KI

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.

Erstellen Sie ein benutzerdefiniertes RStudio Bild

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 KI-Ressourcen SageMaker bereit.

AWS verwaltete Richtlinien für Amazon SageMaker AIdie Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, beinhalten bereits Berechtigungen zum Hinzufügen von Tags beim Erstellen dieser Ressourcen.

In diesem Thema wird beschrieben, wie Sie mithilfe der SageMaker AI-Konsole und der ein benutzerdefiniertes RStudio Image erstellen können AWS CLI. Wenn Sie das verwenden AWS CLI, müssen Sie die Schritte von Ihrem lokalen Computer aus ausführen. Die folgenden Schritte funktionieren nicht in Amazon SageMaker Studio Classic.

Wenn Sie ein Image erstellen, erstellt SageMaker AI auch eine erste Image-Version. Die Image-Version repräsentiert ein Container-Image in Amazon Elastic Container Registry (ECR). Das Container-Image muss die Anforderungen erfüllen, damit es verwendet werden kann RStudio. Weitere Informationen finden Sie unter Benutzerdefinierte RStudio Bildspezifikationen.

Informationen zum lokalen Testen Ihres Images und zum Beheben häufig auftretender Probleme finden Sie im SageMaker Studio Custom Image Samples Repo.

Fügen Sie Amazon SageMaker ECR ein KI-kompatibles RStudio Docker-Container-Image hinzu

Gehen Sie wie folgt vor, um ein Docker-Container-Image zu Amazon ECR hinzuzufügen:

  • Erstellen Sie ein Amazon-ECR-Repository.

  • Authentifizieren bei Amazon ECR.

  • Erstellen Sie ein SageMaker KI-kompatibles Docker-Image RStudio .

  • Übertragen Sie das Image in das Amazon ECR-Repository.

Anmerkung

Das Amazon ECR-Repository muss sich in derselben Domain befinden AWS-Region wie Ihre Domain.

So erstellt man ein Docker-Image und fügt es zu Amazon ECR
  1. Erstellen Sie ein Amazon ECR-Repository mit dem AWS CLI. Informationen zum Erstellen des Repositorys mithilfe der Amazon ECR-Konsole finden Sie unter Erstellen eines Repositorys.

    aws ecr create-repository \ --repository-name rstudio-custom \ --image-scanning-configuration scanOnPush=true

    Antwort:

    { "repository": { "repositoryArn": "arn:aws:ecr:us-east-2:acct-id:repository/rstudio-custom", "registryId": "acct-id", "repositoryName": "rstudio-custom", "repositoryUri": "acct-id.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom", ... } }
  2. Authentifizieren Sie sich bei Amazon ECR mit der Repository-URI, die als Antwort vom Befehl create-repository zurückgegeben wird. Stellen Sie sicher, dass die Docker-Anwendung ausgeführt wird. Weitere Informationen finden Sie unter Registrierungsauthentifizierung.

    aws ecr get-login-password | \ docker login --username AWS --password-stdin <repository-uri>

    Antwort:

    Login Succeeded
  3. Erstellen Sie das Docker-Image. Führen Sie im Verzeichnis, das Ihre Docker-Datei enthält, den folgenden Befehl aus.

    docker build .
  4. Kennzeichnen Sie Ihr erstelltes Image mit einem eindeutigen Tag.

    docker tag <image-id> "<repository-uri>:<tag>"
  5. Verschieben Sie das Container-Image in das Amazon ECR-Repository. Weitere Informationen finden Sie unter ImagePushEin Bild übertragen.

    docker push <repository-uri>:<tag>

    Antwort:

    The push refers to repository [<account-id>.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom] r: digest: <digest> size: 3066

Erstellen Sie ein SageMaker Image von der Konsole aus

So erstellen Sie ein Image
  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 die Option Images.

  4. Wählen Sie auf der Seite Benutzerdefinierte Images die Option Image erstellen aus.

  5. Geben Sie als Image-Quelle den Registry-Pfad zum Container-Image in Amazon ECR ein. Der Pfad hat das folgende Format:

    acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest]

  6. Wählen Sie Next.

  7. Geben Sie unter Image-Eigenschaften Folgendes ein:

    • Image-Name – Der Name muss für Ihr Konto im aktuellen AWS-Region eindeutig sein.

    • (Optional) Anzeigename des Images – Der Name, der auf der Domainbenutzeroberfläche angezeigt wird. Wenn nicht angegeben, wird Image name angezeigt.

    • (Optional) Beschreibung – Eine Beschreibung des Images.

    • IAM-Rolle — Der Rolle muss die AmazonSageMakerFullAccessRichtlinie angehängt sein. Verwenden Sie das Dropdown-Menü, um eine der folgenden Optionen zu wählen:

      • Erstellen Sie eine neue Rolle – Geben Sie alle zusätzlichen Amazon Simple Storage Service (Amazon S3) -Buckets an, auf die Ihre Notebook-Benutzer zugreifen sollen. Wenn Sie den Zugriff auf zusätzliche Bereiche nicht zulassen möchten, wählen Sie Keine.

        SageMaker KI ordnet die AmazonSageMakerFullAccess Richtlinie der Rolle zu. Die Rolle ermöglicht Ihren Notebook-Benutzern den Zugriff auf die Amazon-S3-Buckets, die neben den Häkchen aufgeführt sind.

      • Geben Sie einen benutzerdefinierten IAM-Rollennamen ein – Geben Sie den Amazon-Ressourcennamen (ARN) Ihrer IAM-Rolle ein.

      • Bestehende Rolle verwenden – Wählen Sie eine Ihrer vorhandenen Rollen aus der Liste aus.

    • (Optional) Image-Tags – Wählen Sie Neues Tag hinzufügen. Sie können bis zu 50 Tags hinzufügen. Tags können mit der SageMaker AI-Konsole oder der KI-API durchsucht werden. SageMaker Search

  8. Wählen Sie unter Bildtyp die Option RStudio Bild aus.

  9. Wählen Sie Absenden aus.

Das neue Image wird in der Liste Benutzerdefinierte Images angezeigt und kurz hervorgehoben. Nachdem das Image erfolgreich erstellt wurde, können Sie den Namen des Images wählen, um seine Eigenschaften anzuzeigen, oder Version erstellen wählen, um eine weitere Version zu erstellen.

Um eine weitere Image-Version zu erstellen
  1. Wählen Sie Version erstellen in derselben Zeile wie das Image aus.

  2. Geben Sie unter Image-Quelle den Registry-Pfad zum Amazon-ECR-Image ein. Das Bild sollte nicht dasselbe Bild sein, das in einer früheren Version des SageMaker AI-Images verwendet wurde.

Um das benutzerdefinierte Bild in zu verwenden RStudio, müssen Sie es an Ihre Domain anhängen. Weitere Informationen finden Sie unter Hängen Sie ein benutzerdefiniertes SageMaker Bild an.

Erstellen Sie ein Bild aus AWS CLI

In diesem Abschnitt wird gezeigt, wie Sie mit dem ein benutzerdefiniertes SageMaker Amazon-Image erstellen AWS CLI.

Gehen Sie wie folgt vor, um ein SageMaker Bild zu erstellen:

  • Erstellen einer Image VPC

  • Erstellen einer ImageVersion VPC

  • Erstellen einer Konfigurationsdatei

  • Erstellen einer AppImageConfig.

Um die SageMaker Bild-Entitäten zu erstellen
  1. Erstellen Sie ein SageMaker Bild. Der Rolle ARN muss mindestens die AmazonSageMakerFullAccessPolicy Richtlinie angehängt sein.

    aws sagemaker create-image \ --image-name rstudio-custom-image \ --role-arn arn:aws:iam::<acct-id>:role/service-role/<execution-role>

    Antwort:

    { "ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/rstudio-custom-image" }
  2. Erstellen Sie eine SageMaker Image-Version aus dem Image. Übergeben Sie den eindeutigen Tag-Wert, den Sie ausgewählt haben, als Sie das Image an Amazon ECR übertragen haben.

    aws sagemaker create-image-version \ --image-name rstudio-custom-image \ --base-image <repository-uri>:<tag>

    Antwort:

    { "ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-image/1" }
  3. Stellen Sie sicher, dass die Image-Version erfolgreich erstellt wurde.

    aws sagemaker describe-image-version \ --image-name rstudio-custom-image \ --version 1

    Antwort:

    { "ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-custom-image/1", "ImageVersionStatus": "CREATED" }
    Anmerkung

    Wenn die Antwort "ImageVersionStatus": "CREATED_FAILED" lautet, enthält die Antwort auch den Grund für den Fehler. Ein Problem mit Berechtigungen ist eine häufige Fehlerursache. Sie können auch Ihre CloudWatch Amazon-Logs überprüfen. Der Name der Protokollgruppe ist /aws/sagemaker/studio. Der Name des Protokollstroms ist $domainID/$userProfileName/KernelGateway/$appName.

  4. Erstellen Sie eine Konfigurationsdatei mit dem Namen app-image-config-input.json. Die App-Image-Konfiguration wird zur Konfiguration für die Ausführung eines SageMaker Images als Kernel-Gateway-Anwendung verwendet.

    { "AppImageConfigName": "rstudio-custom-config" }
  5. Erstellen Sie das AppImageConfig mit der Datei, die Sie im vorherigen Schritt erstellt haben.

    aws sagemaker create-app-image-config \ --cli-input-json file://app-image-config-input.json

    Antwort:

    { "AppImageConfigArn": "arn:aws:sagemaker:us-east-2:acct-id:app-image-config/r-image-config" }