Desarrollar código usando Posit Workbench (incluido RStudio Pro)

Precaución: Un proveedor externo mantiene la imagen de contenedor que se enumera en esta sección. Google Cloud no compila, mantiene ni admite oficialmente esta imagen. Evalúa con cuidado cualquier solución antes de implementarla en tu entorno de producción.

Antes de comenzar

Antes de comenzar a usar Cloud Workstations, asegúrate de tener los permisos necesarios y de completar los siguientes pasos de configuración necesarios:

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.

   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

3. Make sure that billing is enabled for your Google Cloud project.

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

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Cloud Workstations API.

   Enable the API

7. Si eres administrador, asegúrate de tener un rol de administrador de Cloud Workstations en el proyecto para que puedas crear configuraciones de la estación de trabajo.

   Si eres desarrollador y no tienes parámetros de configuración de estaciones de trabajo disponibles en la consola de Google Cloud, pídele al administrador de Cloud Workstations de tu organización que cree una configuración de estación de trabajo por ti o asegúrate de tener un rol de IAM de Administrador de Cloud Workstations en el proyecto para que puedas crear estos recursos por tu cuenta. Para verificar tus roles de IAM, ve a la página de IAM en la consola de Google Cloud:

   Ir a IAM

Crea la configuración de la estación de trabajo

Para usar Posit Workbench (incluido RStudio Pro), debes crear una configuración de estación de trabajo para los desarrolladores de tu organización:

1. Encuentra tu clave de licencia de Posit Workbench y guárdala cerca, ya que la necesitarás en un paso posterior. Si necesitas una clave de licencia de Posit Workbench, comunícate con tu representante de Éxito del cliente de Posit o envía un correo electrónico a [e-mail].

2. Sigue las instrucciones para crear una configuración de estación de trabajo.

   1. Cuando llegues al paso Personalización del entorno, selecciona Editores de código en imágenes base.

   2. En el menú Editores de código, selecciona “Posit Workbench (Include RStudio Pro) Third-party provided”.

   3. Haz clic en la flecha de expansión arrow_drop_down en la sección Opciones avanzadas de contenedor.

      1. Ve a la sección Variables de entorno y haz clic en Agregar variable.

      2. Ingresa RSW_LICENSE en el campo Clave y pega tu clave de licencia de Posit Workbench en el campo Valor.

         

      3. Haz clic en Continuar.

   4. Cuando llegues al paso Agrega usuarios, otorga a tus desarrolladores permisos de acceso de IAM de Cloud Workstations para la configuración de la estación de trabajo.

   5. Para crear la configuración de la estación de trabajo y agregarle estos usuarios, haz clic en Crear.

      Si también elegiste crear un clúster nuevo, la creación del clúster puede tardar hasta 20 minutos.

   Los desarrolladores de tu equipo ahora deberían poder crear estaciones de trabajo con Posit Workbench.

Configura tu estación de trabajo

Para crear una estación de trabajo, sigue estos pasos:

1. En la consola de Google Cloud, navega a la página Cloud Workstations > Workstations.

   Ir a Estaciones de trabajo

2. Haz clic en add_boxCrear.

   El vínculo Crear podría estar inhabilitado si no hay ninguna configuración en el proyecto o si no tienes permisos para verla. Pídele al administrador de Cloud Workstations de tu organización que cree una configuración de estación de trabajo por ti.

3. Ingresa el Nombre de la estación de trabajo.

   Sigue las convenciones de nomenclatura de recursos de Compute Engine y elige un nombre que sea único dentro del clúster de la estación de trabajo.

4. Haz clic en la flecha de expansión arrow_drop_down en el campo Configuración y selecciona la configuración de la estación de trabajo Posit Workbench (terceros).

5. Haz clic en Crear para crear tu estación de trabajo.

Inicia tu estación de trabajo

Ahora que creaste tu estación de trabajo, puedes iniciarla y, luego, iniciarla para comenzar el desarrollo:

1. Haz clic en Estaciones de trabajo.
2. Busca la estación de trabajo que creaste en la lista de estaciones de trabajo disponibles, selecciona la casilla de verificación junto a ella y, luego, haz clic en Iniciar. Esto inicia tu estación de trabajo y la hace coincidir con la configuración de la estación de trabajo superior.
3. Si se te solicita que inicies tu estación de trabajo, haz clic en Iniciar para confirmar. El estado cambia a Iniciando y el ícono de estado refresh gira mientras la operación de inicio está en curso. La estación de trabajo puede tardar unos minutos en iniciarse.
4. Cuando tu estación de trabajo esté lista, el estado cambiará a En ejecución y el ícono de estado cambiará a una marca de verificación check_circle.
5. Haz clic en Iniciar.

Inicia una sesión de RStudio Pro en Posit Workbench

1. En el siguiente ejemplo, se muestra la página de bienvenida de Posit Workbench. Tu página puede verse diferente, según cómo la organización defina la configuración de la estación de trabajo:

   

2. Haz clic en New Session.

3. Selecciona RStudio Pro como IDE y deja Clúster en Local.

   

   Para obtener más información sobre Posit Workbench y los IDE que admite, como los notebooks de Jupyter, JupyterLab y VS Code, consulta la documentación de Posit.

4. Haz clic en Iniciar sesión.

5. Espera a que se inicie la sesión y, luego, empieza a programar.

   

Sube archivos a tu estación de trabajo

1. Para subir archivos desde tu máquina local a tu estación de trabajo, haz clic en Subir.

   

2. Selecciona el directorio de destino en el que deseas almacenar los archivos de tu estación de trabajo.

3. Haz clic en Elegir archivo para seleccionar el archivo que deseas subir.

4. Para comenzar la carga, haz clic en Aceptar.

Para subir varios archivos o un directorio, crea un archivo ZIP. El archivo ZIP se expande después de la carga.

Importa archivos desde tu estación de trabajo

1. Para importar archivos desde tu estación de trabajo, haz clic en Importar conjunto de datos y selecciona el tipo de conjunto de datos.

   

2. Navega al conjunto de datos que deseas importar desde tu estación de trabajo y selecciónalo.

   El IDE de Posit Workbench tiene dependencias en varios paquetes de R para distintas piezas de funciones. Por ejemplo, si subes un archivo de Excel, debes instalar ciertos paquetes. Si se te solicita instalar los paquetes requeridos, haz clic en Sí.

3. Para comenzar la importación, haz clic en Importar.

Obtén asistencia para solucionar problemas con Posit Workbench

Si tienes problemas con Posit Workbench o con la imagen de contenedor de Posit Workbench, infórmalos a Posit en [e-mail].

¿Qué sigue?

• Obtén información sobre cómo personalizar la imagen de contenedor según las necesidades de tu organización.

• Obtén más información sobre Posit Workbench en la documentación de Posit Workbench.