Uso de recursos externos en Amazon SageMaker Studio Lab

Con Amazon SageMaker Studio Lab, puede integrar recursos externos, como cuadernos y datos de Jupyter, de los repositorios de Git y Amazon S3. También puede añadir un botón Abrir en Studio Lab a su repositorio y sus cuadernos de GitHub. Este botón permite clonar los cuadernos directamente desde Studio Lab.

En los siguientes temas, se indica cómo integrar recursos externos.

Uso de recursos de GitHub

Studio Lab ofrece integración con GitHub. Con esta integración, puede clonar cuadernos y repositorios directamente en su proyecto de Studio Lab.

En los siguientes temas se proporciona información sobre cómo utilizar los recursos de GitHub con Studio Lab.

Ejemplos de cuadernos de Studio Lab

Para empezar con un repositorio de ejemplos de cuadernos diseñados para Studio Lab, consulte Ejemplos de cuadernos de Studio Lab.

Este repositorio proporciona cuadernos para los siguientes casos de uso, entre otros.

• Visión artificial

• Conectarse a AWS

• Creación de entornos personalizados

• Análisis de datos geoespaciales

• Procesamiento de lenguaje natural

• Uso de R

Clonación de un repositorio de GitHub

Para clonar un repositorio de GitHub en su proyecto de Studio Lab, siga estos pasos.

1. Inicie el tiempo de ejecución de su proyecto de Studio Lab. Para obtener más información sobre cómo inicializar el tiempo de ejecución de un proyecto de Studio Lab, consulte Iniciar el tiempo de ejecución del proyecto.

2. En Studio Lab, seleccione el icono del Explorador de archivos ( ) en el menú de la izquierda para que el panel Explorador de archivos aparezca a la izquierda.

3. Vaya a su directorio de usuarios; para ello, elija el icono de archivo situado debajo de la barra de búsqueda de archivos.

4. Seleccione el icono de Git ( ) en el menú de la izquierda para abrir un nuevo menú desplegable.

5. Seleccione Clonar un repositorio.

6. Pegue la URL del repositorio en URL del repositorio de Git (.git).

7. Seleccione Clonar.

Clonación de cuadernos individuales desde GitHub

Para abrir un cuaderno en Studio Lab, debe tener acceso al repositorio en el que se encuentra el cuaderno. En los siguientes ejemplos se describe el comportamiento de Studio Lab en relación con los permisos en diversas situaciones.

• Si un repositorio es público, puede clonar automáticamente el cuaderno en su proyecto desde la página de vista previa de Studio Lab.

• Si un repositorio es privado, se le pedirá que inicie sesión en GitHub desde la página de vista previa de Studio Lab. Si tiene acceso a un repositorio privado, puede clonar el cuaderno en su proyecto.

• Si no tiene acceso a un repositorio privado, no puede clonar el cuaderno desde la página de vista previa de Studio Lab.

En las siguientes secciones se muestran dos opciones para copiar un cuaderno de GitHub en su proyecto de Studio Lab. Estas opciones dependen de si el cuaderno tiene el botón Abrir en Studio Lab.

Opción 1: copia de un cuaderno con el botón Abrir en Studio Lab

En el siguiente procedimiento se muestra cómo copiar un cuaderno que tiene el botón Abrir en Studio Lab. Si desea agregar este botón a su cuaderno, consulte Adición de un botón Abrir en Studio Lab a un cuaderno.

1. Lance Studio Lab siguiendo los pasos que se indican en Inicio de sesión en Studio Lab.

2. En una nueva pestaña del navegador, vaya al cuaderno de GitHub que quiera clonar.

3. En el cuaderno, seleccione el botón Abrir en Studio Lab para abrir una nueva página en Studio Lab con una vista previa del cuaderno.

4. Si el tiempo de ejecución del proyecto aún no está en ejecución, inícielo pulsando el botón Iniciar tiempo de ejecución en la parte superior de la página de vista previa. Espere a que el estado del tiempo de ejecución se inicie antes de ir al paso siguiente.

5. Una vez iniciado el tiempo de ejecución del proyecto, seleccione Copiar al proyecto para abrir el tiempo de ejecución del proyecto en una nueva pestaña del navegador.

