Come posso risolvere i problemi associati alla connessione dei repository Git alle istanze di notebook Amazon SageMaker?

Risoluzione

Per aggiungere un nuovo repository Git all'istanza del notebook SageMaker, consulta Add a Git repository to your Amazon SageMaker account. Se stai cercando di aggiungere un repository Git non ospitato su AWS CodeCommit, potresti ricevere i seguenti errori.

Errori associati alla connettività

In caso di problemi di connettività, è possibile che si verifichi uno dei seguenti errori:

• "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: …"

Per risolvere questi errori, procedi come segue:

• Verifica la connettività dell'istanza del notebook.
• Verifica l'accuratezza dell'URL del repository Git.

Verifica la connettività dell'istanza del notebook

Assicurati che l'istanza del notebook sia stata connessa correttamente al repository Git. Questo repository potrebbe trovarsi su un server di repository Git locale o su un server cloud pubblico, come GitHub, Bitbucket o GitLab.

Controlla la configurazione di rete utilizzata dall'istanza del notebook. L'istanza del notebook potrebbe avere una delle seguenti configurazioni di rete:

• L'istanza non è collegata a un cloud privato virtuale (VPC) Amazon.
• Il tuo Amazon VPC ha accesso diretto a Internet
• Il tuo VPC non dispone di accesso diretto a Internet.

Se utilizzi un VPC, assicurati che le sottoreti, i gruppi di sicurezza, gli elenchi di controllo degli accessi alla rete (ACL), il gateway NAT, il gateway Internet e le tabelle di routing siano configurati correttamente.

Verifica l'accuratezza dell'URL del repository Git

Assicurati che l'URL del repository Git che stai aggiungendo sia nel seguente formato:

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

Assicurati di sostituire quanto segue:

• workspace con il nome dell'area di lavoro Git
• repository.git con il nome del repository di codice con l'estensione del file *.git.

Ad esempio, se utilizzi Bitbucket come repository Git in cui il nome del tuo spazio di lavoro è myworkspace e il tuo repository Git è myrepository.git, devi utilizzare il seguente URL del repository Git: https://bitbucket.org/myworkspace/myrepository.git

Errori associati all'autenticazione

In caso di problemi di autenticazione, è possibile che si verifichi uno dei seguenti errori:

• "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>"

Per risolvere questi errori, procedi come segue:

• Verifica i dettagli di autenticazione.
• Verifica che l'utente o i ruoli di AWS Identity and Access Management (IAM) dispongano delle autorizzazioni necessarie per accedere ad AWS Secrets Manager.

Verifica che i dettagli di autenticazione siano accurati

Assicurati che il nome utente e la password siano corretti in Secrets Manager.

• GitHub: Se hai abilitato l'autenticazione a due fattori, devi utilizzare un token di accesso personale anziché una password. Dopo la generazione di questo token, devi aggiornare la password in Secrets Manager con questo nuovo token.
• Bitbucket: Bitbucket non supporta le password degli account per l'autenticazione Git. È consigliabile creare le password delle app utilizzando le impostazioni personali. Dopo aver creato la password dell'app, devi aggiornare la password in Secrets Manager.
• GitLab: Se hai abilitato l'autenticazione a due fattori, devi utilizzare un token di accesso personale anziché una password. Dopo la generazione di questo token, devi aggiornare la password in Secrets Manager con questo nuovo token.

Verifica che il ruolo IAM dell'istanza del notebook disponga delle autorizzazioni richieste

Verifica che il ruolo IAM utilizzato per l'istanza del notebook abbia l'autorizzazione secretsmanager:GetSecretValue allegata alla policy IAM. Se il ruolo IAM non dispone delle autorizzazioni richieste, puoi aggiungere la seguente policy al ruolo 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 is l’ARN in Secrets Manager che contiene i segreti (nome utente e password) per l'autenticazione del repository Git.

Errori associati all'archiviazione

In caso di problemi relativi allo spazio di archiviazione, è possibile che venga visualizzato il seguente errore:

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

Per risolvere questo errore, verifica che l'istanza del notebook disponga di spazio di archiviazione sufficiente. Assicurati che la dimensione dello spazio libero nel volume dell'istanza del notebook sia maggiore di quella del repository Git che stai usando per clonare. Se esaurisci lo spazio su disco, specifica un valore maggiore per VolumeSizeInGB. Per ulteriori informazioni, consulta Customize your notebook volume size, up to 16 TB, with Amazon SageMaker.

---

Informazioni correlate

Associa i repository Git alle istanze notebook SageMaker

Utilizzo di AWS CodeCommit con endpoint VPC di interfaccia