Desarrollar código con Posit Workbench (incluye RStudio Pro)

Precaución: Un proveedor externo mantiene la imagen del contenedor que se indica 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 estos pasos de configuración obligatorios:

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 IAM de Administrador de estaciones de trabajo de Cloud en el proyecto para que puedas crear configuraciones de estaciones de trabajo.

   Si eres desarrollador y no tienes configuraciones 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:

   Ve a IAM

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

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

1. Busca la clave de licencia de Posit Workbench y mantenla a mano porque 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 (incluye RStudio Pro) proporcionado por terceros".

   3. Haz clic en la flecha del arrow_drop_downexpandidor en la sección Opciones avanzadas de contenedor.

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

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

         

      3. Haz clic en Continuar.

   4. Cuando llegues al paso Agregar usuarios, otorga a tus desarrolladores permisos de acceso de IAM a las estaciones de trabajo de Cloud a 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 Posist 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 > Estaciones de trabajo.

   Ve a Estaciones de trabajo.

2. Haz clic en add_boxCrear.

   Es posible que el vínculo Create esté inhabilitado si no hay ninguna configuración en el proyecto o si no tienes permiso 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 nombres de los recursos de Compute Engine y elige un nombre único dentro del clúster de estaciones 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 (tercero).

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 la 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 la estación de trabajo, haz clic en Iniciar para confirmar. El estado cambia a Iniciada y el ícono de estado actualizar 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.

Cómo iniciar una sesión de RStudio Pro de Posit Workbench

1. En el siguiente ejemplo, se muestra la página de bienvenida de Posit Workbench. Es posible que tu página se vea diferente según la forma en que tu organización defina la configuración de tu estación de trabajo:

   

2. Haz clic en Nueva sesión.

3. Selecciona RStudio Pro como el IDE y deja Cluster configurado en Local.

   

   Para obtener más información sobre Posit Workbench y los IDEs que admite, como Jupyter Notebook, 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, comienza a programar.

   

Sube archivos a tu estación de trabajo

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

   

2. Selecciona el directorio de destino en el que deseas almacenar los archivos en 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 Import dataset 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 diferentes partes de las funciones. Por ejemplo, si subes un archivo de Excel, se deben instalar ciertos paquetes. Si se te solicita que instales los paquetes necesarios, haz clic en Sí.

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

Obtén asistencia para solucionar problemas de Posit Workbench

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

¿Qué sigue?

• Obtén más información para personalizar la imagen del 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.