使用 Posit Workbench (包括 RStudio Pro) 開發程式碼

注意： 本節列出的容器映像檔由第三方供應商負責維護。 Google Cloud 不會建構、維護或正式支援這個映像檔。在正式環境中部署任何解決方案前，請務必先謹慎評估。

瞭解如何使用 Cloud Workstations，透過 Posit Workbench 和 RStudio Pro 開始開發程式碼。本指南將逐步說明如何設定環境、建立工作站，以及啟動 RStudio Pro 工作階段。

事前準備

本指南涵蓋管理員設定 Cloud Workstations 的步驟，以及開發人員使用工作站的步驟。

如要設定 Cloud Workstations，請完成下列步驟：

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

Verify that billing is enabled for your Google Cloud project.

1. Enable the Cloud Workstations API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

必要的角色

如要取得管理及使用工作站所需的權限，請要求管理員授予下列 IAM 角色：

• 建立及管理工作站叢集和設定： 專案的 Cloud Workstations 管理員 (roles/workstations.admin)
• 使用設定建立工作站： 專案或工作站設定的 Cloud Workstations 建立者 (roles/workstations.workstationCreator)
• 使用工作站： 工作站上的「Cloud Workstations User」 (roles/workstations.user)。 系統會自動授予您在工作站建立的權限。

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

如要詳細瞭解所有 Cloud Workstations 角色，請參閱「使用 IAM 控管存取權」。

建立工作站設定

如要使用 Posit Workbench (包括 RStudio Pro)，您必須為貴機構的開發人員建立工作站設定：

1. 找出 Posit Workbench 授權金鑰並妥善保管，因為後續步驟會用到。如需 Posit Workbench 授權金鑰，請洽詢 Posit 客戶成功代表，或傳送電子郵件至 [e-mail]。

2. 按照操作說明建立工作站設定。

   1. 進行到「環境自訂」步驟時，請選取「使用基本映像檔的程式碼編輯器」。

   2. 在「程式碼編輯器」選單中，選取「Posit Workbench (包括 RStudio Pro) 第三方提供」。

   3. 按一下「Advanced container options」(進階容器選項) 區段中的arrow_drop_down展開箭頭。

      1. 前往「環境變數」部分，然後按一下「新增變數」。

      2. 在「Key」(鍵) 欄位中輸入 RSW_LICENSE，然後將 Posit Workbench 授權金鑰貼到「Value」(值) 欄位。

         

      3. 按一下「繼續」。

   4. 在「新增使用者」步驟中，請授予開發人員工作站設定的 Cloud Workstations IAM 存取權。

   5. 如要建立工作站設定並將這些使用者新增至該設定，請按一下「建立」。

      如果您也選擇建立新叢集，叢集建立作業最多可能需要 20 分鐘才能完成。

   團隊中的開發人員現在應該可以透過 Posit Workbench 建立工作站。

設定工作站

如要建立工作站，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，依序前往「Cloud Workstations」>「Workstations」(工作站) 頁面。

   前往「Workstations」(工作站)

2. 按一下「add_box」add_box「建立」。

   如果專案沒有任何設定，或是您沒有查看設定的權限，則「Create」(建立) 連結可能會停用。請貴機構的 Cloud Workstations 管理員為您建立工作站設定。

3. 輸入工作站名稱。

   請按照 Compute Engine 資源命名慣例，在工作站叢集中選擇不重複的名稱。

4. 按一下「Configuration」(設定) 欄位中的 arrow_drop_down 展開箭頭，然後選取「Posit Workbench (Third-party)」工作站設定。

5. 按一下「Create」(建立) 即可建立工作站。

啟動工作站

現在您已建立工作站，可以啟動這個工作站並用於開始開發作業。

1. 按一下「工作站」。
2. 在可用工作站清單中找到您建立的工作站，勾選旁邊的核取方塊，然後按一下「啟動」。系統就會啟動工作站，並確保該工作站與父項工作站設定相符。
3. 如果系統提示您啟動工作站，請點選「啟動」加以確認。 在啟動作業執行期間，狀態會變更為「Starting」(啟動中) 且狀態圖示 refresh 會轉動。啟動工作站可能需要幾分鐘的時間。
4. 工作站準備就緒後，狀態會變更為「Running」(執行中)，狀態圖示則變更為 check_circle 勾號。
5. 按一下「啟動」。

啟動 Posit Workbench RStudio Pro 工作階段

1. 以下範例顯示 Posit Workbench 的歡迎頁面。 視貴機構定義工作站設定的方式而定，頁面可能會有不同顯示方式：

   

2. 按一下「新增工作階段」。

3. 選取「RStudio Pro」做為 IDE，並將「叢集」設為「本機」。

   

   如要進一步瞭解 Posit Workbench 和支援的 IDE (例如 Jupyter Notebook、JupyterLab 和 VS Code)，請參閱 Posit 說明文件。

4. 按一下「開始上課」。

5. 等待工作階段啟動，然後開始編碼！

   

將檔案上傳至工作站

1. 如要將檔案從本機電腦上傳至工作站，請按一下「上傳」。

   

2. 選取要將檔案儲存在工作站的目標目錄。

3. 按一下「選擇檔案」，選取要上傳的檔案。

4. 按一下「確定」即可開始上傳。

如要上傳多個檔案或目錄，請建立 ZIP 檔案。上傳後，系統會展開 ZIP 檔案。

從工作站匯入檔案

1. 如要從工作站匯入檔案，請按一下「匯入資料集」，然後選取資料集類型。

   

2. 從工作站導覽並選取要匯入的資料集。

   Posit Workbench IDE 依賴各種 R 軟體包，才能提供不同功能。舉例來說，如果您要上傳 Excel 檔案，就必須安裝特定套件。如果系統提示您安裝必要套件，請按一下「Yes」。

3. 按一下「匯入」即可開始匯入。

取得 Posit Workbench 問題的相關支援

如果遇到 Posit Workbench 或 Posit Workbench 容器映像檔的問題，請透過 [e-mail] 向 Posit 回報。

後續步驟

• 瞭解如何自訂容器映像檔，以符合貴機構的需求。

• 如要進一步瞭解 Posit Workbench，請參閱 Posit Software 的說明文件中心。