使用 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 所需的角色

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

    啟用 API

必要的角色

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

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

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

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

建立工作站設定

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

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

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

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

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

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

      1. 前往「Environment variables」(環境變數) 專區，然後按一下「Add variable」(新增變數)。

      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」(建立) 連結可能會停用。請貴機構的 Cloud Workstations 管理員為您建立工作站設定。

  3. 輸入工作站名稱。

    請遵循 Compute Engine 資源命名慣例，並選擇工作站叢集內不重複的名稱。

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

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

啟動工作站

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

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

啟動 Posit Workbench RStudio Pro 工作階段

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

  2. 按一下「New Session」(新增工作階段)。

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

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

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

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

將檔案上傳至工作站

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

  2. 選取要儲存工作站檔案的「Target directory」(目標目錄)。

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

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

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

從工作站匯入檔案

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

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

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

  3. 如要開始匯入，請按一下「匯入」。

取得 Posit Workbench 問題的支援

如果 Posit Workbench 或 Posit Workbench 容器映像檔發生問題，請傳送電子郵件至 support@posit.co 回報給 Posit。

後續步驟