Usa 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 GitHub repositorio y libretas. Este botón te permite clonar tus libretas directamente desde Studio Lab.

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

Utilice GitHub los recursos

Studio Lab ofrece integración con GitHub. Con esta integración, puedes clonar blocs de notas y repositorios directamente en tu proyecto de Studio Lab.

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

Cuadernos de muestra de Studio Lab

Para empezar con un repositorio de cuadernos de muestra diseñados para Studio Lab, consulta los cuadernos de muestra de Studio Lab.

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

• Visión artificial

• Conectándose a AWS

• Creación de entornos personalizados

• Análisis de datos geoespaciales

• Procesamiento de lenguaje natural

• Uso de R

Clonar un GitHub repositorio

Para clonar un GitHub repositorio en tu proyecto de Studio Lab, sigue estos pasos.

1. Inicie el tiempo de ejecución de su proyecto de Studio Lab. Para obtener más información sobre cómo iniciar el tiempo de ejecución de proyectos de Studio Lab, consulteIniciar 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 del explorador de archivos aparezca a la izquierda.

3. Navegue hasta su directorio de usuarios seleccionando el icono de archivo situado debajo de la barra de búsqueda de archivos.

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

5. Seleccione Clonar un repositorio.

6. Pegue el repositorio en el URL repositorio de Git URL (.git).

7. Selecciona Clonar.

Clona cuadernos individuales de GitHub

Para abrir un bloc de notas en Studio Lab, debe tener acceso al repositorio en el que se encuentra el bloc de notas. Los siguientes ejemplos describen el comportamiento de Studio Lab relacionado con los permisos en diversas situaciones.

• Si un repositorio es público, puedes clonar automáticamente el bloc de notas en tu proyecto desde la página de vista previa de Studio Lab.

• Si un repositorio es privado, se te pedirá que inicies sesión en él GitHub desde la página de vista previa de Studio Lab. Si tienes acceso a un repositorio privado, puedes clonar el bloc de notas en tu proyecto.

• Si no tienes acceso a un repositorio privado, no puedes clonar el bloc de notas desde la página de vista previa de Studio Lab.

En las siguientes secciones, se muestran dos opciones para copiar una GitHub libreta en tu proyecto de Studio Lab. Estas opciones dependen de si el bloc de notas tiene el botón Abrir en Studio Lab.

Opción 1: Copiar el bloc de notas con el botón Abrir en Studio Lab

El siguiente procedimiento muestra cómo copiar un bloc de notas que tiene el botón Abrir en Studio Lab. Si desea añadir este botón a su bloc de notas, consulteAñada el botón Abrir en Studio Lab a su bloc de notas.

1. Inicie sesión en Studio Lab siguiendo los pasos que se indicanInicia sesión en Studio Lab.

2. En una nueva pestaña del navegador, navega hasta el GitHub bloc de notas que quieres clonar.

3. En el bloc de notas, selecciona el botón Abrir en Studio Lab para abrir una nueva página en Studio Lab con una vista previa del bloc de notas.

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 comience el tiempo de ejecución antes de continuar con el siguiente paso.

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 la sección ¿Copiar desde GitHub? cuadro de diálogo, seleccione Copiar solo el bloc de notas. Esto copia el archivo del cuaderno a su proyecto.

Opción 2: clona cualquier GitHub bloc de notas

El siguiente procedimiento muestra cómo copiar cualquier bloc de notas de GitHub.

1. Navegue hasta el cuaderno en GitHub.

2. En la barra de direcciones del navegador, modifique el bloc URL de notas de la siguiente manera.

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

3. Navegue hasta la versión modificadaURL. Se abrirá una vista previa del bloc de notas 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 comience el tiempo de ejecución antes de continuar con el siguiente paso.

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 la sección ¿Copiar desde GitHub? cuadro de diálogo, seleccione Copiar solo el bloc de notas para copiar el archivo del bloc de notas al proyecto.

Añada el botón Abrir en Studio Lab a su bloc de notas

Al añadir el botón Abrir en Studio Lab a tus libretas, otras personas podrán clonar tus libretas o repositorios directamente en sus proyectos de Studio Lab. Si compartes tu bloc de notas en un GitHub repositorio público, tu contenido se podrá leer públicamente. No compartas contenido privado, como claves de AWS acceso o AWS Identity and Access Management credenciales, en tu bloc de notas.

Para añadir el funcional botón Abrir en Studio Lab a tu bloc de notas o repositorio de Jupyter, añade la siguiente anotación en la parte superior de tu bloc de notas 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>)

Importa archivos desde tu ordenador

Los siguientes pasos muestran cómo importar archivos desde el ordenador a un proyecto de Studio Lab. 

1. Abre el motor de ejecución del proyecto de Studio Lab.

2. Abre el panel del 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 desde su máquina local.

5. Seleccione Abrir.

Como alternativa, puede arrastrar y soltar los archivos de su ordenador en el panel del explorador de archivos.

Conexión a Amazon S3

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

Para utilizarlos AWS CLI con Studio Lab, complete los siguientes pasos. Para ver un cuaderno en el que se describe esta integración, consulte Uso de Studio Lab con AWS recursos.

1. Instale los AWS CLI siguientes pasos que se indican en Instalación o actualización de la última versión de AWS CLI.

2. Configure sus AWS credenciales siguiendo los pasos de Configuración rápida. El rol de su AWS cuenta debe tener permisos para acceder al bucket de Amazon S3 desde el que está copiando los datos.

3. Desde su bloc de notas de Jupyter, clone los recursos del bucket de Amazon S3, según sea necesario. El siguiente comando 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