기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용하여 RStudio로 Amazon SageMaker AI 도메인 생성 AWS CLI

다음 주제에서는를 사용하여 RStudio가 활성화된 Amazon SageMaker AI 도메인에 온보딩하는 방법을 보여줍니다 AWS CLI. 를 사용하여 온보딩하려면 섹션을 AWS Management Console참조하세요Amazon SageMaker AI 도메인 개요.

사전 조건

DomainExecution 역할 생성

RStudio 앱을 시작하려면 DomainExecution 먼저 역할을 제공해야 합니다. 이 역할은 Amazon SageMaker AI 도메인 생성의 일부로 RStudio를 시작해야 하는지 여부를 결정하는 데 사용됩니다. 또한이 역할은 Amazon SageMaker AI에서 RStudio 라이선스에 액세스하고 RStudio 로그를 푸시하는 데 사용됩니다. 

다음 절차는 AWS CLI를 활용하여 DomainExecution 역할을 생성하는 방법을 보여줍니다.

RStudio 앱을 사용하여 Amazon SageMaker AI 도메인 생성

RStudioServerProDomainSettings 파라미터가 지정된 create-domain CLI 명령을 사용하여 Amazon SageMaker AI 도메인을 생성하면 RStudioServerPro 앱이 자동으로 시작됩니다. RStudioServerPro 앱을 시작할 때 Amazon SageMaker AI는 계정에서 유효한 RStudio 라이선스를 확인하고 라이선스를 찾을 수 없는 경우 도메인 생성에 실패합니다.

Amazon SageMaker AI 도메인 생성은 인증 방법과 네트워크 유형에 따라 다릅니다. 인증 방법 하나와 네트워크 연결 유형 하나를 선택하여 이러한 옵션을 함께 사용해야 합니다. 새 도메인을 만들기 위한 요구 사항에 대한 자세한 내용은 CreateDomain을 참고하세요.

지원되는 인증 방법은 다음과 같습니다.

다음과 같은 네트워크 연결 유형이 지원됩니다.

인증 방법

IAM 인증 모드

다음은 RStudio가 활성화되고 IAM Auth 네트워크 유형이 있는 Amazon SageMaker AI 도메인을 생성하는 방법을 보여줍니다. 에 대한 자세한 내용은 IAM이란 무엇입니까?를 AWS Identity and Access Management참조하세요.

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>

IAM Identity Center를 사용한 인증

다음은 RStudio가 활성화된 Amazon SageMaker AI 도메인과 SSO Auth Network Type을 생성하는 방법을 보여줍니다. 도메인이 시작되는 리전에 대해를 활성화해야 AWS IAM Identity Center 합니다. IAM Identity Center에 대한 자세한 내용은 란 무엇입니까 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>

연결 유형

공용 인터넷/다이렉트 인터넷 네트워크 유형

다음은 RStudio가 활성화되고 PublicInternet 네트워크 유형이 있는 Amazon SageMaker AI 도메인을 생성하는 방법을 보여줍니다.

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

VPN 전용 모드

다음은 RStudio가 활성화되고VPCOnly 네트워크 유형이 있는 Amazon SageMaker AI 도메인을 시작하는 방법을 보여줍니다. VPCOnly 네트워크 액세스 유형 사용에 대한 자세한 내용은 VPC의 Studio 노트북을 외부 리소스에 연결을 참고하세요.

RStudio를 사용하면 Amazon SageMaker AI가 보안 그룹을 관리합니다. 즉, Amazon SageMaker AI는 RSessions가 RStudioServerPro 앱에 액세스할 수 있도록 보안 그룹 규칙을 관리합니다. Amazon SageMaker AI는 사용자 프로필당 하나의 보안 그룹 규칙을 생성합니다.

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

참고: RStudioServerPro 앱은 이름이 domain-shared으로 지정된 특수 사용자 프로필에 의해 실행됩니다. 따라서 다른 사용자 프로필에서 list-app API 직접 호출의 일부로 이 앱을 반환하지 않습니다.

사용자 수를 늘리려면 사용자 계정의 Amazon VPC 할당량을 늘려야 할 수도 있습니다. 자세한 내용은 Amazon VPC할당량을 참조하세요.

도메인 생성 확인

다음 명령을 사용하여 도메인이 InService의 Status로 생성되었는지 확인합니다. domain-id가 도메인 ARN에 추가됩니다. 예: arn:aws:sagemaker:<REGION>:<ACCOUNT_ID>:domain/<DOMAIN_ID>.

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