Git-basierte Repositorys mit einem EMR Studio Workspace verknüpfen

Ordnen Sie einem Amazon EMR Studio Workspace bis zu drei Git-basierte Repositorys zu, um Notebookdateien zu speichern und gemeinsam zu nutzen.

Über Git-Repositorys für EMR Studio

Sie können einem EMR Studio Workspace maximal drei Git-Repositorys zuordnen. Standardmäßig können Sie in jedem Workspace aus einer Liste von Git-Repositorys wählen, die demselben AWS Konto wie das Studio zugeordnet sind. Sie können auch ein neues Git-Repository als Ressource für einen Workspace erstellen.

Sie können Git-Befehle wie die folgenden mit einem Terminalbefehl ausführen, während Sie mit dem Primärknoten eines Clusters verbunden sind.

!git pull origin <branch-name>

Alternativ kannst du den jupyterlab-git Erweiterung. Öffnen Sie es in der linken Seitenleiste, indem Sie das Git-Symbol auswählen. Informationen zur Jupyterlab-Git-Erweiterung für finden Sie unter jupyterlab-git. JupyterLab

Voraussetzungen

• Um ein Git-Repository mit einem Workspace zu verknüpfen, muss Ihr Studio so konfiguriert sein, dass die Verknüpfung mit Git-Repositorys zulässig ist. Ihr Studio-Administrator sollte folgende Schritte unternehmen, um Zugriff und Berechtigungen für Git-basierte Repositorys einrichten.

• Wenn Sie ein CodeCommit Repository verwenden, müssen Sie Git-Anmeldeinformationen und HTTPS verwenden. SSH-Schlüssel und HTTPS mit dem AWS Command Line Interface Credential Helper werden nicht unterstützt. CodeCommit unterstützt auch keine persönlichen Zugriffstoken ()PATs. Weitere Informationen finden Sie unter Using IAM with CodeCommit im IAM-Benutzerhandbuch und Setup für HTTPS-Benutzer mit Git-Anmeldeinformationen im AWS CodeCommit User Guide.

Anweisungen

So verknüpfen Sie ein zugeordnetes Git-Repository mit einem Workspace

1. Öffnen Sie den Workspace, den Sie mit einem Repository verknüpfen möchten, in der Workspaces-Liste im Studio.

2. Wählen Sie in der linken Seitenleiste das Amazon-EMR-Git-Repository-Symbol, um das Git-Repository-Toolpanel zu öffnen.

3. Erweitern Sie unter Git-Repositorys die Drop-down-Liste und wählen Sie maximal drei Repositorys aus, die mit dem Workspace verknüpft werden sollen. EMR Studio registriert Ihre Auswahl und beginnt, jedes Repository zu verknüpfen.

Es kann einige Zeit dauern, bis der Verbindungsvorgang abgeschlossen ist. Sie können den Status für jedes Repository sehen, das Sie im Git-Repository-Toolpanel ausgewählt haben. Nachdem EMR Studio ein Repository mit einem Workspace verknüpft hat, sollten die Dateien, die zu diesem Repository gehören, im Dateibrowser-Bereich angezeigt werden.

Um einem Workspace ein neues Git-Repository als Ressource hinzuzufügen

1. Öffnen Sie den Workspace, den Sie mit einem Repository verknüpfen möchten, in der Workspaces-Liste im Studio.

2. Wählen Sie in der linken Seitenleiste das Amazon-EMR-Git-Repository-Symbol, um das Git-Repository-Toolpanel zu öffnen.

3. Wählen Sie Neues Git-Repository hinzufügen.

4. Geben Sie unter Repository-Name einen Namen ein, der für das Repository in EMR Studio verwendet werden soll. Namen dürfen nur alphanumerische Zeichen, Bindestriche oder Unterstriche enthalten.

