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á.
# RStudio no gerenciamento de SageMaker IA da Amazon
Os tópicos a seguir fornecem informações sobre o gerenciamento RStudio na Amazon SageMaker AI. Isso inclui informações sobre a configuração do seu RStudio ambiente, sessões de usuário e recursos necessários. Para obter informações sobre como usar RStudio a SageMaker IA, consulte[RStudio no guia do usuário da Amazon SageMaker AI](rstudio-use.md).
Para obter informações sobre como criar um domínio Amazon SageMaker AI com RStudio habilitado, consulte[Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md).
Para obter informações sobre as AWS regiões RStudio nas quais a SageMaker IA é suportada, consulte[Regiões e cotas compatíveis](regions-quotas.md).
**Topics**
+ [
# Obtenha uma RStudio licença
](rstudio-license.md)
+ [
# RStudio Controle de versão
](rstudio-version.md)
+ [
# Rede e armazenamento
](rstudio-network.md)
+ [
# RStudioServerPro tipo de instância
](rstudio-select-instance.md)
+ [
# Adicionar um URL do RStudio Connect
](rstudio-configure-connect.md)
+ [
# Atualizar o URL RStudio do Package Manager
](rstudio-configure-pm.md)
+ [
# Crie um domínio Amazon SageMaker AI RStudio usando o AWS CLI
](rstudio-create-cli.md)
+ [
# Adicionar RStudio suporte a um domínio existente
](rstudio-add-existing.md)
+ [
# Imagens personalizadas RStudio sem SageMaker IA
](rstudio-byoi.md)
+ [
# Crie um usuário para usar RStudio
](rstudio-create-user.md)
+ [
# Faça login RStudio como outro usuário
](rstudio-login-another.md)
+ [
# Encerrar sessões para outro usuário
](rstudio-terminate-another.md)
+ [
# Use o painel RStudio administrativo
](rstudio-admin.md)
+ [
# Desligar RStudio
](rstudio-shutdown.md)
+ [
# Faturamento e custos
](rstudio-billing.md)
+ [
# Diagnostique problemas e obtenha ajuda
](rstudio-troubleshooting.md)
# Obtenha uma RStudio licença
RStudio na Amazon, o SageMaker AI é um produto pago e exige que cada usuário seja licenciado adequadamente. As licenças do RStudio Amazon SageMaker AI podem ser obtidas diretamente da RStudio PBC ou comprando uma assinatura do Posit Workbench no Marketplace. AWS Para clientes existentes do Posit Workbench Enterprise, as licenças são emitidas sem custo adicional. Para usar uma RStudio licença com a Amazon SageMaker AI, você deve primeiro ter uma RStudio licença válida registrada na AWS License Manager. Para licenças adquiridas diretamente por meio do Rstudio PBC, uma concessão de licenças para sua AWS conta deve ser criada. Entre em contato RStudio para compras diretas de licenças ou para habilitar licenças existentes. AWS License Manager Para obter mais informações sobre como registrar uma licença com AWS License Manager, consulte [Licenças emitidas pelo vendedor em AWS License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/seller-issued-licenses.html).
Os tópicos a seguir mostram como adquirir e validar uma licença concedida pela RStudio PBC.
**Obtenha uma RStudio licença**
1. Se você não tiver uma RStudio licença, poderá comprá-la diretamente no AWS Marketplace ou no RStudio PBC.
+ Para comprar uma assinatura no AWS Marketplace, conclua as etapas para [assinar um contrato SaaS](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html) pesquisando **Posit Platform (RStudio **on). SageMaker Para cumprir a licença, você será redirecionado para um formulário externo fora do AWS Marketplace. Você deve fornecer informações adicionais, incluindo o nome da sua empresa e endereço de e-mail. Se você não conseguir acessar esse formulário para fornecer o nome da empresa e um e-mail de contato, crie um ticket com o Posit Support em [https://support.posit. co/hc/en-us/requests/new](https://support.posit.co/hc/en-us/requests/new)com detalhes sobre sua compra.
+ Para comprar diretamente da RStudio PBC, navegue até [RStudio Preços](https://www.rstudio.com/pricing/) ou entre em contato com [sales@rstudio.com.](mailto:sales@rstudio.com) Ao comprar ou atualizar uma RStudio licença, você deve fornecer a AWS Conta que hospedará seu domínio Amazon SageMaker AI.
Se você tiver uma RStudio licença existente, entre em contato com seu representante de RStudio vendas ou [sales@rstudio.com](mailto:sales@rstudio.com) para adicionar o RStudio Amazon SageMaker AI à sua licença existente do Posit Workbench Enterprise ou para converter sua licença do Posit Workbench Standard. O representante RStudio de vendas enviará a você o formulário de pedido eletrônico apropriado.
1. RStudio concede uma licença Posit Workbench à sua AWS Conta AWS License Manager na Região Leste dos EUA (Norte da Virgínia). Embora a RStudio licença seja concedida na região Leste dos EUA (Norte da Virgínia), sua licença pode ser consumida em qualquer AWS região RStudio na qual a Amazon SageMaker AI seja suportada. Você pode esperar que o processo de concessão da licença seja concluído em até três dias úteis após compartilhar o ID AWS da sua conta com RStudio.
1. Quando essa licença for concedida, você receberá um e-mail do seu representante de RStudio vendas com instruções para aceitar a concessão da licença.
**Valide sua RStudio licença para ser usada com a Amazon AI SageMaker **
1. Faça login no AWS License Manager console na mesma região do seu domínio Amazon SageMaker AI. Se você estiver usando AWS License Manager pela primeira vez, AWS License Manager solicita que você conceda permissão de uso AWS License Manager.
1. Selecione **Começar a usar o Gerenciador de AWS licenças**.
1. Selecione `I grant AWS License Manager the required permissions` e, em seguida, **Conceder permissões**.
1. Navegue até **Licenças concedidas** no painel esquerdo.
1. Selecione a concessão da licença com `RSW-SageMaker` como `Product name` e selecione **Visualizar**.
1. Na página de detalhes da licença, selecione **Aceitar e ativar a licença**.
**RStudio painel administrativo**
Você pode usar o painel RStudio administrativo para ver o número de usuários na licença seguindo as etapas em[Use o painel RStudio administrativo](rstudio-admin.md).
# RStudio Controle de versão
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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.
Este guia fornece informações sobre a atualização da `2025.05.1+513.pro3` versão para RStudio o SageMaker AI. A partir de 31 de outubro de 2025, novos domínios com RStudio suporte são criados com a Posit Workbench versão`2025.05.1+513.pro3`. Isso é válido para aplicações `RStudioServerPro` e aplicações padrão `RSessionGateway`.
As seções a seguir fornecem informações sobre a `2025.05.1+513.pro3` versão.
## Atualizações da versão mais recente
A RStudio versão mais recente é`2025.05.1+513.pro3`.
+ Versões do R compatíveis:
+ 4.5.1
+ 4.4.3
+ 4.4.0
+ 4.3.3
+ 4.2.3
+ 4.2.1
+ 4.1.3
+ 4.0.2
Para obter mais informações sobre as alterações nessa liberação, consulte [https://docs.posit.co/ide/news/](https://docs.posit.co/ide/news/).
**nota**
Para garantir a compatibilidade, recomendamos usar RSessions com um prefixo que corresponda à Posit Workbench versão atual.
Se você ver o aviso a seguir, há uma incompatibilidade de versão entre a `RSession` e a Posit Workbench versão usada RStudio no SageMaker AI. Para resolver esse problema, atualize a RStudio versão do domínio. Para obter informações sobre como atualizar a RStudio versão, consulte[Atualizando para a nova versão](rstudio-version-upgrade.md).
```
Session version 2024.04.2+764.pro1 does not match server version 2025.05.1+513.pro3 - this is an unsupported configuration, and you may experience unexpected issues as a result.
```
## Versionamento
Atualmente, existem duas versões do Posit Workbench compatível com SageMaker IA.
+ Versão mais recente: `2025.05.1+513.pro3`
Data de suspensão de uso: 5 de dezembro de 2026
+ Versão anterior: `2024.04.2+764.pro1`
Data de suspensão de uso: 30 de abril de 2026
**nota**
Embora você possa continuar criando novos domínios com a versão mais antiga `2024.04.2+764.pro1` até 30/04/2026 fixando explicitamente a versão ao criar o domínio usando a CLI, é altamente recomendável que os clientes comecem a usar a versão em todos os domínios. `2025.05` A POSIT deixou de fornecer correções de vulnerabilidade para. `2024.04.2+764.pro1`
As versões `2023.03.2-547.pro5` e `2022.02.2-485.pro2` estão obsoletas e não são mais suportadas. Recomendamos que você atualize para o versão mais recente.
A Posit Workbench versão padrão que a SageMaker IA seleciona depende da data de criação do domínio.
+ Para domínios criados após 31 de outubro de 2025, a versão `2025.05.1+513.pro3` é a versão padrão selecionada.
+ Para domínios criados após 04 de setembro de 2024 e antes de 31 de outubro de 2025, a versão `2024.04.2+764.pro1` é a versão padrão selecionada. Você pode atualizar seus domínios para a versão mais recente (`2025.05.1+513.pro3`) configurando-a como a versão padrão do domínio. Para obter mais informações, consulte [Atualizando para a nova versão](rstudio-version-upgrade.md).
**nota**
A versão padrão da aplicação `RSessionGateway` corresponde à versão atual da aplicação `RStudioServerPro`.
A tabela a seguir lista a imagem ARNs das duas versões de cada uma Região da AWS. Eles ARNs são passados como parte de um `update-domain` comando para definir a versão desejada.
| Region | ARN da imagem `2024.04.2+764.pro1` | ARN da imagem `2025.05.1+513.pro3` |
| --- | --- | --- |
| us-east-1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-east-2 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-west-1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| us-west-2 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| af-south-1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-east-1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-south-1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-northeast-2 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-southeast-1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-southeast-2 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ap-northeast-1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| ca-central-1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-central-1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-2 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-west-3 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-north-1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| eu-south-1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2025.05-sagemaker-1.0 |
| sa-east-1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2024.04-sagemaker-1.1 | arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2025.05-sagemaker-1.0 |
### Alterações nas imagens BYOI
Se você usar uma imagem BYOI com RStudio e atualizar sua `RStudioServerPro` versão para`2025.05.1+513.pro3`, deverá atualizar suas imagens personalizadas para usar a `2025.05.1+513.pro3` versão e reimplantar as existentes. RSessions Se você tentar carregar uma imagem não compatível em um domínio RSession de um domínio usando a `2025.05.1+513.pro3` versão, ocorrerá uma RSession falha porque não poderá analisar os parâmetros recebidos. Para evitar falhas, atualize todas as imagens personalizadas implantadas no sua aplicação `RStudioServerPro` existente.
O `RSW_VERSION` in the Dockerfile deve ser consistente com a Posit Workbench versão usada RStudio na SageMaker IA. Você pode validar a versão atual em Posit Workbench. Para fazer isso, use o nome da versão que está localizado no canto inferior esquerdo da página do inicializador Posit Workbench.
```
ARG RSW_VERSION=2025.05.1+513.pro3
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE="1"
ARG RSW_NAME=rstudio-workbench
ARG OS_CODE_NAME=jammy
ARG RSW_DOWNLOAD_URL=https://s3.amazonaws.com/rstudio-ide-build/server/${OS_CODE_NAME}/amd64
RUN RSW_VERSION_URL=`echo -n "${RSW_VERSION}" | sed 's/+/-/g'` \
&& curl -o rstudio-workbench.deb ${RSW_DOWNLOAD_URL}/${RSW_NAME}-${RSW_VERSION_URL}-amd64.deb \
&& gdebi -n ./rstudio-workbench.deb
```
# Atualizando para a nova versão
Os domínios existentes que usam a versão `2024.04.2+764.pro1` podem ser atualizados para a versão `2025.05.1+513.pro3` de duas maneiras:
+ Crie um novo domínio a partir do AWS CLI com RStudio ativado.
+ Atualizar um domínio existente para usar a versão `2025.05.1+513.pro3`.
O procedimento a seguir mostra como excluir o RStudio aplicativo de um domínio existente, definir a `2025.05.1+513.pro3` versão padrão como e criar um RStudio aplicativo.
1. Exclua a aplicação `RStudioServerPro` e todos as aplicações `RSessionGateway` associados ao seu domínio existente. Para obter informações sobre como encontrar sua ID do domínio, consulte [Visualizar domínios](domain-view.md). Para mais informações sobre como excluir aplicações, consulte [Desligar RStudio](rstudio-shutdown.md).
```
aws sagemaker delete-app \
--region region \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Se seu domínio estiver usando a RStudio versão`2024.04.2+764.pro1`, atualize o domínio para `2025.05.1+513.pro3` defini-lo como a Posit Workbench versão padrão. O `SageMakerImageArn` valor no `update-domain` comando a seguir especifica a RStudio `2025.05.1+513.pro3` versão como padrão. Essa ARN deve corresponder ao Region em que o seu domínio está. Para obter uma lista de todos os disponíveis ARNs, consulte[Versionamento](rstudio-version.md#rstudio-version-new).
Aprove uma ARN da função de execução para o domínio que fornece permissões para atualizar o domínio.
```
aws sagemaker update-domain \
--region region \
--domain-id domainId \
--domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2025.05.1+513.pro3-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"
```
1. Crie um nova aplicação `RStudioServerPro` no domínio existente.
```
aws sagemaker create-app \
--region region
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
Seu aplicação `RStudioServerPro` agora está atualizado para a versão `2025.05.1+513.pro3`. Agora você pode reexecutar suas aplicações `RSessionGateway`.
# Faça o downgrade para uma versão anterior
Você pode fazer o downgrade manualmente da versão do seu RStudio aplicativo existente para a `2024.04.2+764.pro1` versão.
**Para fazer o downgrade para uma versão anterior**
1. Exclua a aplicação `RStudioServerPro` que está associado ao seu domínio existente. Para obter informações sobre como encontrar sua ID do domínio, consulte [Visualizar domínios](domain-view.md).
```
aws sagemaker delete-app \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Passe a ARN `2024.04.2+764.pro1` correspondente para a sua Region como parte do comando `update-domain`. Para obter uma lista de todos os disponíveis ARNs, consulte[Versionamento](rstudio-version.md#rstudio-version-new). Você deve também aprovar uma ARN da função de execução para o domínio que fornece permissões para atualizar o domínio.
```
aws sagemaker update-domain \
--region region \
--domain-id domainId \
--domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2024.04.2+764.pro1-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"
```
1. Crie um nova aplicação `RStudioServerPro` no domínio existente. O padrão da RStudio versão é. `2024.04.2+764.pro1`
```
aws sagemaker create-app \
--domain-id domainId \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
Seu aplicação `RStudioServerPro` agora está em downgrade para a versão `2024.04.2+764.pro1`.
# Rede e armazenamento
O tópico a seguir descreve as considerações sobre acesso à rede e armazenamento de dados para sua RStudio instância. Para obter informações gerais sobre acesso à rede e armazenamento de dados ao usar o Amazon SageMaker AI, consulte[Proteção de dados na Amazon SageMaker AI](data-protection.md).
**Volume do Amazon EFS**
RStudio no Amazon SageMaker AI compartilha um volume do Amazon EFS com o aplicativo Amazon SageMaker Studio Classic no domínio. Quando o RStudio aplicativo é adicionado a um domínio, a SageMaker IA cria uma pasta chamada `shared` no diretório do Amazon EFS. Se essa `shared` pasta for excluída ou alterada manualmente, o RStudio aplicativo poderá não funcionar mais. Para obter mais informações sobre volume do Amazon EFS, consulte [Gerencie seu volume de armazenamento do Amazon EFS no Amazon SageMaker Studio Classic](studio-tasks-manage-storage.md).
**Pacotes e scripts instalados**
Os pacotes que você instala de dentro RStudio têm como escopo o nível do perfil do usuário. Isso significa que o pacote instalado persiste durante o RSession desligamento, a reinicialização e a transição RSessions para cada perfil de usuário no qual ele está instalado. Os scripts R que são salvos em RSessions se comportam da mesma maneira. Tanto os pacotes quanto os scripts em R são salvos no volume Amazon EFS do usuário.
**Criptografia**
RStudio na Amazon SageMaker AI oferece suporte à criptografia em repouso.
**Use RStudio no modo somente VPC**
RStudio na Amazon, a SageMaker IA oferece suporte [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-services-overview.html)à integração. Com essa integração, você pode usar a SageMaker IA RStudio no modo somente VPC sem acesso direto à Internet. Quando você usa RStudio no modo somente VPC, seus grupos de segurança são gerenciados automaticamente pelo serviço. Isso inclui conectividade entre você RServer e seu RSessions.
Os itens a seguir são necessários para uso somente RStudio no modo VPC. Para obter mais informações sobre como escolher uma VPC, consulte [Escolha uma Amazon VPC](onboard-vpc.md).
+ Uma sub-rede privada com acesso à Internet para fazer uma chamada para o Amazon SageMaker AI & License Manager ou endpoints da Amazon Virtual Private Cloud (Amazon VPC) para SageMaker Amazon AI e License Manager.
+ O domínio não pode ter mais do que dois grupos de segurança associados.
+ Um ID de grupo de segurança para uso com o domínio nas configurações do domínio. Isso deve permitir todo o acesso externo.
+ Um ID de grupo de segurança para uso com o endpoint da VPC da Amazon. Esse grupo de segurança deve permitir tráfego de entrada a partir da ID do grupo de segurança do domínio.
+ Amazon VPC Endpoint para e. `sagemaker.api` AWS License Manager Ele deve estar na mesma Amazon VPC que a sub-rede privada.
# RStudioServerPro tipo de instância
Ao decidir qual tipo de instância do Amazon EC2 usar para RStudio ServerPro seu aplicativo, o principal fator a ser considerado é a largura de banda. A largura de banda é importante porque a RStudio ServerPro instância é responsável por fornecer a RStudio interface do usuário a todos os usuários. Isso inclui fluxos de trabalho pesados de interface de usuário, como geração de figuras, animações e exibição de várias linhas de dados. Portanto, pode haver alguma degradação do desempenho da interface do usuário, dependendo da workload de todos os usuários. A seguir estão os tipos de instância disponíveis para usar em seu RStudioServerPro. Para obter informações sobre preços sobre essas instâncias, consulte [Amazon SageMaker Pricing](https://aws.amazon.com/sagemaker/pricing/).
+ `system`: esse tipo de instância é recomendado para domínios com uso leve de interface do usuário.
**nota**
O valor `system` é traduzido para `ml.t3.medium`.
+ `ml.c5.4xlarge`: esse tipo de instância é recomendado para domínios com uso moderado de interface do usuário.
+ `ml.c5.9xlarge`: esse tipo de instância é recomendado para domínios com uso pesado de interface do usuário.
**Alteração do tipo de RStudio instância**
Para alterar o tipo de instância da sua RStudioServerPro, transmita o novo tipo de instância como parte de uma chamada para o comando da `update-domain` CLI. Em seguida, você precisa excluir o RStudio ServerPro aplicativo existente usando o comando da `delete-app` CLI e criar um novo RStudio ServerPro aplicativo usando o comando da CLI`create-app`.
# Adicionar um URL do RStudio Connect
RStudio O Connect é uma plataforma de publicação para aplicativos Shiny, relatórios R Markdown, painéis, gráficos e muito mais. RStudio O Connect facilita a descoberta de insights sobre aprendizado de máquina e ciência de dados, tornando a hospedagem de conteúdo simples e escalável. Se você tiver um servidor RStudio Connect, poderá definir o servidor como o local padrão em que os aplicativos são publicados. Para obter mais informações sobre o RStudio Connect, consulte [RStudio Connect](https://www.rstudio.com/products/connect/).
Quando você se integra ao RStudio no domínio Amazon SageMaker AI, um servidor do RStudio Connect não é criado. Você pode criar um servidor RStudio Connect em uma instância do Amazon EC2 para usar o domínio Connect with SageMaker Amazon AI. Para obter informações sobre como configurar seu servidor RStudio Connect, consulte [Host RStudio Connect e Package Manager para desenvolvimento de ML RStudio na Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/host-rstudio-connect-and-package-manager-for-ml-development-in-rstudio-on-amazon-sagemaker/).
**Adicionar um URL do RStudio Connect**
Se você tiver um RStudio Connect URL, poderá atualizar o URL padrão para que seus RStudio usuários possam publicar nele.
1. Navegue até a página **domínios**.
1. Selecione o domínio desejado.
1. Escolha **Configurações de domínio**.
1. Em **Configurações gerais**, selecione **Editar**.
1. Na nova página, selecione **RStudio Configurações** no lado esquerdo.
1. Em **RStudio Connect URL**, insira o RStudio Connect URL a ser adicionado.
1. Selecione **Submit (Enviar)**.
**CLI**
Você pode definir um RStudio Connect URL padrão ao criar seu domínio. A única maneira de atualizar seu RStudio Connect URL a partir do AWS CLI é excluir seu domínio e criar um novo com o RStudio Connect URL atualizado.
# Atualizar o URL RStudio do Package Manager
RStudio O Package Manager é um servidor de gerenciamento de repositórios usado para organizar e centralizar pacotes em toda a organização. Para obter mais informações sobre o RStudio Package Manager, consulte [RStudio Package Manager](https://www.rstudio.com/products/package-manager/). Se você não fornecer sua própria URL do Package Manager, o domínio Amazon SageMaker AI usa o repositório padrão do Package Manager quando você se integra RStudio seguindo as etapas em. [Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md) Para obter mais informações, consulte [Host RStudio Connect and Package Manager para desenvolvimento de ML RStudio na Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/host-rstudio-connect-and-package-manager-for-ml-development-in-rstudio-on-amazon-sagemaker/). O procedimento a seguir mostra como atualizar a URL do Gerenciador de pacotes.
**Atualizar URL do Gerenciador de pacotes**
Você pode atualizar a URL do Package Manager usada para seu domínio RStudio habilitado da seguinte maneira.
1. Navegue até a página **domínios**.
1. Selecione o domínio desejado.
1. Escolha **Configurações de domínio**.
1. Em **Configurações gerais**, selecione **Editar**.
1. Na nova página, selecione **RStudio Configurações** no lado esquerdo.
1. Em **RStudio Package Manager**, insira sua URL RStudio do Package Manager.
1. Selecione **Submit (Enviar)**.
**CLI**
A única maneira de atualizar a URL do Package Manager a partir do AWS CLI é excluir seu domínio e criar um novo com a URL atualizada do Package Manager.
# Crie um domínio Amazon SageMaker AI RStudio usando o AWS CLI
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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 fazer a integração com o domínio Amazon SageMaker AI com a RStudio habilitação usando o. AWS CLI Para fazer a integração usando o Console de gerenciamento da AWS, consulte[Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md).
## Pré-requisitos
+ 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`
Para iniciar o RStudio aplicativo, você deve fornecer uma `DomainExecution` função. Essa função é usada para determinar se RStudio precisa ser lançada como parte da criação do domínio Amazon SageMaker AI. Essa função também é usada pela Amazon SageMaker AI para acessar a RStudio licença e enviar RStudio registros.
**nota**
A `DomainExecution` função deve ter pelo menos AWS License Manager permissões para acessar a RStudio Licença 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`. `` deve ser a região da AWS na qual lançar seu domínio.
```
aws iam create-role --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 RStudio ServerPro aplicativo acesse os recursos necessários e permite que a Amazon SageMaker AI inicie automaticamente um RStudio ServerPro aplicativo quando o RStudio ServerPro aplicativo existente estiver em um `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 --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
```
## Crie um domínio Amazon SageMaker AI com o RStudio aplicativo
O RStudio ServerPro aplicativo é iniciado automaticamente quando você cria um domínio Amazon SageMaker AI usando o comando `create-domain` CLI com o `RStudioServerProDomainSettings` parâmetro especificado. Ao iniciar o RStudio ServerPro aplicativo, a Amazon SageMaker AI verifica se há uma RStudio licença válida 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 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
**Modo de autenticação do IAM**
A seguir, mostramos como criar um domínio Amazon SageMaker AI com RStudio habilitado 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 o ID da sua Amazon Virtual Private Cloud. `subnet-ids`deve ser uma lista de sub-rede separada por espaços. IDs 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).
+ `RStudioPackageManagerUrl`e `RStudioConnectUrl` são opcionais e devem ser configurados como os URLs do seu servidor RStudio Package Manager e RStudio Connect, respectivamente.
+ `app-network-access-type` deve ser `PublicInternetOnly` ou `VPCOnly`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode IAM \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type
```
**Autenticação usando o IAM Identity Center**
A seguir, mostramos como criar um domínio Amazon SageMaker AI com RStudio habilitado 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 o ID da sua Amazon Virtual Private Cloud. `subnet-ids`deve ser uma lista de sub-rede separada por espaços. IDs 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).
+ `RStudioPackageManagerUrl`e `RStudioConnectUrl` são opcionais e devem ser configurados como os URLs do seu servidor RStudio Package Manager e RStudio Connect, respectivamente.
+ `app-network-access-type` deve ser `PublicInternetOnly` ou `VPCOnly`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode SSO \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type
```
### Tipos de conexão
**PublicInternet/Tipo de rede direta de Internet**
A seguir, mostramos como criar um domínio Amazon SageMaker AI com RStudio habilitado 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 o ID da sua Amazon Virtual Private Cloud. `subnet-ids`deve ser uma lista de sub-rede separada por espaços. IDs 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).
+ `RStudioPackageManagerUrl`e `RStudioConnectUrl` são opcionais e devem ser configurados como os URLs do seu servidor RStudio Package Manager e RStudio Connect, respectivamente.
+ `auth-mode` deve ser `SSO` ou `IAM`.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode \
--default-user-settings ExecutionRole= \
--domain-settings RStudioServerProDomainSettings={RStudioPackageManagerUrl=<,RStudioConnectUrl=<,DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids \
--app-network-access-type PublicInternetOnly
```
**VPCOnly modo**
A seguir, mostramos como iniciar um domínio Amazon SageMaker AI com RStudio habilitado 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 o ID da sua Amazon Virtual Private Cloud. `subnet-ids`deve ser uma lista de sub-rede separada por espaços. IDs Sua sub-rede privada deve ser capaz de acessar a Internet para fazer uma chamada para a 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 do Amazon VPC, consulte Interface dos endpoints do [Amazon VPC](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html) Para obter informações sobre `vpc-id` e, consulte e sub-redes. `subnet-ids` VPCs ](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html)
+ `SecurityGroups`deve permitir 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 RStudio, a Amazon SageMaker AI gerencia grupos de segurança para você. Isso significa que a Amazon SageMaker AI gerencia as regras do grupo de segurança para garantir RSessions o acesso aos RStudio ServerPro aplicativos. A Amazon SageMaker AI cria uma regra de grupo de segurança por perfil de usuário.
```
aws sagemaker create-domain --region --domain-name \
--auth-mode \
--default-user-settings SecurityGroups=,ExecutionRole= \
--domain-settings SecurityGroupIds=,RStudioServerProDomainSettings={DomainExecutionRoleArn=} \
--vpc-id \
--subnet-ids "" \
--app-network-access-type VPCOnly --app-security-group-management Service
```
Nota: O RStudio ServerPro 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
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:::domain/`
```
aws sagemaker describe-domain --domain-id --region
```
# Adicionar RStudio suporte a um domínio existente
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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.
Se você adicionou uma RStudio licença por meio de AWS License Manager, você pode criar um novo domínio Amazon SageMaker AI com suporte para RStudio SageMaker IA. Se você tiver um domínio existente que não ofereça suporte RStudio, poderá adicionar RStudio suporte a esse domínio sem precisar excluir e recriar o domínio.
O tópico a seguir descreve como adicionar essa compatibilidade.
## Pré-requisitos
Você deve concluir as etapas a seguir antes de atualizar seu domínio atual para adicionar suporte RStudio à SageMaker IA.
+ 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
+ Crie uma função de execução de domínio seguindo as etapas em [Criar um domínio de SageMaker IA RStudio usando AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution) o. Essa função do IAM em nível de domínio é exigida pelo aplicativo. RStudio ServerPro A função requer acesso AWS License Manager para verificar uma licença válida do Posit Workbench e Amazon CloudWatch Logs para publicar registros do servidor.
+ Traga sua RStudio licença para AWS License Manager seguir as etapas da [RStudiolicença](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html).
+ (Opcional) Se você quiser usar RStudio no `VPCOnly` modo, conclua as etapas somente [RStudio em VPC](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html).
+ Certifique-se de que os grupos de segurança que você configurou para cada um [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)em seu domínio atendam às cotas no nível da conta. Ao configurar o perfil de usuário padrão durante a criação do domínio, você pode usar o `DefaultUserSettings` parâmetro da [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API para adicionar os `SecurityGroups` que são herdados por todos os perfis de usuário criados no domínio. Você também pode fornecer grupos de segurança adicionais para um usuário específico como parte do `UserSettings` parâmetro da [CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Se você adicionou grupos de segurança dessa forma, deve garantir que o número total de grupos de segurança por perfil de usuário não exceda a cota máxima de 2 no modo `VPCOnly` e 4 no modo `PublicInternetOnly`. Se o resultado do número total de grupos de segurança para qualquer perfil de usuário exceder a cota, você poderá combinar as regras de vários grupos de segurança em um só grupo de segurança.
## Adicionar RStudio suporte a um domínio existente
Depois de concluir os pré-requisitos, você pode adicionar RStudio suporte ao seu domínio existente. As etapas a seguir descrevem como atualizar seu domínio existente para adicionar suporte ao. RStudio
### Etapa 1: exclua todos as aplicações no domínio
Para adicionar suporte ao seu domínio, a SageMaker IA deve atualizar os grupos de segurança subjacentes para todos os perfis de usuário existentes. RStudio Para concluir isso, você deve excluir e recriar todos as aplicações existentes no domínio. O procedimento a seguir mostra como excluir todos as aplicações.
1. Liste todos as aplicações no domínio.
```
aws sagemaker \
list-apps \
--domain-id-equals
```
1. Exclua cada aplicação para cada perfil de usuário no domínio.
```
// JupyterServer apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type JupyterServer \
--app-name
// KernelGateway apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type KernelGateway \
--app-name
```
### Etapa 2 - Atualize todos os perfis de usuário com a nova lista de grupos de segurança
Esta é uma ação única que você deve concluir para todos os perfis de usuário existentes no seu domínio depois de refatorar seus grupos de segurança existentes. Isto impede que você atinja a cota para o número máximo de grupos de segurança. A chamada `UpdateUserProfile` da API falhará se o usuário tiver algum aplicativo com [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)status. Exclua todos as aplicações e chame a API `UpdateUserProfile` para atualizar os grupos de segurança.
**nota**
O seguinte requisito de `VPCOnly` modo descrito em [Connect Amazon SageMaker Studio Classic Notebooks in a VPC to External Resources](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) não é mais necessário ao adicionar RStudio suporte porque `AppSecurityGroupManagement` é gerenciado pelo serviço de IA: SageMaker
“[Tráfego TCP dentro do grupo de segurança](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Isso é necessário para a conectividade entre o JupyterServer aplicativo e os KernelGateway aplicativos. Você deve permitir o acesso pelo menos às portas no intervalo `8192-65535`.”
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
### Etapa 3 - Ative RStudio chamando a UpdateDomain API
1. Chame a [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API para adicionar suporte para RStudio SageMaker IA. O parâmetro `defaultusersettings` só é necessário se você tiver refatorado os grupos de segurança padrão para seus perfis de usuário.
+ Para o modo `VPCOnly`:
```
aws sagemaker \
update-domain \
--domain-id \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
+ Para o modo `PublicInternetOnly`:
```
aws sagemaker \
update-domain \
--domain-id \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
1. Verifique se o status do domínio é `InService`. Depois que o status do domínio for`InService`, o suporte para RStudio SageMaker inteligência artificial será adicionado.
```
aws sagemaker \
describe-domain \
--domain-id
```
1. Verifique se o status do RStudio ServerPro aplicativo está `InService` usando o comando a seguir.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Etapa 4 - Adicionar RStudio acesso para usuários existentes
Como parte da atualização na Etapa 3, a SageMaker IA marca todos os perfis RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus)de usuário existentes no domínio como `DISABLED` padrão. Isso evita que você ultrapasse o número de usuários permitido pela sua licença atual. Para adicionar acesso aos usuários existentes, há uma etapa única de ingresso. Execute o opt-in chamando a [UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API com o seguinte: [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Opcional* - `UserGroup` = `R_STUDIO_USER` ou `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**nota**
Por padrão, o número de usuários que podem ter acesso RStudio é 60.
### Etapa 5 — Desativar o RStudio acesso para novos usuários
A menos que especificado de outra forma ao ligar`UpdateDomain`, o RStudio suporte é adicionado por padrão para todos os novos perfis de usuário criados após a adição do suporte para RStudio SageMaker IA. Para desativar o acesso a um novo perfil de usuário, você deve configurar explicitamente o parâmetro `AccessStatus` como `DISABLED`, como parte da chamada da API `CreateUserProfile`. Se o parâmetro `AccessStatus` não for especificado como parte da API `CreateUserProfile`, o status de acesso padrão será `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```
# Imagens personalizadas RStudio sem SageMaker IA
Uma SageMaker imagem é um arquivo que identifica pacotes de idiomas e outras dependências necessárias para execução RStudio na Amazon SageMaker AI. SageMaker A IA usa essas imagens para criar um ambiente onde você corre RStudio. A Amazon SageMaker AI fornece uma RStudio imagem integrada para você usar. Se precisar de uma funcionalidade diferente, você pode trazer suas próprias imagens personalizadas. Esta página fornece informações sobre os principais conceitos para o uso de imagens personalizadas com RStudio SageMaker IA. O processo para usar sua própria imagem RStudio na SageMaker IA envolve três etapas:
1. Crie uma imagem personalizada a partir de um Dockerfile e envie-a para um repositório no Amazon Elastic Container Registry (Amazon ECR).
1. Crie uma SageMaker imagem que aponte para uma imagem de contêiner no Amazon ECR e anexe-a ao seu domínio Amazon SageMaker AI.
1. Inicie uma nova sessão RStudio com sua imagem personalizada.
Você pode criar imagens e versões de imagens e anexar versões de imagem ao seu domínio usando o painel de controle de SageMaker IA [AWS SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html), o e o [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/). Você também pode criar imagens e versões de imagens usando o console de SageMaker IA, mesmo que não tenha se integrado a um domínio.
Os tópicos a seguir mostram como trazer sua própria imagem para RStudio a SageMaker IA criando, anexando e lançando uma imagem personalizada.
## Terminologia básica
A seção a seguir define os principais termos para usar sua própria imagem RStudio na SageMaker IA.
+ **Dockerfile:** um Dockerfile é um arquivo que identifica os pacotes de idiomas e outras dependências da sua imagem do Docker.
+ **Imagem do Docker:** a imagem do Docker é um Dockerfile embutido. Essa imagem é verificada no Amazon ECR e serve como base para a imagem de SageMaker IA.
+ **SageMaker imagem:** uma SageMaker imagem é um suporte para um conjunto de versões de SageMaker imagem com base em imagens do Docker.
+ **Versão da imagem:** uma versão de imagem de uma SageMaker imagem representa uma imagem do Docker que é compatível RStudio e armazenada em um repositório Amazon ECR. Cada versão da imagem é imutável. Essas versões de imagem podem ser anexadas a um domínio e usadas com RStudio SageMaker IA.
# Concluir os pré-requisitos
Você deve preencher os seguintes pré-requisitos antes de usar sua própria imagem na RStudio Amazon AI. SageMaker
+ Se você tem um domínio existente RStudio que foi criado antes de 7 de abril de 2022, você deve excluir seu RStudio ServerPro aplicativo e recriá-lo. Para obter informações sobre como excluir uma aplicação, consulte [Desligue e atualize o Amazon SageMaker Studio Classic](studio-tasks-update-studio.md).
+ Instale a aplicação Docker. Para obter informações sobre como configurar o Docker, consulte [Orientação e configuração](https://docs.docker.com/get-started/).
+ Crie uma cópia local de um Dockerfile RStudio compatível que funcione com IA. SageMaker Para obter informações sobre como criar um RStudio dockerfile de amostra, consulte [Usar uma imagem personalizada para trazer seu próprio ambiente de desenvolvimento para a RStudio Amazon SageMaker AI](https://aws.amazon.com/blogs/machine-learning/use-a-custom-image-to-bring-your-own-development-environment-to-rstudio-on-amazon-sagemaker/).
+ Use uma função AWS Identity and Access Management de execução que tenha a [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)política anexada. Se você se integrou ao domínio, pode obter a função na seção **Resumo do domínio** do painel de controle de SageMaker IA.
Adicione as seguintes permissões de acesso ao serviço Amazon Elastic Container Registry (Amazon ECR) para seu perfil de execução:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid": "VisualEditor0",
"Effect":"Allow",
"Action":[
"ecr:CreateRepository",
"ecr:BatchGetImage",
"ecr:CompleteLayerUpload",
"ecr:DescribeImages",
"ecr:DescribeRepositories",
"ecr:UploadLayerPart",
"ecr:ListImages",
"ecr:InitiateLayerUpload",
"ecr:BatchCheckLayerAvailability",
"ecr:PutImage"
],
"Resource": "*"
}
]
}
```
------
+ Instale e configure AWS CLI com a seguinte versão (ou superior). Para obter informações sobre como instalar o AWS CLI, consulte [Instalando ou atualizando a versão mais recente do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
```
AWS CLI v1 >= 1.23.6
AWS CLI v2 >= 2.6.2
```
# Especificações de RStudio imagem personalizadas
Neste guia, você aprenderá as especificações de RStudio imagem personalizadas para usar ao trazer sua própria imagem. Há dois conjuntos de requisitos que você deve satisfazer com sua RStudio imagem personalizada para usá-la com a Amazon SageMaker AI. Esses requisitos são impostos pelo RStudio PBC e pela plataforma Amazon SageMaker Studio Classic. Se algum desses conjuntos de requisitos não for satisfeito, sua imagem personalizada não funcionará corretamente.
## RStudio Requisitos de PBC
RStudio Os requisitos de PBC estão descritos no artigo [Usando imagens do Docker com RStudio Workbench RStudio /Server Pro, Launcher](https://support.rstudio.com/hc/en-us/articles/360019253393-Using-Docker-images-with-RStudio-Server-Pro-Launcher-and-Kubernetes) e Kubernetes. Siga as instruções deste artigo para criar a base da sua RStudio imagem personalizada.
Para obter instruções sobre como instalar várias versões do R em sua imagem personalizada, consulte [Instalando várias versões do R no Linux](https://support.rstudio.com/hc/en-us/articles/215488098).
## Requisitos do Amazon SageMaker Studio Classic
O Amazon SageMaker Studio Classic impõe o seguinte conjunto de requisitos de instalação para sua RStudio imagem.
+ Você deve usar uma imagem RStudio base de pelo menos`2025.05.1+513.pro3`. Para obter mais informações, consulte [RStudio Controle de versão](rstudio-version.md).
+ Você deverá instalar os seguintes pacotes:
```
yum install -y sudo \
openjdk-11-jdk \
libpng-dev \
&& yum clean all \
&& /opt/R/${R_VERSION}/bin/R -e "install.packages('reticulate', repos='https://packagemanager.rstudio.com/cran/__linux__/centos7/latest')" \
&& /opt/python/${PYTHON_VERSION}/bin/pip install --upgrade \
'boto3>1.0<2.0' \
'awscli>1.0<2.0' \
'sagemaker[local]<3'
```
+ Você deve fornecer valores padrão para os valores do `RSTUDIO_CONNECT_URL` e do ambiente `RSTUDIO_PACKAGE_MANAGER_URL`.
```
ENV RSTUDIO_CONNECT_URL "YOUR_CONNECT_URL"
ENV RSTUDIO_PACKAGE_MANAGER_URL "YOUR_PACKAGE_MANAGER_URL"
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE 1
```
As especificações gerais a seguir se aplicam à imagem representada por uma versão RStudio da imagem.
**Executando a imagem**
`ENTRYPOINT`e `CMD` as instruções são substituídas para que a imagem seja executada como um RSession aplicativo.
**Interrompendo a imagem**
A API `DeleteApp` emite o equivalente a um comando `docker stop`. Outros processos no contêiner não receberão os SIGKILL/SIGTERM sinais.
**Sistema de arquivos**
Os diretórios `/opt/.sagemakerinternal` e `/opt/ml` são reservados. Qualquer dado nesses diretórios pode não estar visível em runtime.
**Dados do usuário**
Cada usuário em um domínio de SageMaker IA obtém um diretório de usuários em um volume compartilhado do Amazon Elastic File System na imagem. A localização do diretório do usuário atual no volume do Amazon Elastic File System é `/home/sagemaker-user`.
**Metadados**
Um arquivo de metadados está localizado em `/opt/ml/metadata/resource-metadata.json`. Nenhuma variável de ambiente adicional é incluída às variáveis definidas na imagem. Para obter mais informações, consulte [Obter metadados da aplicação](notebooks-run-and-manage-metadata.md#notebooks-run-and-manage-metadata-app).
**GPU**
Em uma instância de GPU, a imagem é executada com a opção `--gpus`. Somente o kit de ferramentas CUDA deve ser incluído na imagem, não os drivers da NVIDIA. Para obter mais informações, consulte o [Guia do usuário do NVIDIA](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/user-guide.html).
**Métricas e registro em log**
Os registros do RSession processo são enviados para a Amazon CloudWatch na conta do cliente. O nome do grupo de logs é `/aws/sagemaker/studio`. O nome do fluxo de logs é `$domainID/$userProfileName/RSession/$appName`.
**Tamanho da imagem**
O tamanho da imagem é limitado a 25 GB. Para ver o tamanho da sua imagem, execute `docker image ls`.
# Crie uma RStudio imagem personalizada
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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.
Este tópico descreve como você pode criar uma RStudio imagem personalizada usando o console SageMaker AI e AWS CLI o. Se você usar o AWS CLI, deverá executar as etapas em sua máquina local. As etapas a seguir não funcionam no Amazon SageMaker Studio Classic.
Quando você cria uma imagem, a SageMaker IA também cria uma versão inicial da imagem. A versão da imagem representa uma imagem de contêiner no [Registro de contêiner Amazon Elastic Container Registry (ECR)](https://console.aws.amazon.com/ecr/). A imagem do contêiner deve atender aos requisitos a serem usados em RStudio. Para obter mais informações, consulte [Especificações de RStudio imagem personalizadas](rstudio-byoi-specs.md).
Para obter informações sobre como testar sua imagem localmente e resolver problemas comuns, consulte o [repositório SageMaker Studio Custom Image Samples](https://github.com/aws-samples/sagemaker-studio-custom-image-samples/blob/main/DEVELOPMENT.md).
**Topics**
+ [
## Adicione uma imagem de SageMaker contêiner RStudio Docker compatível com IA ao Amazon ECR
](#rstudio-byoi-sdk-add-container-image)
+ [
## Crie uma SageMaker imagem do console
](#rstudio-byoi-create-console)
+ [
## Crie uma imagem a partir do AWS CLI
](#rstudio-byoi-create-cli)
## Adicione uma imagem de SageMaker contêiner RStudio Docker compatível com IA ao Amazon ECR
Use as seguintes etapas para adicionar uma imagem de contêiner do Docker ao Amazon ECR:
+ Crie um repositório do Amazon ECR.
+ Autentique no Amazon ECR.
+ Crie uma imagem RStudio Docker SageMaker compatível com IA.
+ Empurre a imagem para o repositório do Amazon ECR.
**nota**
O repositório Amazon ECR deve estar no mesmo que seu Região da AWS domínio.
**Criar e adicionar uma imagem do Docker ao Amazon ECR**
1. Crie um repositório do Amazon ECR usando a AWS CLI. Para criar o repositório usando o console do Amazon ECR, consulte [Criação de um repositório](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-create.html).
```
aws ecr create-repository \
--repository-name rstudio-custom \
--image-scanning-configuration scanOnPush=true
```
Resposta:
```
{
"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",
...
}
}
```
1. Autentique-se no Amazon ECR usando o URI do repositório retornado como resposta do comando `create-repository`. Certifique-se de que a aplicação Docker está em execução. Para obter mais informações, consulte [Autenticação de registro](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html#registry_auth).
```
aws ecr get-login-password | \
docker login --username AWS --password-stdin
```
Resposta:
```
Login Succeeded
```
1. Crie a imagem do Docker. Execute o seguinte comando no diretório que inclui seu Dockerfile:
```
docker build .
```
1. Marque sua imagem criada com uma tag exclusiva.
```
docker tag ":"
```
1. Empurre a imagem de contêiner para o repositório do Amazon ECR. Para obter mais informações, consulte [ImagePush](https://docs.docker.com/engine/api/v1.40/#operation/ImagePush)[Enviar uma imagem](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html).
```
docker push :
```
Resposta:
```
The push refers to repository [.dkr.ecr.us-east-2.amazonaws.com/rstudio-custom]
r: digest: size: 3066
```
## Crie uma SageMaker imagem do console
**Criar uma imagem**
1. Abra o console Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Imagens**.
1. Na página **Imagens personalizadas**, escolha **Criar imagem**.
1. Em **Fonte da imagem**, insira o caminho do registro para a imagem de contêiner no Amazon ECR. O caminho é tem o seguinte formato:
` acct-id.dkr.ecr.region.amazonaws.com/repo-name[:tag] or [@digest] `
1. Escolha **Próximo**.
1. Em **Propriedades da imagem**, insira o seguinte:
+ Nome da imagem: O nome deve ser exclusivo para a sua conta Região da AWS atual.
+ (Opcional) Nome de exibição da imagem: O nome exibido na interface de usuário do domínio. Quando não fornecido, `Image name` é exibido.
+ (Opcional) Descrição: uma descrição da imagem.
+ Função do IAM — A função deve ter a [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)política anexada. Use a lista suspensa para escolher uma das seguintes opções:
+ Criar um novo perfil: Especifique quaisquer buckets adicionais do Amazon Simple Storage Service (Amazon S3) aos quais você deseja que os usuários dos cadernos tenham acesso. Se não quiser permitir acesso a buckets adicionais, escolha **Nenhum**.
SageMaker A IA atribui a `AmazonSageMakerFullAccess` política à função. A função permite que os usuários de seus cadernos tenham acesso aos buckets do S3 listados ao lado das marcas de verificação.
+ Insira um ARN do perfil do IAM personalizado: Insira o nome do recurso da Amazon (ARN) da perfil do IAM.
+ Uso da função existente: Escolha uma das suas funções existentes na lista.
+ (Opcional) Tags de imagem: Escolha **Adicionar nova tag**. É possível adicionar até 50 tags. As tags podem ser pesquisadas usando o console de SageMaker IA ou a `Search` API de SageMaker IA.
1. Em **Tipo de imagem**, selecione RStudio imagem.
1. Escolha **Enviar**.
A nova imagem é exibida na lista de **imagens personalizadas** e destacada brevemente. Depois que a imagem for criada com êxito, você poderá escolher o nome da imagem para ver suas propriedades ou escolher **Criar versão** para criar outra versão.
**Para criar outra versão da imagem**
1. Escolha **Criar versão** na mesma linha da imagem.
1. Em **Fonte da imagem**, insira o caminho do registro para a imagem do Amazon ECR. A imagem não deve ser a mesma usada em uma versão anterior da imagem de SageMaker IA.
Para usar a imagem personalizada em RStudio, você deve anexá-la ao seu domínio. Para obter mais informações, consulte [Anexar uma SageMaker imagem personalizada](rstudio-byoi-attach.md).
## Crie uma imagem a partir do AWS CLI
Esta seção mostra como criar uma SageMaker imagem personalizada da Amazon usando AWS CLI o.
Use as etapas a seguir para criar uma SageMaker imagem:
+ Crie uma `Image`.
+ Crie uma `ImageVersion`.
+ Criar um arquivo de configuração.
+ Crie uma `AppImageConfig`.
**Para criar as entidades SageMaker de imagem**
1. Crie uma SageMaker imagem. O ARN do perfil deve ter pelo menos a política `AmazonSageMakerFullAccessPolicy` anexada.
```
aws sagemaker create-image \
--image-name rstudio-custom-image \
--role-arn arn:aws:iam:::role/service-role/
```
Resposta:
```
{
"ImageArn": "arn:aws:sagemaker:us-east-2:acct-id:image/rstudio-custom-image"
}
```
1. Crie uma versão de SageMaker imagem a partir da imagem. Passe o valor de tag exclusivo que você escolheu ao enviar a imagem para o Amazon ECR.
```
aws sagemaker create-image-version \
--image-name rstudio-custom-image \
--base-image :
```
Resposta:
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-image/1"
}
```
1. Verifique se a versão da imagem foi criada com sucesso.
```
aws sagemaker describe-image-version \
--image-name rstudio-custom-image \
--version 1
```
Resposta:
```
{
"ImageVersionArn": "arn:aws:sagemaker:us-east-2:acct-id:image-version/rstudio-custom-image/1",
"ImageVersionStatus": "CREATED"
}
```
**nota**
Se a resposta for `"ImageVersionStatus": "CREATED_FAILED"`, ela também incluirá o motivo da falha. Um problema de permissão é uma causa comum de falha. Você também pode verificar seus Amazon CloudWatch Logs. O nome do grupo de logs é `/aws/sagemaker/studio`. O nome do fluxo de logs é `$domainID/$userProfileName/KernelGateway/$appName`.
1. Crie um arquivo de configuração denominado `app-image-config-input.json`. A configuração da imagem do aplicativo é usada para configurar a execução de uma SageMaker imagem como um aplicativo Kernel Gateway.
```
{
"AppImageConfigName": "rstudio-custom-config"
}
```
1. Crie o AppImageConfig usando o arquivo que você criou na etapa anterior.
```
aws sagemaker create-app-image-config \
--cli-input-json file://app-image-config-input.json
```
Resposta:
```
{
"AppImageConfigArn": "arn:aws:sagemaker:us-east-2:acct-id:app-image-config/r-image-config"
}
```
# Anexar uma SageMaker imagem personalizada
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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.
Este guia mostra como anexar uma RStudio imagem personalizada ao seu domínio Amazon SageMaker AI usando o console de SageMaker IA ou o AWS Command Line Interface (AWS CLI).
Para usar uma SageMaker imagem personalizada, você deve anexar uma RStudio imagem personalizada ao seu domínio. Quando você anexa uma versão de imagem, ela aparece no RStudio Launcher e está disponível na lista suspensa **Selecionar imagem**. Você usa o menu suspenso para alterar a imagem usada por. RStudio
Há um limite para o número de versões de imagens que você pode anexar. Depois de atingir o limite, você deve primeiro separar uma versão para poder anexar uma versão diferente da imagem.
**Topics**
+ [
## Anexe uma versão da imagem ao seu domínio usando o console
](#rstudio-byoi-attach-console)
+ [
## Anexe uma versão de imagem existente ao seu domínio usando o AWS CLI
](#rstudio-byoi-attach-cli)
## Anexe uma versão da imagem ao seu domínio usando o console
Você pode anexar uma versão de SageMaker imagem personalizada ao seu domínio usando o painel de controle do console SageMaker AI. Você também pode criar uma SageMaker imagem personalizada e uma versão da imagem e, em seguida, anexar essa versão ao seu domínio.
**Para anexar uma imagem existente**
1. Abra o console Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio desejado.
1. Escolha **Ambiente**.
1. Em **Imagens do Custom SageMaker Studio Classic anexadas ao domínio**, escolha **Anexar imagem**.
1. Em **Fonte da imagem**, escolha **Imagem existente** ou **Nova imagem**.
Se você selecionar **Imagem existente**, escolha uma imagem na loja de SageMaker imagens da Amazon.
Se você selecionar **Nova imagem**, forneça o caminho de registro do Amazon ECR para sua imagem do Docker. O caminho deve estar no mesmo Região da AWS que o domínio. O repositório Amazon ECR deve estar na mesma conta do seu domínio, ou as permissões entre contas para SageMaker IA devem estar habilitadas.
1. Escolha uma imagem existente na lista.
1. Escolha uma versão da imagem na lista.
1. Escolha **Próximo**.
1. Insira valores para **Nome da imagem**, **Nome de exibição da imagem** e **Descrição**.
1. Escolha o Perfil do IAM. Para obter mais informações, consulte [Crie uma RStudio imagem personalizada](rstudio-byoi-create.md).
1. (Opcional) Adicione tags à imagem.
1. (Opcional) Escolha **Adicionar nova tag** e, em seguida, adicione uma tag de configuração.
1. Em **Tipo de imagem**, selecione **RStudioImagem**.
1. Selecione **Enviar**.
Aguarde até que a versão da imagem seja anexada ao domínio. Depois que a versão é anexada, ela aparece na lista de **imagens personalizadas** e fica brevemente em destaque.
## Anexe uma versão de imagem existente ao seu domínio usando o AWS CLI
Dois métodos são apresentados para anexar a versão da imagem ao seu domínio usando a AWS CLI. No primeiro método, você cria um novo domínio com a versão anexada. Esse método é mais simples, mas você deve especificar as informações e a função de execução da Amazon Virtual Private Cloud (Amazon VPC) necessárias para criar o domínio.
Se você já se integrou ao domínio, pode usar o segundo método para anexar a versão da imagem ao seu domínio atual. Nesse caso, você não precisa especificar as informações e a função de execução do Amazon VPC. Depois de anexar a versão, exclua todos os aplicativos em seu domínio e RStudio reinicie.
### Anexar a SageMaker imagem a um novo domínio
Para usar esse método, você deve especificar uma função de execução que tenha a [AmazonSageMakerFullAccess](https://console.aws.amazon.com/iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)política anexada.
Use as etapas a seguir para criar o domínio e anexar a imagem de SageMaker IA personalizada:
+ Obtenha sua VPC ID e sub-rede padrão. IDs
+ Crie o arquivo de configuração para o domínio, que especifica a imagem.
+ Crie um domínio com o arquivo de configuração.
**Para adicionar a SageMaker imagem personalizada ao seu domínio**
1. Obtenha seu ID de VPC padrão.
```
aws ec2 describe-vpcs \
--filters Name=isDefault,Values=true \
--query "Vpcs[0].VpcId" --output text
```
Resposta:
```
vpc-xxxxxxxx
```
1. Obtenha sua sub-rede padrão IDs usando o ID da VPC da etapa anterior.
```
aws ec2 describe-subnets \
--filters Name=vpc-id,Values= \
--query "Subnets[*].SubnetId" --output json
```
Resposta:
```
[
"subnet-b55171dd",
"subnet-8a5f99c6",
"subnet-e88d1392"
]
```
1. Crie um arquivo de configuração denominado `create-domain-input.json`. Insira o ID da VPC, a sub-rede IDs e `ImageName` as etapas `AppImageConfigName` anteriores. Como o `ImageVersionNumber` não está especificado, a versão mais recente da imagem é usada, que é a única versão nesse caso. A função de execução deve atender aos requisitos em [Concluir os pré-requisitos](rstudio-byoi-prerequisites.md).
```
{
"DomainName": "domain-with-custom-r-image",
"VpcId": "",
"SubnetIds": [
""
],
"DomainSettings": {
"RStudioServerProDomainSettings": {
"DomainExecutionRoleArn": ""
}
},
"DefaultUserSettings": {
"ExecutionRole": "",
"RSessionAppSettings": {
"CustomImages": [
{
"AppImageConfigName": "rstudio-custom-config",
"ImageName": "rstudio-custom-image"
}
]
}
},
"AuthMode": "IAM"
}
```
1. Crie o domínio com a SageMaker imagem personalizada anexada.
```
aws sagemaker create-domain \
--cli-input-json file://create-domain-input.json
```
Resposta:
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id",
"Url": "https://domain-id.studio.region.sagemaker.aws/..."
}
```
### Anexar a SageMaker imagem a um domínio existente
Este método pressupõe que você já esteja integrado ao domínio. Para obter mais informações, consulte [Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md).
**nota**
Você deve excluir todas as aplicações no seu domínio para atualizar o domínio com a nova versão de imagem. Para obter informações sobre como excluir esses aplicações, consulte [Excluir um domínio da Amazon SageMaker AI](gs-studio-delete-domain.md).
Use as etapas a seguir para adicionar a SageMaker imagem ao seu domínio atual.
+ Obtenha o seu no console `DomainID` de SageMaker IA.
+ Use o `DomainID` para obter o `DefaultUserSettings` para o domínio.
+ Adicione o `ImageName` e `AppImageConfig` como uma `CustomImage` ao `DefaultUserSettings`.
+ Atualize seu domínio para incluir a imagem personalizada.
**Para adicionar a SageMaker imagem personalizada ao seu domínio**
1. Abra o console Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio desejado.
1. Escolha **Configurações de domínio**.
1. Em **Configurações gerais**, encontre o **ID do domínio**. O ID está no seguinte formato: `d-xxxxxxxxxxxx`.
1. Use o ID do domínio para obter a descrição do domínio.
```
aws sagemaker describe-domain \
--domain-id
```
Resposta:
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
}
}
}
```
1. Salve a seção `DefaultUserSettings` da resposta em um arquivo chamado `update-domain-input.json`.
1. Insira o `ImageName` e o `AppImageConfigName` das etapas anteriores como uma imagem personalizada. Como o `ImageVersionNumber` não está especificado, a versão mais recente da imagem é usada, que é a única versão nesse caso.
```
{
"DefaultUserSettings": {
"RSessionAppSettings": {
"CustomImages": [
{
"ImageName": "rstudio-custom-image",
"AppImageConfigName": "rstudio-custom-config"
}
]
}
}
}
```
1. Use o ID do domínio e o arquivo de configurações padrão do usuário para atualizar seu domínio.
```
aws sagemaker update-domain \
--domain-id \
--cli-input-json file://update-domain-input.json
```
Resposta:
```
{
"DomainArn": "arn:aws:sagemaker:region:acct-id:domain/domain-id"
}
```
1. Exclua a aplicação do `RStudioServerPro`. Você deve reiniciar o aplicativo de `RStudioServerPro` domínio compartilhado para a interface do usuário do RStudio Launcher para obter as alterações mais recentes.
```
aws sagemaker delete-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
1. Para criar um nova aplicação `RStudioServerPro`. Você deve criar esse aplicação usando o AWS CLI.
```
aws sagemaker create-app \
--domain-id --user-profile-name domain-shared \
--app-type RStudioServerPro --app-name default
```
# Inicie uma SageMaker imagem personalizada no RStudio
Você pode usar sua imagem personalizada ao iniciar um RStudio aplicativo a partir do console. Depois de criar sua SageMaker imagem personalizada e anexá-la ao seu domínio, a imagem aparece na caixa de diálogo do seletor de imagens do RStudio Launcher. Para iniciar um novo RStudio aplicativo, siga as etapas [Inicie RSessions a partir do RStudio Launcher](rstudio-launcher.md) e selecione sua imagem personalizada conforme mostrado na imagem a seguir.
![\[Captura de tela do RStudio lançador com menu suspenso de imagens.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/rstudio-launcher-custom.png)
# Limpeza do recurso de imagem
Este guia mostra como limpar os recursos de RStudio imagem que você criou nas seções anteriores. Para excluir uma imagem, conclua as etapas a seguir usando o console SageMaker AI ou o AWS CLI, conforme mostrado neste guia.
+ Separe a imagem e as versões da imagem do seu domínio Amazon SageMaker AI.
+ Exclua a imagem, a versão da imagem e a configuração da imagem da aplicação.
Depois de concluir essas etapas, você pode excluir a imagem de contêiner e o repositório do Amazon ECR. Para obter mais informações sobre como excluir a imagem de contêiner e o repositório, consulte [Excluir um repositório](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-delete.html).
## Limpe os recursos do console de SageMaker IA
Quando você separa uma imagem de um domínio, todas as versões da imagem são separadas. Quando uma imagem é separada, todos os usuários do domínio perdem o acesso às versões da imagem.
**Para desassociar uma imagem**
1. Abra o console Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio desejado.
1. Escolha **Ambiente**.
1. Em **Imagens personalizadas anexadas ao domínio**, escolha a imagem e escolha **Desassociar**.
1. (Opcional) Para excluir a imagem e todas as versões do SageMaker AI, selecione **Também excluir as imagens selecionadas...** . Isso não exclui as imagens associadas do Amazon ECR.
1. Escolha **Desassociar**.
## Limpe os recursos do AWS CLI
**Para limpar os recursos**
1. Separe a imagem e as versões da imagem do seu domínio passando uma lista vazia de imagens personalizadas para o domínio. Abra o arquivo `update-domain-input.json` que você criou em [Anexe a SageMaker imagem ao seu domínio atual](studio-byoi-attach.md#studio-byoi-sdk-attach-current-domain).
1. Exclua as imagens personalizadas `RSessionAppSettings` e salve o arquivo. Não modifique as imagens personalizadas `KernelGatewayAppSettings`.
```
{
"DomainId": "d-xxxxxxxxxxxx",
"DefaultUserSettings": {
"KernelGatewayAppSettings": {
"CustomImages": [
],
...
},
"RSessionAppSettings": {
"CustomImages": [
],
"DefaultResourceSpec": {
}
...
}
}
}
```
1. Use o ID do domínio e o arquivo de configurações padrão do usuário para atualizar seu domínio.
```
aws sagemaker update-domain \
--domain-id \
--cli-input-json file://update-domain-input.json
```
Resposta:
```
{
"DomainArn": "arn:aws:sagemaker:us-east-2:acct-id:domain/d-xxxxxxxxxxxx"
}
```
1. Exclua a configuração da imagem da aplicação.
```
aws sagemaker delete-app-image-config \
--app-image-config-name rstudio-image-config
```
1. Exclua a SageMaker imagem, o que também exclui todas as versões da imagem. As imagens de contêiner no Amazon ECR que são representadas pelas versões da imagem não são excluídas.
```
aws sagemaker delete-image \
--image-name rstudio-image
```
# Crie um usuário para usar RStudio
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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.
Depois que seu domínio Amazon SageMaker AI RStudio habilitado estiver em execução, você poderá adicionar perfis de usuário (UserProfiles) ao domínio. Os tópicos a seguir mostram como criar perfis de usuário autorizados a usar RStudio, bem como atualizar um perfil de usuário existente. Para obter informações sobre como excluir um RStudio aplicativo ou domínio UserProfile, siga as etapas em [Excluir um domínio do Amazon SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/gs-studio-delete-domain.html).
**nota**
O limite para o número total de UserProfiles em um domínio do Amazon SageMaker AI é 60.
Há dois tipos de usuários:
+ Não autorizado: esse usuário não pode acessar o RStudio aplicativo.
+ Autorizado: esse usuário pode acessar o RStudio aplicativo e usar uma das RStudio licenças. Por padrão, um novo usuário é `Authorized` se o domínio estiver habilitado para RStudio.
A alteração do status de autorização de um usuário só é válida de `Unauthorized` para `Authorized`. Se um usuário for autorizado, ele poderá receber um dos seguintes níveis de acesso RStudio a.
+ RStudio Usuário: Este é um RStudio usuário padrão e pode acessar RStudio.
+ RStudio Administrador: O administrador do seu domínio Amazon SageMaker AI tem a capacidade de criar usuários, adicionar usuários existentes e atualizar as permissões dos usuários existentes. Os administradores também podem acessar o painel RStudio administrativo. No entanto, esse administrador não consegue atualizar os parâmetros gerenciados pela Amazon SageMaker AI.
## Métodos para criar um usuário
Os tópicos a seguir mostram como criar um usuário em seu domínio Amazon SageMaker AI RStudio habilitado.
**Criar console de usuário**
Para criar um usuário em seu domínio RStudio habilitado do Amazon SageMaker AI a partir do console, conclua as etapas em[Adicionar perfis de usuário](domain-user-profile-add.md).
**Criar CLI de usuário**
O comando a seguir mostra como adicionar usuários a um domínio do Amazon SageMaker AI com a autenticação do IAM. Um usuário pode pertencer ao grupo de usuários `R_STUDIO_USER` ou `R_STUDIO_ADMIN`.
```
aws sagemaker create-user-profile --region \
--domain-id \
--user-profile-name \
--user-settings RStudioServerProAppSettings={UserGroup=}
```
O comando a seguir mostra como adicionar usuários a um domínio do Amazon SageMaker AI com autenticação usando o IAM Identity Center. Um usuário pode pertencer ao grupo de usuários `R_STUDIO_USER` ou `R_STUDIO_ADMIN`.
```
aws sagemaker create-user-profile --region \
--domain-id \
--user-profile-name \
--user-settings RStudioServerProAppSettings={UserGroup=} \
--single-sign-on-user-identifier UserName \
--single-sign-on-user-value
```
# Faça login RStudio como outro usuário
O tópico a seguir demonstra como fazer login RStudio no Amazon SageMaker AI como outro usuário.
1. Abra o console Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador**.
1. Em **Configurações do administrador**, escolha **Domínios**.
1. Selecione o domínio que contém o perfil do usuário.
1. Selecione um nome de usuário na lista de usuários. Isso abre uma nova página com detalhes sobre o perfil do usuário e as aplicações em execução.
1. Selecione **Iniciar**.
1. No menu suspenso, selecione **RStudio**para iniciar uma RStudio instância.
# Encerrar sessões para outro usuário
O tópico a seguir demonstra como encerrar sessões para outro usuário no RStudio Amazon SageMaker AI.
1. Na lista de aplicações em execução, identifique a aplicação que você quer excluir.
1. Clique no botão **Excluir aplicação** correspondente à aplicação que você está excluindo.
# Use o painel RStudio administrativo
Este tópico mostra como acessar e usar o painel RStudio administrativo. Com o painel RStudio administrativo, os administradores podem gerenciar usuários e RSessions visualizar informações sobre a utilização da instância RStudio do servidor e o Amazon Logs. CloudWatch
## Inicie o painel RStudio administrativo
A `R_STUDIO_ADMIN` autorização permite que o usuário acesse o painel RStudio administrativo. Um `R_STUDIO_ADMIN` usuário pode acessar o painel RStudio administrativo `workspaces` substituindo manualmente por `admin` em seu RStudio URL. Veja a seguir como modificar a URL para acessar o painel RStudio administrativo.
Por exemplo, o seguinte RStudio URL:
```
https://.studio.us-east-2.sagemaker.aws/rstudio/default/s//workspaces
```
Pode ser convertido em:
```
https://.studio.us-east-2.sagemaker.aws/rstudio/default/s//admin
```
## Guia do Painel
Essa guia fornece uma visão geral da utilização da sua instância RStudio do servidor, bem como informações sobre o número de ativos RSessions.
## Guia de Sessões
Essa guia fornece informações sobre os ativos RSessions, como o usuário que iniciou o RSessions, a hora em que eles estão sendo RSessions executados e a utilização de seus recursos.
## Guia de usuários
Essa guia fornece informações sobre os usuários RStudio autorizados no domínio, como a hora em que o último RSession foi lançado e a utilização dos recursos.
## Guia de Estatísticas
Essa guia fornece informações sobre a utilização da sua instância do RStudio servidor.
## Guia de Registros
Essa guia exibe Amazon CloudWatch Logs para a instância RStudio do servidor. Para obter mais informações sobre o registro de eventos com o Amazon CloudWatch Logs, consulte [O que é o Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html) .
# Desligar RStudio
**Importante**
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon 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 permitir que o Studio e o Studio Classic criem recursos, mas não permitisse 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.
Para desligar e reiniciar o Posit Workbench e o RStudio ServerPro aplicativo associado, você deve primeiro desligar todos os existentes. RSessions Você pode desligar os aplicativos do RSession Gateway de dentro RStudio. Em seguida, você pode desligar o RStudio ServerPro aplicativo usando AWS CLI o. Depois que o RStudio ServerPro aplicativo for encerrado, você deverá reabri-lo RStudio por meio do console de SageMaker IA.
Todas as informações do caderno não salvas são perdidas no processo. Os dados do usuário no volume do Amazon EFS não são afetados.
**nota**
Se você estiver usando uma imagem personalizada com RStudio, certifique-se de que sua imagem docker esteja usando uma RStudio versão compatível com a versão do Posit Workbench usada pela SageMaker IA depois de reiniciar seu aplicativo. RStudio ServerPro
Os tópicos a seguir mostram como desligar o RSession Gateway e RStudio ServerPro os aplicativos e reiniciá-los.
## Suspenda seu RSessions
Conclua o procedimento a seguir para suspender todos os seus RSessions.
1. No RStudio Launcher, identifique o RSession que você deseja suspender.
1. Selecione **Suspender** para a sessão.
1. Repita isso para todos RSessions.
## Exclua seu RSessions
Conclua o procedimento a seguir para desligar todos os seus RSessions.
1. No RStudio Launcher, identifique o RSession que você deseja excluir.
1. Selecione **Sair** para a sessão. Isso abre uma nova janela **Sair da sessão**.
1. Na janela **Sair da sessão**, selecione **Forçar o encerramento** para encerrar todos os processos secundários da sessão.
1. Selecione **Sair da sessão** para confirmar a exclusão da sessão.
1. Repita isso para todos RSessions.
## Exclua seu RStudio ServerPro aplicativo
Execute os comandos a seguir a partir do AWS CLI para excluir e reiniciar seu RStudio ServerPro aplicativo.
1. Exclua o RStudio ServerPro aplicativo usando seu ID de domínio atual.
```
aws sagemaker delete-app \
--domain-id \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
1. Recrie o RStudio ServerPro aplicativo.
```
aws sagemaker create-app \
--domain-id \
--user-profile-name domain-shared \
--app-type RStudioServerPro \
--app-name default
```
# Faturamento e custos
Para monitorar os custos associados ao seu RStudio ambiente, você pode usar o Gerenciamento de Faturamento e Custos da AWS serviço.Gerenciamento de Faturamento e Custos da AWS fornece ferramentas úteis para ajudá-lo a reunir informações relacionadas ao seu custo e uso, analisar seus fatores de custo e tendências de uso e tomar medidas para orçar seus gastos. Para obter mais informações, consulte [O que é Gerenciamento de faturamento e custos da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html)? A seguir, descrevemos os componentes necessários para execução RStudio na Amazon SageMaker AI e como cada componente influencia no faturamento da sua RStudio instância.
+ RStudio Licença — Você deve comprar uma RStudio licença. Não há cobrança adicional pelo uso da sua RStudio licença com a Amazon SageMaker AI. Para obter mais informações sobre sua RStudio licença, consulte[Obtenha uma RStudio licença](rstudio-license.md).
+ RSession - São sessões RStudio de trabalho lançadas por usuários finais. Você é cobrado enquanto o RSession está em execução.
+ RStudio Servidor - Um servidor multilocatário gerencia todos os. RSessions Você pode escolher o tipo de instância na qual executar o RStudio servidor e pagar os custos relacionados. A instância padrão, “sistema”, é gratuita, mas você pode optar por pagar por níveis mais altos. Para obter mais informações sobre os tipos de instância disponíveis para seu RStudio servidor, consulte[RStudioServerPro tipo de instância](rstudio-select-instance.md).
**Monitorando o faturamento no nível do usuário**
Para monitorar o faturamento no nível do usuário usando tags de alocação de custos, consulte [Como usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
# Diagnostique problemas e obtenha ajuda
As seções a seguir descrevem como diagnosticar problemas com o RStudio Amazon SageMaker AI. Para obter suporte RStudio na Amazon SageMaker AI, entre em contato com o suporte da Amazon SageMaker AI. Para obter ajuda na compra de uma RStudio licença ou na modificação do número de licenças, entre em contato com [sales@rstudio.com.](mailto:sales@rstudio.com)
## Atualize sua versão
Se você receber um aviso de que há uma incompatibilidade de versão entre o seu aplicativo RSession e o seu RStudio ServerPro aplicativo, você deve atualizar a versão do seu RStudio ServerPro aplicativo. Para obter mais informações, consulte [RStudio Controle de versão](rstudio-version.md).
## Visualizar métricas e logs
Você pode monitorar o desempenho do seu fluxo de trabalho enquanto estiver usando o RStudio Amazon SageMaker AI. Visualize registros de dados e informações sobre métricas com o painel RStudio administrativo ou com a Amazon CloudWatch.
### Visualize seus RStudio registros no painel RStudio administrativo
Você pode visualizar métricas e registros diretamente do painel RStudio administrativo.
1. Faça login no seu **domínio Amazon SageMaker AI**.
1. Navegue até o painel RStudio administrativo seguindo as etapas em[Use o painel RStudio administrativo](rstudio-admin.md).
1. Escolha a guia **Logs**.
### Veja seus RStudio registros do Amazon CloudWatch Logs
A Amazon CloudWatch monitora seus AWS recursos e os aplicativos nos quais você executa AWS em tempo real. Você pode usar CloudWatch a Amazon para coletar e rastrear métricas, que são variáveis que você pode medir para seus recursos e aplicativos. Para garantir que seus RStudio aplicativos tenham permissões para a Amazon CloudWatch, você deve incluir as permissões descritas em[Visão geral do domínio Amazon SageMaker AI](gs-studio-onboard.md). Você não precisa fazer nenhuma configuração para coletar Amazon CloudWatch Logs.
As etapas a seguir mostram como visualizar CloudWatch os Amazon Logs para seu RSession.
Esses registros podem ser encontrados no fluxo de `/aws/sagemaker/studio` registros do AWS CloudWatch console.
1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Selecione `Logs` no lado esquerdo. No menu suspenso, selecione `Log groups`.
1. Na tela, `Log groups` pesquise por `aws/sagemaker/studio`. Selecione o grupo de logs.
1. Na tela `aws/sagemaker/studio` `Log group`, navegue até a guia `Log streams`.
1. Para encontrar os logs do seu domínio, pesquise `Log streams` usando o seguinte formato:
```
/domain-shared/rstudioserverpro/default
```