

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

**重要**  
允許 Amazon SageMaker Studio 或 Amazon SageMaker Studio Classic 建立 Amazon SageMaker 資源的自訂 IAM 政策也必須授與許可，才能將標籤新增至這些資源。需要將標籤新增至資源的許可，因為 Studio 和 Studio Classic 會自動標記它們建立的任何資源。如果 IAM 政策允許 Studio 和 Studio Classic 建立資源，但不允許標記，則在嘗試建立資源時可能會發生 "AccessDenied" 錯誤。如需詳細資訊，請參閱[提供標記 SageMaker AI 資源的許可](security_iam_id-based-policy-examples.md#grant-tagging-permissions)。  
提供許可來建立 SageMaker 資源的 [AWS Amazon SageMaker AI 的 受管政策](security-iam-awsmanpol.md) 已包含建立這些資源時新增標籤的許可。

本指南提供 RStudio on SageMaker AI `2025.05.1+513.pro3` 版本更新的相關資訊。從 2025 年 10 月 31 日開始，使用Posit Workbench版本 建立具有 RStudio 支援的新網域`2025.05.1+513.pro3`。這適用於 `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/)。

**注意**  
為了確保相容性，我們建議您使用 RSessions 搭配符合目前 Posit Workbench 版本的字首。  
如果您看到下列警告，表示 `RSession` 的版本與 RStudio on SageMaker AI 中使用的 Posit Workbench 版本不相符。若要解決此問題，請更新網域的 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>

如果您將 BYOI 映像與 RStudio 搭配使用，並將 `RStudioServerPro` 版本更新至 `2025.05.1+513.pro3`，則必須升級自訂映像檔以使用該 `2025.05.1+513.pro3` 版本，並重新部署現有的 RSession。如果您嘗試在使用 `2025.05.1+513.pro3` 版本的網域的 RSession 中載入不相容的映像，則 RSession 會失敗，因為它無法剖析其接收的參數。若要避免失敗，請更新現有 `RStudioServerPro` 應用程式中所有已部署的自訂映像。

Dockerfile 中的 `RSW_VERSION` 必須與 RStudio on 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
```