Vincular repositorios basados en Git a un espacio de trabajo de EMR Studio - Amazon EMR
Acerca deRequisitos previosInstrucciones

Vincular repositorios basados en Git a un espacio de trabajo de EMR Studio

Asocie hasta tres repositorios basados en Git a un espacio de trabajo de Amazon EMR Studio para guardar y compartir archivos de cuaderno.

Acerca de los repositorios de Git para EMR Studio

Puede asociar un máximo de tres repositorios de Git a un espacio de trabajo de EMR Studio. De forma predeterminada, cada espacio de trabajo le permite elegir en una lista de repositorios de Git que están asociados a la misma cuenta de AWS que el estudio. También puede crear un nuevo repositorio de Git como recurso para un espacio de trabajo.

Puede ejecutar comandos de Git como los siguientes mediante un comando de terminal mientras está conectado al nodo principal de un clúster. 

!git pull origin <branch-name>

También puede utilizar la extensión jupyterlab-git. Ábralo desde la barra lateral izquierda seleccionando el icono de Git. Para obtener información sobre la extensión jupyterlab-git de JupyterLab, consulte jupyterlab-git.

Requisitos previos

Para vincular un repositorio de Git asociado a un espacio de trabajo

  1. Abra el espacio de trabajo que quiera vincular a un repositorio desde la lista Espacios de trabajo del estudio.

  2. En la barra lateral izquierda, seleccione el icono del repositorio de Git de Amazon EMR para abrir el panel de herramientas del repositorio de Git.

  3. En Repositorios de Git, expanda la lista desplegable y seleccione un máximo de tres repositorios para vincularlos al espacio de trabajo. EMR Studio registra su selección y comienza a vincular cada repositorio.

Es posible que el proceso de vinculación tarde algún tiempo en completarse. Puede ver el estado de cada repositorio que haya seleccionado en el panel de herramientas del repositorio de Git. Después de que EMR Studio vincule un repositorio a un espacio de trabajo, debería ver los archivos que pertenecen a ese repositorio en el panel del Explorador de archivos.

Para agregar un nuevo repositorio de Git a un espacio de trabajo como recurso

  1. Abra el espacio de trabajo que quiera vincular a un repositorio desde la lista de espacios de trabajo del estudio.

  2. En la barra lateral izquierda, seleccione el icono del repositorio de Git de Amazon EMR para abrir el panel de herramientas del repositorio de Git.

  3. Seleccione Agregar nuevo repositorio de Git.

  4. En Nombre del repositorio, escriba un nombre descriptivo para el repositorio de EMR Studio. Los nombres pueden contener caracteres alfanuméricos, guiones o guiones bajos.

  5. En Git repository URL (URL del repositorio de Git), escriba la URL del repositorio. Cuando utiliza un repositorio de CodeCommit, esta es la URL que se copia cuando selecciona Clonar URL y, a continuación, Clonar HTTPS. Por ejemplo, https://git-codecommit.us-west-2.amazonaws.com/v1/repos/[MyCodeCommitRepoName].

  6. En Ramificación, introduzca el nombre de una ramificación existente que quiera seleccionar.

  7. En Credenciales de Git, seleccione una opción de acuerdo con las siguientes pautas. EMR Studio accede a sus credenciales de Git mediante los secretos almacenados en Secrets Manager.

    nota

    Si utiliza un repositorio de GitHub, le recomendamos que utilice un token de acceso personal (PAT) para autenticarse. A partir del 13 de agosto de 2021, GitHub requerirá la autenticación basada en tokens y ya no aceptará contraseñas al autenticar las operaciones de Git. Para obtener más información, consulta la publicación sobre los requisitos de autenticación con token para las operaciones de Git en The GitHub Blog.

    Opción Descripción
    Crear un nuevo secreto

    Seleccione esta opción para asociar las credenciales de Git existentes a un nuevo secreto que se creará en AWS Secrets Manager para usted. Realice una de las siguientes acciones basadas en las credenciales de Git que utilice para el repositorio.

    Si usa un nombre de usuario y una contraseña de Git para acceder al repositorio, seleccione Nombre de usuario y contraseña, escriba el nombre secreto que va a usar en Secrets Manager y, a continuación, escriba el nombre de usuario y la contraseña que asociará al secreto.

    –O BIEN–

    Si utiliza un token de acceso personal para acceder al repositorio, seleccione Token de acceso personal (PAT), escriba el nombre del secreto que usará en Secrets Manager y, a continuación, escriba su token de acceso personal. Para obtener más información, consulte Creating a personal access token for the command line for GitHub yPersonal access tokens for Bitbucket. Los repositorios de CodeCommit no admiten esta opción.
    Usar un repositorio público sin credenciales Elija esta opción para acceder a un repositorio público.
    Usar un secreto de AWS existente

    Elija esta opción si ya ha guardado sus credenciales como un secreto en Secrets Manager y, a continuación, seleccione el nombre del secreto en la lista.

    Si selecciona un secreto asociado con un nombre de usuario y contraseña de Git, el secreto debe estar en el formato {"gitUsername": "MyUserName", "gitPassword": "MyPassword"}.

  8. Seleccione Agregar repositorio para crear el nuevo repositorio. Después de que EMR Studio cree el nuevo repositorio, verá un mensaje de confirmación. El nuevo repositorio aparece en la lista desplegable de Repositorios de Git.

  9. Para vincular el nuevo repositorio a su espacio de trabajo, selecciónelo en la lista desplegable de Repositorios de Git.

Es posible que el proceso de vinculación tarde algún tiempo en completarse. Después de que EMR Studio vincule el nuevo repositorio al espacio de trabajo, debería aparecer una nueva carpeta con el mismo nombre que el repositorio en el panel del Explorador de archivos.

Para abrir un repositorio vinculado diferente, navegue hasta su carpeta en el Explorador de archivos.