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 eine Amazon SageMaker AI-Domain RStudio mit dem AWS CLI

Das folgende Thema zeigt, wie Sie mit RStudio aktiviertem eine Amazon SageMaker AI-Domain einbinden können AWS CLI. Informationen zum Onboarding mit dem AWS Management Console finden Sie unterÜberblick über die Amazon SageMaker AI-Domain.

Voraussetzungen

Erstellen einer DomainExecution-Rolle

Um die RStudio App zu starten, müssen Sie eine DomainExecution Rolle angeben. Diese Rolle wird verwendet, um zu bestimmen, ob sie im Rahmen der Amazon SageMaker AI-Domainerstellung gestartet werden RStudio muss. Diese Rolle wird auch von Amazon SageMaker AI für den Zugriff auf die RStudio Lizenz und die RStudio Push-Protokolle verwendet. 

Das folgende Verfahren zeigt, wie Sie die DomainExecution Rolle mit dem AWS CLI erstellen.

Amazon SageMaker AI-Domain mit RStudio App erstellen

Die RStudio ServerPro App wird automatisch gestartet, wenn Sie eine Amazon SageMaker AI-Domain mithilfe des create-domain CLI-Befehls mit dem angegebenen RStudioServerProDomainSettings Parameter erstellen. Beim Starten der RStudio ServerPro App sucht Amazon SageMaker AI nach einer gültigen RStudio Lizenz im Konto und schlägt die Domain-Erstellung fehl, wenn die Lizenz nicht gefunden wird.

Die Erstellung einer Amazon SageMaker AI-Domain unterscheidet sich je nach Authentifizierungsmethode und Netzwerktyp. Diese Optionen müssen zusammen verwendet werden, wobei eine Authentifizierungsmethode und ein Netzwerkverbindungstyp ausgewählt werden müssen. Weitere Informationen zu den Anforderungen für die Erstellung einer neuen Domain finden Sie unter CreateDomain.

Die folgenden Authentifizierungsmethoden werden unterstützt.

Die folgenden Netzwerkverbindungstypen werden unterstützt:

Authentifizierungsmethoden

IAM-Authentifizierungsmodus

Im Folgenden wird gezeigt, wie Sie eine Amazon SageMaker AI-Domain mit RStudio aktiviertem und einem IAM Auth Netzwerktyp erstellen. Weitere Informationen dazu finden Sie AWS Identity and Access Management unter Was ist IAM? .

aws sagemaker create-domain --region <REGION> --domain-name <DOMAIN_NAME> \
    --auth-mode IAM \
    --default-user-settings ExecutionRole=<DEFAULT_USER_EXECUTIONROLE> \
    --domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<<PACKAGE_MANAGER_URL>,RStudioConnectUrl=<<CONNECT_URL>,DomainExecutionRoleArn=<DOMAINEXECUTION_ROLE_ARN>} \
    --vpc-id <VPC_ID> \
    --subnet-ids <SUBNET_IDS> \
    --app-network-access-type <NETWORK_ACCESS_TYPE>

Authentifizierung mit IAM Identity Center

Im Folgenden wird gezeigt, wie Sie eine Amazon SageMaker AI-Domain mit RStudio aktiviertem und einem SSO Auth Netzwerktyp erstellen. AWS IAM Identity Center muss für die Region aktiviert sein, in der die Domain gestartet wird. Weitere Informationen zu IAM Identity Center finden Sie unter Was ist AWS IAM Identity Center? .

aws sagemaker create-domain --region <REGION> --domain-name <DOMAIN_NAME> \
    --auth-mode SSO \
    --default-user-settings ExecutionRole=<DEFAULT_USER_EXECUTIONROLE> \
    --domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<<PACKAGE_MANAGER_URL>,RStudioConnectUrl=<<CONNECT_URL>,DomainExecutionRoleArn=<DOMAINEXECUTION_ROLE_ARN>} \
    --vpc-id <VPC_ID> \
    --subnet-ids <SUBNET_IDS> \
    --app-network-access-type <NETWORK_ACCESS_TYPE>

Verbindungstypen

PublicInternet/Direkter Internetnetzwerktyp

Im Folgenden wird gezeigt, wie Sie eine Amazon SageMaker AI-Domain mit RStudio aktiviertem und einem PublicInternet Netzwerktyp erstellen.

aws sagemaker create-domain --region <REGION> --domain-name <DOMAIN_NAME> \
    --auth-mode <AUTH_MODE> \
    --default-user-settings ExecutionRole=<DEFAULT_USER_EXECUTIONROLE> \
    --domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<<PACKAGE_MANAGER_URL>,RStudioConnectUrl=<<CONNECT_URL>,DomainExecutionRoleArn=<DOMAINEXECUTION_ROLE_ARN>} \
    --vpc-id <VPC_ID> \
    --subnet-ids <SUBNET_IDS> \
    --app-network-access-type PublicInternetOnly

VPCOnly Modus

Im Folgenden wird gezeigt, wie Sie eine Amazon SageMaker AI-Domain mit RStudio aktiviertem und einem VPCOnly Netzwerktyp starten. Weitere Informationen zur Verwendung des VPCOnly Netzwerkzugriffstyps finden Sie unter Studio-Notebooks in einer VPC mit externen Ressourcen Connect.

Mit RStudio verwaltet Amazon SageMaker AI Sicherheitsgruppen für Sie. Das bedeutet, dass Amazon SageMaker AI Sicherheitsgruppenregeln verwaltet, um sicherzustellen, dass auf RStudio ServerPro Apps zugegriffen RSessions werden kann. Amazon SageMaker AI erstellt eine Sicherheitsgruppenregel pro Benutzerprofil.

aws sagemaker create-domain --region <REGION> --domain-name <DOMAIN_NAME> \
    --auth-mode <AUTH_MODE> \
    --default-user-settings SecurityGroups=<USER_SECURITY_GROUP>,ExecutionRole=<DEFAULT_USER_EXECUTIONROLE> \
    --domain-settings SecurityGroupIds=<DOMAIN_SECURITY_GROUP>,RStudioServerProDomainSettings={DomainExecutionRoleArn=<DOMAINEXECUTION_ROLE_ARN>} \
    --vpc-id <VPC_ID> \
    --subnet-ids "<SUBNET_IDS>" \
    --app-network-access-type VPCOnly --app-security-group-management Service

Hinweis: Die RStudio ServerPro App wird über ein spezielles Benutzerprofil mit dem Namen gestartetdomain-shared. Daher wird diese App nicht als Teil von list-app API-Aufrufen durch andere Benutzerprofile zurückgegeben.

Möglicherweise müssen Sie das Amazon VPC-Kontingent in Ihrem Konto erhöhen, um die Anzahl der Benutzer zu erhöhen. Weitere Informationen finden Sie unter Amazon VPC-Kontingente.

Überprüfen Sie die Domainerstellung

Verwenden Sie den folgenden Befehl, um zu überprüfen, ob Ihre Domain mit einem Status von erstellt wurdeInService. Ihr domain-id wird an den ARN der Domain angehängt. Beispiel, arn:aws:sagemaker:<REGION>:<ACCOUNT_ID>:domain/<DOMAIN_ID>.

aws sagemaker describe-domain --domain-id <DOMAIN_ID> --region <REGION>