Atualize a RStudio versão - Amazon SageMaker
Atualizações da versão mais recenteVersionamentoAtualizando para a nova versãoFaça o downgrade para a versão existenteAlterações nas BYOI imagens

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á.

Atualize a RStudio versão

Importante

IAMPolíticas personalizadas que permitem que o Amazon SageMaker Studio ou o Amazon SageMaker Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma IAM política permitir que o Studio e o Studio Classic criem recursos, mas não permita a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte Forneça permissões para marcar recursos SageMaker.

AWS Políticas gerenciadas para a Amazon SageMakerque 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 2023.03.2-547.pro5 versão para RStudio on SageMaker. A partir de 27 de fevereiro de 2024, novos domínios com RStudio suporte são criados com Posit Workbench a versão. 2023.03.2-547.pro5 Isso se aplica aos aplicativos RStudioServerPro e aos aplicativos padrão RSessionGateway.

As seções a seguir fornecem informações sobre a 2023.03.2-547.pro5 versão.

Atualizações da versão mais recente

O 2023.03.2-547.pro5 lançamento da versão do patch inclui as seguintes alterações:

  • Corrigida uma RServer falha intermitente ao ingressar em uma RSession que foi iniciada com o inicializador de tarefas e não está imediatamente disponível.

A RStudio versão mais recente é2023.03.2-454.pro2. Essa versão inclui as seguintes alterações:

  • Suporte adicionado para RTools 4.3

  • Adicionado suporte para R 4.3.

  • Quarto atualizado para 1.2.335

  • Gerenciador de sessões aprimorado

Para obter mais informações sobre as alterações nessa liberação, consulte https://docs.posit.co/ide/news/.

nota

Se você ver o aviso a seguir, há uma incompatibilidade de versão entre a RSession e a Posit Workbench versão usada RStudio em SageMaker. Para resolver esse problema, atualize a RStudio versão do domínio. Para obter informações sobre como atualizar a RStudio versão, consulteAtualizando para a nova versão. Apesar desse aviso, as versões 1 2023.03.2-547.pro5 e 2023.03.2-454.pro2 2 são imagens compatíveis.

Session version 2023.03.2+454.pro2 does not match server version 2023.03.3-547.pro5 - 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.

  • Versão mais recente com suporte: 2023.03.2-547.pro5

  • Versão anterior com suporte: 2022.02.2-485.pro2

A Posit Workbench versão padrão selecionada por SageMaker depende da data de criação do domínio.

  • Para domínios criados após 27 de fevereiro de 2024, a versão 2023.03.2-547.pro5 é a versão padrão selecionada.

  • Para domínios criados após 27 de junho de 2023 e antes de 27 de fevereiro de 2024, a versão 2023.03.2-454.pro2 é a versão padrão selecionada. Você pode atualizar seus domínios para a versão mais recente (2023.03.2-547.pro5) configurando-a como a versão padrão do domínio. Para obter mais informações, consulte Atualizando para a nova versão.

  • Para domínios criados antes de 27 de junho de 2023, a versão 2022.02.2-485.pro2 é a versão padrão selecionada. Você pode atualizar seus domínios para a versão mais recente (2023.03.2-547.pro5) configurando-a como a versão padrão do domínio. Para obter mais informações, consulte Atualizando para a nova versão.

nota

A versão padrão do aplicativo RSessionGateway corresponde à versão atual do aplicativo 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 2022.02.2-485.pro2Imagem ARN 2023.03.2-547.pro5Imagem ARN
us-east-1 arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-east-1:081325390199:image/rstudio-workbench-2023.03
us-east-2 arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-east-2:429704687514:image/rstudio-workbench-2023.03
us-west-1 arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-west-1:742091327244:image/rstudio-workbench-2023.03
us-west-2 arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2021.08 arn:aws:sagemaker:us-west-2:236514542706:image/rstudio-workbench-2023.03
af-south-1 arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2021.08 arn:aws:sagemaker:af-south-1:559312083959:image/rstudio-workbench-2023.03
ap-east-1 arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-east-1:493642496378:image/rstudio-workbench-2023.03
ap-south-1 arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-south-1:394103062818:image/rstudio-workbench-2023.03
ap-northeast-2 arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-northeast-2:806072073708:image/rstudio-workbench-2023.03
ap-southeast-1 arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-southeast-1:492261229750:image/rstudio-workbench-2023.03
ap-southeast-2 arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-southeast-2:452832661640:image/rstudio-workbench-2023.03
ap-northeast-1 arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ap-northeast-1:102112518831:image/rstudio-workbench-2023.03
ca-central-1 arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2021.08 arn:aws:sagemaker:ca-central-1:310906938811:image/rstudio-workbench-2023.03
eu-central-1 arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-central-1:936697816551:image/rstudio-workbench-2023.03
eu-west-1 arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-west-1:470317259841:image/rstudio-workbench-2023.03
eu-west-2 arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-west-2:712779665605:image/rstudio-workbench-2023.03
eu-west-3 arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-west-3:615547856133:image/rstudio-workbench-2023.03
eu-north-1 arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-north-1:243637512696:image/rstudio-workbench-2023.03
eu-south-1 arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2021.08 arn:aws:sagemaker:eu-south-1:592751261982:image/rstudio-workbench-2023.03
sa-east-1 arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2021.08 arn:aws:sagemaker:sa-east-1:782484402741:image/rstudio-workbench-2023.03

