Posit Workbench（RStudio Pro を含む）を使用したコードの開発

Cloud Workstations で Posit Workbench と RStudio Pro を使用してコードの開発を開始する方法について説明します。このガイドでは、環境の構成、ワークステーションの作成、RStudio Pro セッションの起動について説明します。

始める前に

このガイドでは、管理者が Cloud Workstations を設定する手順と、デベロッパーがワークステーションを使用する手順について説明します。

Cloud Workstations を設定するには、次の操作を行います。

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

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

  3. このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。

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

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

  6. このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。

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

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

    9. 必要なロール

    ワークステーションの管理と使用に必要な権限を取得するには、次の 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. [コンテナの詳細オプション] セクションで arrow_drop_down 展開矢印をクリックします。

        1. [環境変数] セクションに移動し、[変数を追加] をクリックします。

        2. [キー] 項目に「RSW_LICENSE」と入力し、[値] 項目に Posit Workbench ライセンスキーを貼り付けます。

        3. [続行] をクリックします。

      4. ユーザーを追加するステップに移動したら、デベロッパーに、ワークステーションの構成に対する Cloud Workstations IAM アクセス権を付与します。

      5. ワークステーション構成を作成して、ユーザーを追加するには、[作成] をクリックします。

        新しいクラスタも作成するように選択した場合は、クラスタの作成には最長で 20 分ほどかかることがあります。

      これで、チームのデベロッパーが Posit Workbench を使用してワークステーションを作成できるようになりました。

    ワークステーションを設定する

    ワークステーションを作成するには、次の手順に沿って操作します。

    1. Google Cloud コンソールで、[Cloud Workstations] > [ワークステーション] ページに移動します。

      [ワークステーション] に移動

    2. add_box [作成] をクリックします。

      プロジェクトに構成がない場合、または表示する構成権限がない場合は、[作成] リンクが無効になっている場合があります。ワークステーション構成の作成を組織の Cloud Workstations 管理者に依頼します。

    3. ワークステーションの [名前] を入力します。

      Compute Engine リソースの命名規則に従って、ワークステーション クラスタ内で一意の名前を選択します。

    4. [構成] フィールドで arrow_drop_down 展開矢印をクリックし、[ Posit Workbench（サードパーティ）] ワークステーション構成を選択します。

    5. [作成] をクリックして、ワークステーションを作成します。

    ワークステーションを立ち上げます。

    ワークステーションが作成されたので、ワークステーションを開始して、開発を始めるためにワークステーションを起動できます。

    1. [ワークステーション] をクリックします。
    2. 使用可能なワークステーションのリストで、作成したワークステーションを見つけて、その横にあるチェックボックスをオンにし、[開始] をクリックします。これによりワークステーションが開始され、親ワークステーション構成とワークステーションが一致します。
    3. ワークステーションを開始するように求められたら、[開始] をクリックして確定します。開始オペレーションが進行中の間、ステータスは [開始中] に変わり、ステータス アイコン 更新 が回転します。ワークステーションの開始には数分かかる場合があります。
    4. ワークステーションの準備が整うと、ステータスが [実行中] に変わり、ステータス アイコンが check_circle チェックマークに変わります。
    5. [運用開始] をクリックします。

    Posit Workbench RStudio Pro セッションを起動する

    1. 次の例は、Posit Workbench のスタートページを示しています。ページの外観は、組織でワークステーションの構成をどのように定義しているかによって異なる場合があります。

    2. [新しいセッション] をクリックします。

    3. IDE として [RStudio Pro] を選択し、[クラスタ] は [ローカル] に設定されたままにします。

      Posit Workbench と、Jupyter Notebook、JupyterLab、VS Code などのサポートされている IDE の詳細については、Posit のドキュメントをご覧ください。

    4. [セッションを開始] をクリックします。

    5. セッションが開始するのを待ってから、コーディングを開始します。

    ワークステーションにファイルをアップロードする

    1. ローカルマシンからワークステーションにファイルをアップロードするには、[アップロード] をクリックします。

    2. ワークステーション上のファイルを保存する [ターゲット ディレクトリ] を選択します。

    3. [ファイルを選択] をクリックして、アップロードするファイルを選択します。

    4. アップロードを開始するには、[OK] をクリックします。

    複数のファイルまたはディレクトリをアップロードするには、ZIP ファイルを作成します。ZIP ファイルはアップロード後に開きます。

    ワークステーションからファイルをインポートする

    1. ワークステーションからファイルをインポートするには、[データセットをインポート] をクリックして、データセットのタイプを選択します。

    2. ワークステーションからインポートするデータセットに移動して選択します。

      Posit Workbench IDE は、各種の機能に関してさまざまな R パッケージに依存しています。たとえば、Excel ファイルをアップロードする場合は、特定のパッケージをインストールする必要があります。必要なパッケージのインストールを求めるプロンプトが表示されたら、[はい] をクリックします。

    3. インポートを開始するには、[インポート] をクリックします。

    Posit Workbench の問題に関するサポートを受ける

    Posit Workbench または Posit Workbench コンテナ イメージで問題が発生した場合は、support@posit.co に報告してください。

    次のステップ