Wie kann ich Probleme im Zusammenhang mit der Verbindung von Git-Repositorys mit Amazon SageMaker-Notebook-Instances beheben?

Lösung

Informationen zum Hinzufügen eines neuen Git-Repositorys zu Ihrer SageMaker-Notebook-Instance finden Sie unter Hinzufügen eines Git-Repositorys zu Ihrem Amazon SageMaker-Konto. Wenn Sie versuchen, ein Git-Repository hinzuzufügen, das nicht auf AWS CodeCommit gehostet wird, erhalten Sie möglicherweise die folgenden Fehler.

Fehler im Zusammenhang mit der Konnektivität

Bei Verbindungsproblemen wird möglicherweise einer der folgenden Fehler angezeigt:

• "fatal: unable to access <Git repository URL>: die angeforderte URL hat einen Fehler zurückgegeben: 403 Zoll
• "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: …"

Gehen Sie wie folgt vor, um diese Fehler zu beheben:

• Überprüfen Sie die Konnektivität der Notebook-Instance.
• Überprüfen Sie die Richtigkeit der Git-Repository-URL.

Überprüfen Sie die Konnektivität der Notebook-Instance

Stellen Sie sicher, dass die Notebook-Instance erfolgreich eine Verbindung zum Git-Repository hergestellt hat. Dieses Repository kann sich entweder auf einem lokalen Git-Repository-Server oder auf einem öffentlichen Cloud-Server wie GitHub, Bitbucket oder GitLab befinden.

Überprüfen Sie die Netzwerkkonfiguration, die Ihre Notebook-Instance verwendet. Die Notebook-Instance hat möglicherweise eine der folgenden Netzwerkkonfigurationen:

• Die Instance ist nicht an eine Amazon Virtual Private Cloud (VPC) angehängt.
• Ihre Amazon VPC hat direkten Internetzugang
• Ihre VPC hat keinen direkten Internetzugang.

Wenn Sie eine VPC verwenden, stellen Sie sicher, dass die Subnetze, Sicherheitsgruppen, Network Access Control Lists (ACLs), das NAT-Gateway, das Internet-Gateway und die Routing-Tabellen korrekt konfiguriert sind.

Überprüfen Sie die Richtigkeit der Git-Repository-URL

Vergewissere dich, dass die Git-Repository-URL, die du hinzufügst, das folgende Format hat:

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

Achten Sie darauf, Folgendes zu ersetzen:

• Workspace mit dem Namen des Git-Workspaces
• repository.git mit dem Namen des Code-Repositorys mit der Dateierweiterung *.git.

Wenn du beispielsweise Bitbucket als Git-Repository verwendest, wobei der Name deines Workspace myworkspace lautet und dein Git-Repository myrepository.git lautet, dann musst du die folgende Git-Repository-URL verwenden: https://bitbucket.org/myworkspace/myrepository.git

Fehler im Zusammenhang mit der Authentifizierung

Bei Authentifizierungsproblemen wird möglicherweise einer der folgenden Fehler angezeigt:

• „fatal: Der Benutzername für konnte nicht gelesen werden <Git repository URL>: terminal prompts disabled"
• „fatal: Das Passwort konnte nicht gelesen werden für <Git repository URL>: terminal prompts disabled"
• „fatal: Die Authentifizierung ist fehlgeschlagen für <Git repository URL>"

Gehen Sie wie folgt vor, um diese Fehler zu beheben:

• Überprüfen Sie die Authentifizierungsdetails.
• Stellen Sie sicher, dass der Benutzer oder die Rollen von AWS Identity and Access Management (IAM) über die erforderlichen Berechtigungen für den Zugriff auf AWS Secrets Manager verfügen.

Stellen Sie sicher, dass die Authentifizierungsdetails korrekt sind

Stellen Sie sicher, dass der Benutzername und das Passwort in Secrets Manager korrekt sind.

• GitHub: Wenn Sie die Zwei-Faktor-Authentifizierung aktiviert haben, müssen Sie ein persönliches Zugriffstoken anstelle eines Passworts verwenden. Nachdem dieses Token generiert wurde, müssen Sie das Passwort in Secrets Manager mit diesem neuen Token aktualisieren.
• Bitbucket: Bitbucket unterstützt keine Kontokennwörter für die Git-Authentifizierung. Es hat sich bewährt, App-Passwörter mithilfe Ihrer persönlichen Einstellungen zu erstellen. Nachdem Sie das App-Passwort erstellt haben, müssen Sie das Passwort in Secrets Manager aktualisieren.
• GitLab: Wenn Sie die Zwei-Faktor-Authentifizierung aktiviert haben, müssen Sie ein persönliches Zugriffstoken anstelle eines Passworts verwenden. Nachdem dieses Token generiert wurde, müssen Sie das Passwort in Secrets Manager mit diesem neuen Token aktualisieren.

Stellen Sie sicher, dass die IAM-Rolle der Notebook-Instance über die erforderlichen Berechtigungen verfügt

Stellen Sie sicher, dass der IAM-Rolle, die für die Notebook-Instance verwendet wird, in der IAM-Richtlinie die Berechtigung SecretsManager:GetSecretValue angehängt ist. Wenn die IAM-Rolle nicht über die erforderlichen Berechtigungen verfügt, können Sie der IAM-Rolle die folgende Richtlinie hinzufügen:

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

Hinweis: example-Secret-ARN ist der ARN in Secrets Manager das hat die Geheimnisse (Benutzername und Passwort) für die Git-Repository-Authentifizierung.

Fehler im Zusammenhang mit der Speicherung

Wenn Probleme mit dem Speicher auftreten, wird möglicherweise die folgende Fehlermeldung angezeigt:

Beim Klonen von Git Repo ist kein Speicherplatz mehr auf dem Gerät übrig. Bitte versuchen Sie es mit einem größeren Volumen

Um diesen Fehler zu beheben, stellen Sie sicher, dass die Notebook-Instance über ausreichend Speicherplatz verfügt. Stellen Sie sicher, dass der freie Speicherplatz auf dem Volume der Notebook-Instance größer ist als der des Git-Repositorys, das Sie zum Klonen verwenden. Wenn Ihnen der Speicherplatz ausgeht, geben Sie einen größeren Wert für VolumeSizeInGB an. Weitere Informationen finden Sie unter Anpassen der Volume-Größe Ihres Notebooks, bis zu 16 TB, mit Amazon SageMaker.

---

Ähnliche Informationen

Verknüpfen Sie Git-Repositorys mit SageMaker-Notebook-Instanceen

Verwendung von AWS CodeCommit mit VPC-Schnittstellenendpunkten