¿Cómo puedo solucionar los problemas relacionados con la conexión de los repositorios de Git a las instancias del cuaderno de Amazon SageMaker?

Resolución

Para añadir un nuevo repositorio de Git a su instancia de bloc de cuaderno de SageMaker, consulte Add a Git repository to your Amazon SageMaker account. Si está intentando añadir un repositorio de Git que no está alojado en AWS CodeCommit, es posible que aparezcan los siguientes errores.

Errores asociados a la conectividad

Si hay problemas de conectividad, es posible que aparezca uno de los siguientes errores:

• «fatal: unable to access <Git repository URL>: the requested URL returned error: 403»
• «fatal: unable to access <Git repository URL>: failed to connect to …: port 443: connection timed out»
• «fatal: unable to access <Git repository URL> could not resolve the host: …»

Para solucionar estos errores, haga lo siguiente:

• Compruebe la conectividad de la instancia del cuaderno.
• Compruebe la precisión de la URL del repositorio de Git.

Comprobación de la conectividad de la instancia del cuaderno

Asegúrese de que la instancia de cuaderno se haya conectado correctamente al repositorio de Git. Este repositorio puede estar ubicado en un servidor de repositorio Git local o en un servidor de nube pública, como GitHub, Bitbucket o GitLab.

Compruebe la configuración de red que utiliza la instancia de cuaderno. La instancia de cuaderno puede tener una de las siguientes configuraciones de red:

• La instancia no está conectada a una instancia de Amazon Virtual Private Cloud (VPC).
• Su instancia de Amazon VPC tiene acceso directo a Internet
• Su VPC no tiene acceso directo a Internet.

Si utiliza una VPC, asegúrese de que las subredes, los grupos de seguridad, las listas de control de acceso a la red (ACL), la puerta de enlace NAT, la puerta de enlace a Internet y las tablas de enrutamiento estén configurados correctamente.

**Comprobación de la precisión de la URL del repositorio de Git **

Asegúrese de que la URL del repositorio de Git que va a añadir tenga el siguiente formato:

• URL de GitHub: https://github.com/<workspace>/<repository.git>
• URL de Bitbucket: https://bitbucket.org/<workspace>/<repository.git>
• URL de GitLab: https://gitlab.com/<workspace>/<repository.git>

Asegúrese de reemplazar lo siguiente:

• workspace por el nombre del espacio de trabajo de Git
• repository.git por el nombre del repositorio de códigos que tiene la extensión de archivo *.git.

Por ejemplo, si utiliza Bitbucket como un repositorio de Git donde el nombre de su espacio de trabajo es myworkspace y su repositorio de Git es myrepository.git, debe usar la siguiente URL de repositorio de Git: https://bitbucket.org/myworkspace/myrepository.git

Errores asociados a la autenticación

Si hay problemas de autenticación, es posible que aparezca uno de los siguientes errores:

• «fatal: could not read Username for <Git repository URL>: terminal prompts disabled»
• «fatal: could not read Password for <Git repository URL>: terminal prompts disabled»
• «fatal: authentication failed for <Git repository URL>»

Para solucionar estos errores, haga lo siguiente:

• Compruebe los detalles de autenticación.
• Compruebe que el usuario o los roles de AWS Identity and Access Management (IAM) tienen los permisos necesarios para acceder a AWS Secrets Manager.

Comprobación de que los detalles de autenticación sean precisos

Asegúrese de que el nombre de usuario y la contraseña sean correctos en Secrets Manager.

• GitHub: Si ha activado la autenticación de dos factores, debe utilizar un token de acceso personal en lugar de una contraseña. Una vez generado este token, debe actualizar la contraseña en Secrets Manager con este nuevo token.
• Bitbucket: Bitbucket no admite contraseñas de cuenta para la autenticación de Git. Se recomienda crear contraseñas de aplicaciones con su Configuración personal. Tras crear la contraseña de la aplicación, debe actualizarla en Secrets Manager.
• GitLab: si ha activado la autenticación de dos factores, debe utilizar un token de acceso personal en lugar de una contraseña. Una vez generado este token, debe actualizar la contraseña en Secrets Manager con este nuevo token.

Compruebe que el rol de IAM de la instancia del cuaderno tenga los permisos necesarios

Compruebe que el rol de IAM utilizado para la instancia del cuaderno tenga el permiso secretsmanager:GetSecretValue adjunto a su política de IAM. Si el rol de IAM no tiene los permisos necesarios, puede añadir la siguiente política al rol de IAM:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Resource": [
        "example-secret-ARN"
      ]
    },
    {
      "Effect": "Allow",
      "Action": "secretsmanager:ListSecrets",
      "Resource": "*"
    }
  ]
}

Nota: example-secret-ARN es el ARN de Secrets Manager que contiene los secretos (nombre de usuario y contraseña) para la autenticación del repositorio de Git.

Errores asociados al almacenamiento

Si hay problemas relacionados con el almacenamiento, es posible que aparezca el siguiente error:

No space left on device while cloning Git repo. Please try using a larger volume

Para resolver este error, compruebe que la instancia del cuaderno tenga suficiente espacio de almacenamiento. Asegúrese de que el espacio libre en el volumen de la instancia del cuaderno sea mayor que el del repositorio de Git que está utilizando para clonar. Si se queda sin espacio en el disco, especifique un valor mayor para VolumeSizeInGB. Para más información, consulte Customize your notebook volume size, up to 16 TB, with Amazon SageMaker.

---

Información relacionada

Associate Git repositories with SageMaker notebook instances

Using AWS CodeCommit with interface VPC endpoints