

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# RStudio 版本控制
<a name="rstudio-version"></a>

**重要**  
允许 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 创建亚马逊 SageMaker资源的自定义 IAM 策略还必须授予向这些资源添加标签的权限。之所以需要为资源添加标签的权限，是因为 Studio 和 Studio Classic 会自动为创建的任何资源添加标签。如果 IAM 策略允许 Studio 和 Studio Classic 创建资源但不允许标记，则在尝试创建资源时可能会出现 AccessDenied “” 错误。有关更多信息，请参阅 [提供标记 A SageMaker I 资源的权限](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。  
[AWS 亚马逊 A SageMaker I 的托管策略](security-iam-awsmanpol.md)授予创建 SageMaker 资源的权限已经包括在创建这些资源时添加标签的权限。

本指南提供有关 SageMaker 人工智能`2025.05.1+513.pro3`版 RStudio 版本更新的信息。从 2025 年 10 月 31 日起，将使用Posit Workbench版本`2025.05.1+513.pro3`创建支持 rStudio 的新域名。这适用于 `RStudioServerPro` 应用程序和默认的 `RSessionGateway` 应用程序。

以下各节提供有关该`2025.05.1+513.pro3`版本的信息。

## 最新版本更新
<a name="rstudio-version-latest"></a>

最新的 RStudio 版本是 `2025.05.1+513.pro3`。
+ 支持的 R 版本：
  + 4.5.1
  + 4.4.3
  + 4.4.0
  + 4.3.3
  + 4.2.3
  + 4.2.1
  + 4.1.3
  + 4.0.2

有关此版本中更改的更多信息，请参阅[https://docs.posit.co/ide/news/](https://docs.posit.co/ide/news/)。

**注意**  
为确保兼容性，我们建议使用前缀与当前 Posit Workbench 版本一致的 RSessions。  
如果您看到以下警告，则说明与 SageMaker AI RStudio 上使用的Posit Workbench版本之间存在版本不匹配。`RSession`要解决此问题，请更新域的 RStudio 版本。有关更新 RStudio 版本的信息，请参阅 [升级到新版本](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.
```

## 版本控制
<a name="rstudio-version-new"></a>

 SageMaker AI 目前Posit Workbench支持两个版本。
+ 最新版本：`2025.05.1+513.pro3`

  弃用日期：2026 年 12 月 5 日
+ 之前的版本：`2024.04.2+764.pro1`

  弃用日期：2026 年 4 月 30 日

**注意**  
虽然您可以通过使用 CLI 创建域名时明确固定版本来继续使用旧版本创建新域名，`2024.04.2+764.pro1`直到 04/30 2026 年，但我们强烈建议客户开始在所有域中使用该`2025.05`版本。POSIT 已停止为其提供漏洞修复。`2024.04.2+764.pro1`  
版本`2023.03.2-547.pro5`和`2022.02.2-485.pro2`已过时，不再受支持。我们建议更新到最新版本。

 SageMaker AI 选择的默认Posit Workbench版本取决于域的创建日期。
+ 对于 2025 年 10 月 31 日之后创建的域名，版本`2025.05.1+513.pro3`为默认选定版本。
+ 对于 2024 年 9 月 4 日之后和 2025 年 10 月 31 日之前创建的域名，版本`2024.04.2+764.pro1`为默认选定版本。您可以通过将最新版本 (`2025.05.1+513.pro3`) 设置为域的默认版本，将域更新到此最新版本。有关更多信息，请参阅 [升级到新版本](rstudio-version-upgrade.md)。

**注意**  
默认 `RSessionGateway` 应用程序版本与 `RStudioServerPro` 应用程序的当前版本相匹配。

下表列出了各个 AWS 区域的两个版本的映像 ARN。这些 ARN 将作为 `update-domain` 命令的一部分传递，用于设置所需版本。


|  Region | `2024.04.2+764.pro1` 映像 ARN  | `2025.05.1+513.pro3` 映像 ARN  | 
| --- | --- | --- | 
| 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  | 

### 对 BYOI 映像的更改
<a name="rstudio-version-byoi"></a>

如果您在 RStudio 中使用 BYOI 映像，并将 `RStudioServerPro` 版本更新为 `2025.05.1+513.pro3`，则必须升级自定义映像，才能使用 `2025.05.1+513.pro3` 版本并重新部署现有的 RSession。如果在使用 `2025.05.1+513.pro3` 版本的域的 RSession 中，您尝试加载不兼容的映像，则 RSession 会失败，因为它无法解析收到的参数。为防止失败，请更新现有 `RStudioServerPro` 应用程序中所有已部署的自定义映像。

`RSW_VERSION`中的Dockerfile必须与 RStudio 在 SageMaker AI 上使用的Posit Workbench版本一致。您可以在 Posit Workbench 中验证当前版本。为此，请使用位于 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
```