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

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

事前準備

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

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

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

    Go to project selector

  2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  3. Verify that billing is enabled for your Google Cloud project.

  4. 如果尚未啟用，請啟用 Cloud Workstations API。

    啟用 API 時所需的角色

    如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

必要的角色

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

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

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

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

如需所有 Cloud Workstations 角色的詳細總覽，請參閱「使用 IAM 控管存取權」。

建立工作站設定

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

  1. 找出 Posit Workbench 授權金鑰，並放在手邊，因為後續步驟會用到。如需 Posit Workbench 授權金鑰，請洽詢 Posit 客戶成功代表，或傳送電子郵件至 sales@posit.co。

  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. 如要建立工作站設定並將這些使用者新增至該設定，請按一下「Create」(建立)。

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

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

設定工作站

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

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

    前往「Workstations」(工作站)

  2. 按一下「add_box」(新增方塊)add_box「Create」(建立)。

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

  3. 輸入工作站名稱。

    請按照 Compute Engine 資源命名慣例，在工作站叢集中選擇專屬名稱。

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

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

啟動工作站

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

  1. 按一下「工作站」。
  2. 在可用工作站清單中找到您建立的工作站，勾選旁邊的核取方塊，然後按一下「Start」(啟動)。系統就會啟動工作站，並確保該工作站與父項工作站設定相符。
  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 容器映像檔發生問題，請透過 support@posit.co 向 Posit 回報。

後續步驟