5. Geben Sie für Git repository URL (Git-Repository-URL) die URL für das Repository ein. Wenn Sie ein CodeCommit Repository verwenden, wird diese URL kopiert, wenn Sie „URL klonen“ und dann „HTTPS klonen“ wählen. Beispiel, https://git-codecommit.us-west-2.amazonaws.com/v1/repos/[MyCodeCommitRepoName].

6. Geben Sie für Branch den Namen eines vorhandenen Branches ein, den Sie auschecken möchten.

7. Wählen Sie Optionen für Git-Anmeldeinformationen gemäß den folgenden Richtlinien. EMR Studio greift mithilfe von Geheimnissen, die im Secrets Manager gespeichert sind, auf Ihre Git-Anmeldeinformationen zu.

   Anmerkung

   Wenn Sie ein GitHub Repository verwenden, empfehlen wir Ihnen, zur Authentifizierung ein Personal Access Token (PAT) zu verwenden. Ab dem 13. August 2021 ist eine tokenbasierte Authentifizierung erforderlich und bei der Authentifizierung von Git-Vorgängen werden keine Passwörter mehr akzeptiert. GitHub Weitere Informationen finden Sie im Beitrag Token-Authentifizierungsanforderungen für Git-Operationen im GitHub Blog.

   Option	Beschreibung
   Erstellen eines neuen Secrets	Wählen Sie diese Option, um bestehende Git-Anmeldeinformationen mit einem neuen Geheimnis zu verknüpfen, das AWS Secrets Manager für Sie erstellt wird. Führen Sie basierend auf den Git-Anmeldeinformationen, die Sie für das Repository verwenden, einen der folgenden Schritte aus. Wenn Sie für den Zugriff auf das Repository einen Git-Benutzernamen mit Passwort verwenden, wählen Sie Benutzername und Passwort aus, geben Sie den Namen des Secrets ein, das in Secrets Manager verwendet werden soll, und geben Sie dann den Benutzernamen und das Passwort ein, die mit dem Secret verknüpft werden sollen. -ODER- Wenn Sie ein persönliches Zugriffstoken für den Zugriff auf das Repository verwenden, wählen Sie Persönliches Zugriffstoken (PAT) aus, geben Sie den Secret-Name ein, der in Secrets Manager verwendet werden soll, und geben Sie dann Ihr persönliches Zugriffstoken ein. Weitere Informationen findest du unter Persönliches Zugriffstoken für die Befehlszeile erstellen für GitHub und Persönliche Zugriffstoken für Bitbucket. CodeCommit Repositorys unterstützen diese Option nicht.
   Verwenden eines öffentlichen Repository ohne Anmeldeinformationen	Wählen Sie diese Option, um auf ein öffentliches Repository zuzugreifen.
   Verwenden Sie ein vorhandenes Geheimnis AWS	Wählen Sie diese Option, wenn Sie Ihre Anmeldeinformationen bereits als Secret in Secrets Manager gespeichert haben, und wählen Sie dann den Namen des Secrets in der Liste aus. Wenn Sie ein Secret auswählen, das mit einem Git-Benutzernamen und -Passwort verknüpft ist, muss das Secret das Format {"gitUsername": "MyUserName", "gitPassword": "MyPassword"} aufweisen.

8. Wählen Sie Repository hinzufügen, um das neue Repository zu erstellen. Nachdem EMR Studio das neue Repository erstellt hat, wird eine Erfolgsmeldung angezeigt. Das neue Repository erscheint in der Dropdown-Liste unter Git-Repositorys.

9. Um das neue Repository mit deinem Workspace zu verknüpfen, wähle es aus der Drop-down-Liste unter Git-Repositorys aus.

Es kann einige Zeit dauern, bis der Verbindungsvorgang abgeschlossen ist. Nachdem EMR Studio das neue Repository mit dem Workspace verknüpft hat, sollte im Dateibrowser-Bereich ein neuer Ordner mit demselben Namen wie Ihr Repository angezeigt werden.

Um ein anderes verknüpftes Repository zu öffnen, navigieren Sie im Dateibrowser zu seinem Ordner.