Atualizando para a nova versão

Domínios existentes que usam a versão 2022.02.2-485.pro2 ou 2023.03.2-454.pro2 podem ser atualizados para a 2023.03.2-547.pro5 versão 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 2023.03.2-547.pro5.

O procedimento a seguir mostra como excluir o RStudio aplicativo de um domínio existente, definir a 2023.03.2-547.pro5 versão padrão como e criar um RStudio aplicativo.

  1. Exclua o aplicativo RStudioServerPro e todos os aplicativos RSessionGateway associados ao seu domínio existente. Para obter informações sobre como encontrar sua ID do domínio, consulte Exibir domínios. Para mais informações sobre como excluir aplicativos, consulte Desligue e reinicie o RStudio.

    aws sagemaker delete-app \
    --region region \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

  2. Se seu domínio estiver usando a RStudio versão2022.02.2-485.pro2, atualize o domínio para 2023.03.2-547.pro5 defini-lo como a Posit Workbench versão padrão. O SageMakerImageArn valor no update-domain comando a seguir especifica a RStudio 2023.03.2-547.pro5 versão como padrão. Isso ARN deve corresponder ao domínio em Region que seu domínio está. Para obter uma lista de todos os disponíveisARNs, consulteVersionamento.

    Passe uma função de execução ARN 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-2023.03.2-547.pro5-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"

  3. Crie um novo aplicativo 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 aplicativo RStudioServerPro agora está atualizado para a versão 2023.03.2-547.pro5. Agora você pode reexecutar seus aplicativos RSessionGateway.

Faça o downgrade para a versão existente

Você pode fazer o downgrade manualmente da versão do seu RStudio aplicativo existente para a 2022.02.2-485.pro2 versão.

Faça o downgrade para a versão existente

  1. Exclua o aplicativo RStudioServerPro que está associado ao seu domínio existente. Para obter informações sobre como encontrar sua ID do domínio, consulte Exibir domínios.

    aws sagemaker delete-app \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

  2. Passe o correspondente 2022.02.2-485.pro2 ARN para você Region como parte do update-domain comando. Para obter uma lista de todos os disponíveisARNs, consulteVersionamento. Você também deve passar uma função de execução ARN 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-2022.02.2+485.pro2-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"

  3. Crie um novo aplicativo RStudioServerPro no domínio existente. O padrão da RStudio versão é. 2022.02.2-485.pro2

    aws sagemaker create-app \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

Seu aplicativo RStudioServerPro agora está em downgrade para a versão 2022.02.2-485.pro2.

Alterações nas BYOI imagens

Se você usar uma BYOI imagem com RStudio e atualizar sua RStudioServerPro versão para2023.03.2-547.pro5, deverá atualizar suas imagens personalizadas para usar a 2023.03.2-547.pro5 versão e reimplantar as existentesRSessions. Se você tentar carregar uma imagem não compatível em um domínio RSession de um domínio usando a 2023.03.2-547.pro5 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 seu aplicativo RStudioServerPro existente.

O RSW_VERSION in the Dockerfile deve ser consistente com a Posit Workbench versão usada RStudio em SageMaker. 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=2023.03.3-547.pro5
ENV RSTUDIO_FORCE_NON_ZERO_EXIT_CODE="1"
ARG RSW_NAME=rstudio-workbench
ARG OS_CODE_NAME=bionic
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
nota

Se você ver o aviso a seguir, há uma incompatibilidade de versão entre a RSW_VERSION e a Posit Workbench versão usada RStudio em SageMaker. Apesar desse aviso, as versões 1 2023.03.2-547.pro5 e 2023.03.2-454.pro2 2 são imagens compatíveis.

Session version 2023.03.2+454.pro2 does not match server version 2023.03.3-547.pro5 - this is an unsupported configuration, and you may experience unexpected issues as a result.