As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie um domínio Amazon SageMaker AI com o RStudio usando o AWS CLI
<a name="rstudio-create-cli"></a>

**Importante**  
As políticas personalizadas do IAM que permitem que o Amazon SageMaker Studio ou o Amazon SageMaker Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permite que o Studio e o Studio Classic criem recursos, mas não permitem a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte [Forneça permissões para marcar recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).  
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.

O tópico a seguir mostra como se integrar ao domínio Amazon SageMaker AI com o RStudio ativado usando o. AWS CLI Para embarcar usando o Console de gerenciamento da AWS, consulte[Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md). 

## Pré-requisitos
<a name="rstudio-create-cli-prerequisites"></a>
+  Instalar e configurar a [versão 2 do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) 
+  Configure o [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)com credenciais do IAM 

## Criar função do `DomainExecution`
<a name="rstudio-create-cli-domainexecution"></a>

Para iniciar a aplicação RStudio, você deve fornecer uma função `DomainExecution`. Essa função é usada para determinar se o RStudio precisa ser lançado como parte da criação do domínio Amazon SageMaker AI. Essa função também é usada pela Amazon SageMaker AI para acessar a licença do RStudio e enviar os registros do RStudio.  

**nota**  
A `DomainExecution` função deve ter pelo menos AWS License Manager permissões para acessar a Licença RStudio e CloudWatch permissões para enviar registros em sua conta.

O procedimento a seguir mostra como criar a função `DomainExecution` com o AWS CLI. 

1.  Crie um arquivo chamado `assume-role-policy.json` com o conteúdo a seguir. 

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Action": "sts:AssumeRole",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "sagemaker.amazonaws.com"
                   ]
               }
           }
       ]
   }
   ```

------

1.  Crie a função `DomainExecution`. `<REGION>` deve ser a região da AWS na qual lançar seu domínio. 

   ```
   aws iam create-role --region {{<REGION>}} --role-name DomainExecution --assume-role-policy-document file://assume-role-policy.json
   ```

1. Crie um arquivo chamado `domain-setting-policy.json` com o conteúdo a seguir. Essa política permite que o RStudioServerPro aplicativo acesse os recursos necessários e permite que a Amazon SageMaker AI inicie automaticamente um RStudioServerPro aplicativo quando o RStudioServerPro aplicativo existente estiver no `Failed` status `Deleted` ou.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "VisualEditor0",
               "Effect": "Allow",
               "Action": [
                   "license-manager:ExtendLicenseConsumption",
                   "license-manager:ListReceivedLicenses",
                   "license-manager:GetLicense",
                   "license-manager:CheckoutLicense",
                   "license-manager:CheckInLicense",
                   "logs:CreateLogDelivery",
                   "logs:CreateLogGroup",
                   "logs:CreateLogStream",
                   "logs:DeleteLogDelivery",
                   "logs:Describe*",
                   "logs:GetLogDelivery",
                   "logs:GetLogEvents",
                   "logs:ListLogDeliveries",
                   "logs:PutLogEvents",
                   "logs:PutResourcePolicy",
                   "logs:UpdateLogDelivery",
                   "sagemaker:CreateApp"
               ],
               "Resource": "*"
           }
       ]
   }
   ```

------

1.  Crie a política de configuração de domínio anexada à função `DomainExecution`. Fique atento ao `PolicyArn` da resposta, pois você precisará inserir esse ARN nas etapas a seguir. 

   ```
   aws iam create-policy --region {{<REGION>}} --policy-name domain-setting-policy --policy-document file://domain-setting-policy.json
   ```

1.  Anexe `domain-setting-policy` à função `DomainExecution`. Use o `PolicyArn` retornado na etapa anterior.

   ```
   aws iam attach-role-policy --role-name DomainExecution --policy-arn {{<POLICY_ARN>}}
   ```

## Crie um domínio Amazon SageMaker AI com o aplicativo RStudio
<a name="rstudio-create-cli-domain"></a>

O RStudioServerPro aplicativo é iniciado automaticamente quando você cria um domínio do Amazon SageMaker AI usando o comando `create-domain` CLI com o `RStudioServerProDomainSettings` parâmetro especificado. Ao lançar o RStudioServerPro aplicativo, o Amazon SageMaker AI verifica se há uma licença válida do RStudio na conta e falha na criação do domínio se a licença não for encontrada. 

A criação de um domínio do Amazon SageMaker AI difere com base no método de autenticação e no tipo de rede. Essas opções devem ser usadas em conjunto com um método de autenticação e um tipo de conexão de rede selecionados. Para obter mais informações sobre os requisitos para criar um novo domínio, consulte [ CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html). 

Os seguintes métodos de autenticação são compatíveis:
+  `IAM Auth` 
+  `SSO Auth` 

Os seguintes tipos de conexão de rede são compatíveis:
+  `PublicInternet` 
+  `VPCOnly` 

### Métodos de autenticação
<a name="rstudio-create-cli-domain-auth"></a>

 **Modo de autenticação do IAM** 