6. En el cuadro de diálogo ¿Copiar de GitHub?, seleccione Copiar solo el cuaderno. Se copiará el archivo del cuaderno en su proyecto.

Opción 2: clonación de cualquier cuaderno de GitHub

En el siguiente procedimiento se muestra cómo copiar cualquier cuaderno de GitHub.

1. Vaya al cuaderno en GitHub.

2. En la barra de direcciones del navegador, modifique la URL del cuaderno como se indica a continuación.

   # Original URL
   https://github.com/<PATH_TO_NOTEBOOK>
   
   # Modified URL 
   https://studiolab.sagemaker.aws/import/github/<PATH_TO_NOTEBOOK>

3. Vaya a la URL modificada. Se abre una vista previa del cuaderno en Studio Lab.

4. Si el tiempo de ejecución del proyecto aún no está en ejecución, inícielo pulsando el botón Iniciar tiempo de ejecución en la parte superior de la página de vista previa. Espere a que el estado del tiempo de ejecución se inicie antes de ir al paso siguiente.

5. Una vez iniciado el tiempo de ejecución del proyecto, seleccione Copiar al proyecto para abrir el tiempo de ejecución del proyecto en una nueva pestaña del navegador.

6. En el cuadro de diálogo ¿Copiar de GitHub?, seleccione Copiar solo el cuaderno para copiar el archivo del cuaderno en su proyecto.

Adición de un botón Abrir en Studio Lab a un cuaderno

Si añade el botón Abrir en Studio Lab a sus cuadernos, otras personas podrán clonarlos estos últimos o los repositorios directamente en los proyectos de Studio Lab que tengan. Si comparte su cuaderno en un repositorio público de GitHub, su contenido se podrá leer públicamente. No comparta contenido privado, como claves de acceso de AWS o credenciales de AWS Identity and Access Management, en su cuaderno.

Para añadir el botón Abrir en Studio Lab funcional a su cuaderno o repositorio de Jupyter, agregue el marcado siguiente en la parte superior de su cuaderno o repositorio.

[![Open In SageMaker Studio Lab](https://studiolab.sagemaker.aws/studiolab.svg)](https://studiolab.sagemaker.aws/import/github/<PATH_TO_YOUR_NOTEBOOK_ON_GITHUB>)

Importación de archivos desde su equipo

En los pasos siguientes se muestra cómo importar archivos del equipo a un proyecto de Studio Lab. 

1. Abra el tiempo de ejecución del proyecto de Studio Lab.

2. Abra el panel Explorador de archivos.

3. En la barra de acciones del panel del Explorador de archivos, seleccione el botón Cargar archivos.

4. Seleccione los archivos que desee cargar del equipo local.

5. Seleccione Abrir.

Como alternativa, puede arrastrar y soltar archivos del equipo al panel del Explorador de archivos.

Conexión a Amazon S3

La AWS CLI permite la integración de AWS en su proyecto de Studio Lab. Con esta integración, puede extraer recursos de Amazon S3 para usarlos con sus cuadernos de Jupyter.

Para utilizar la AWS CLI con Studio Lab, lleve a cabo los pasos siguientes. Para obtener un cuaderno en el que se describe esta integración, consulte Using Studio Lab with AWS Resources.

1. Instale y configure los siguientes pasos de la AWS CLI en Instalación o actualización de la versión más reciente de la AWS CLI.

2. Configure sus credenciales de AWS siguiendo los pasos de Configuración rápida. El rol de su cuenta de AWS debe disponer de permisos para obtener acceso al bucket de Amazon S3 cuyos datos se están copiando.

3. Desde el cuaderno de Jupyter, clone recursos del bucket de Amazon S3, según sea necesario. En el siguiente comando se muestra cómo clonar todos los recursos de una ruta de Amazon S3 a su proyecto. Para obtener más información, consulte Referencia de comandos de la AWS CLI.

   !aws s3 cp s3://<BUCKET_NAME>/<PATH_TO_RESOURCES>/ <PROJECT_DESTINATION_PATH>/ --recursive