A seguir, mostramos como criar um domínio Amazon SageMaker AI com o RStudio ativado e um tipo de `IAM Auth` rede. Para obter mais informações sobre AWS Identity and Access Management, consulte [ O que é IAM? ](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html).
+ `DomainExecutionRoleArn` deve ser o ARN da função criada na etapa anterior.
+ `ExecutionRole`é o ARN da função atribuída aos usuários no domínio Amazon SageMaker AI.
+ `vpc-id` deve ser a ID da Nuvem Privada Virtual da Amazon. `subnet-ids` deve ser uma lista de IDs de sub-rede separada por espaços. Para obter mais informações sobre `vpc-id` e `subnet-ids`, consulte [VPCs e sub-redes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl` e `RStudioConnectUrl` são opcionais e devem ser definidos para os URLs do seu RStudio Package Manager e servidor RStudio Connect, respectivamente.
+ `app-network-access-type` deve ser `PublicInternetOnly` ou `VPCOnly`.

```
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>}}
```

 **Autenticação usando o IAM Identity Center** 

A seguir, mostramos como criar um domínio Amazon SageMaker AI com o RStudio ativado e um tipo de `SSO Auth` rede. Centro de Identidade do AWS IAM deve estar habilitado para a região em que o domínio foi lançado. Para obter mais informações sobre o IAM Identity Center, consulte [ O que é Centro de Identidade do AWS IAM? ](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html).
+ `DomainExecutionRoleArn` deve ser o ARN da função criada na etapa anterior.
+ `ExecutionRole`é o ARN da função atribuída aos usuários no domínio Amazon SageMaker AI.
+ `vpc-id` deve ser a ID da Nuvem Privada Virtual da Amazon. `subnet-ids` deve ser uma lista de IDs de sub-rede separada por espaços. Para obter mais informações sobre `vpc-id` e `subnet-ids`, consulte [VPCs e sub-redes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl` e `RStudioConnectUrl` são opcionais e devem ser definidos para os URLs do seu RStudio Package Manager e servidor RStudio Connect, respectivamente.
+ `app-network-access-type` deve ser `PublicInternetOnly` ou `VPCOnly`.

```
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>}}
```

### Tipos de conexão
<a name="rstudio-create-cli-domain-connection"></a>

 **PublicInternet/Direct Tipo de rede de Internet ** 

A seguir, mostramos como criar um domínio Amazon SageMaker AI com o RStudio ativado e um tipo de `PublicInternet` rede.
+ `DomainExecutionRoleArn` deve ser o ARN da função criada na etapa anterior.
+ `ExecutionRole`é o ARN da função atribuída aos usuários no domínio Amazon SageMaker AI.
+ `vpc-id` deve ser a ID da Nuvem Privada Virtual da Amazon. `subnet-ids` deve ser uma lista de IDs de sub-rede separada por espaços. Para obter mais informações sobre `vpc-id` e `subnet-ids`, consulte [VPCs e sub-redes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
+ `RStudioPackageManagerUrl` e `RStudioConnectUrl` são opcionais e devem ser definidos para os URLs do seu RStudio Package Manager e servidor RStudio Connect, respectivamente.
+ `auth-mode` deve ser `SSO` ou `IAM`.

```
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
```

 **Modo VPCOnly** 

A seguir, mostramos como iniciar um domínio Amazon SageMaker AI com o RStudio ativado e um tipo de `VPCOnly` rede. Para obter mais informações sobre como usar o tipo `VPCOnly` de acesso à rede, consulte [Conectar os cadernos do Studio em uma VPC para recursos externos](studio-notebooks-and-internet-access.md).
+ `DomainExecutionRoleArn` deve ser o ARN da função criada na etapa anterior.
+ `ExecutionRole`é o ARN da função atribuída aos usuários no domínio Amazon SageMaker AI.
+ `vpc-id` deve ser a ID da Nuvem Privada Virtual da Amazon. `subnet-ids` deve ser uma lista de IDs de sub-rede separada por espaços. Sua sub-rede privada deve ser capaz de acessar a Internet para fazer uma chamada para o Amazon SageMaker AI AWS License Manager e/ou ter endpoints Amazon VPC para Amazon SageMaker AI e. AWS License Manager Para obter informações sobre endpoints da Amazon VPC, consulte [Interface dos endpoints da Amazon VPC](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html). Para obter informações sobre `vpc-id` e `subnet-ids`, consulte [VPCs e sub-redes.](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html) 
+ `SecurityGroups`deve permitir o acesso externo à SageMaker IA e aos AWS License Manager endpoints da Amazon.
+ `auth-mode` deve ser `SSO` ou `IAM`.

**nota**  
Ao usar endpoints da nuvem privada virtual da Amazon, o grupo de segurança anexado aos endpoints da sua nuvem privada virtual Amazon deve permitir o tráfego de entrada vindo do grupo de segurança que você passa como parte do parâmetro `domain-setting` da chamada da CLI `create-domain`.

Com o RStudio, o Amazon SageMaker AI gerencia grupos de segurança para você. Isso significa que o Amazon SageMaker AI gerencia as regras do grupo de segurança para garantir que o RSessions possa acessar RStudioServerPro os aplicativos. O Amazon SageMaker AI cria uma regra de grupo de segurança por perfil de usuário.

```
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
```

Nota: O RStudioServerPro aplicativo é iniciado por um perfil de usuário especial chamado`domain-shared`. Como resultado, esse aplicação não é retornado como parte das chamadas de API `list-app` por nenhum outro perfil de usuário. 

Talvez seja necessário aumentar a cota do Amazon VPC em sua conta para aumentar o número de usuários. Para obter mais informações, consulte as [Amazon VPC cotas](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html#vpc-limits-security-groups). 

## Verifique a criação do domínio
<a name="rstudio-create-cli-domain-verify"></a>

Use o comando a seguir para verificar se seu domínio foi criado com um `Status` de `InService`. Seu `domain-id` é anexado ao ARN do domínio. Por exemplo, .`arn:aws:sagemaker:{{<REGION>}}:{{<ACCOUNT_ID>}}:domain/{{<DOMAIN_ID>}}`

```
aws sagemaker describe-domain --domain-id {{<DOMAIN_ID>}} --region {{<REGION>}}
```