Für die Zusammenarbeit mit Stakeholdern und anderen Data-Scientists können Sie Ihre Notebooks in GitHub -Repositorys veröffentlichen. Sie können auch GitHub verwenden, um Notebooks für die Quellcodeverwaltung zu sichern.
In diesem Video erfahren Sie, wie die GitHub-Integration ermöglicht werden kann.
Dieses Video bietet eine visuelle Methode zum Erlernen der Konzepte und Tasks in dieser Dokumentation.
Videomitschrift Zeit Transkription 00:00 Dieses Video zeigt Ihnen, wie Sie Notizbücher aus Ihrem Projekt in Ihrem GitHub veröffentlichen können. 00:07 Navigieren Sie zu Ihrem Profil und den zugehörigen Einstellungen. 00:11 Rufen Sie auf der Registerkarte 'Integrationen' den Link zum Generieren eines persönlichen GitHub-Zugriffstokens auf. 00:17 Geben Sie einen aussagekräftigen Namen für das Token an und wählen Sie die Repository- und Gist-Bereiche aus. Generieren Sie anschließend das Token. 00:29 Kopieren Sie das Token, kehren Sie zu den GitHub-Integrationseinstellungen zurück und fügen Sie das Token ein. 00:36 Das Token wird überprüft, wenn Sie es in Ihren Profileinstellungen speichern. 00:42 Navigieren Sie jetzt zu Ihren Projekten. 00:44 Sie aktivieren die GitHub-Integration auf der Registerkarte 'Einstellungen'. 00:50 Blättern Sie bis nach unten und fügen Sie die vorhandene GitHub-Repository-URL ein. 00:56 Sie finden diese Angabe auf der Registerkarte 'Code' im Repository. 01:01 Klicken Sie auf 'Aktualisieren', um die Verbindung herzustellen. 01:05 Wechseln Sie jetzt zur Registerkarte 'Assets' und öffnen Sie das Notebook, das Sie publizieren möchten. 01:14 Beachten Sie, dass die Berechtigungsnachweise in diesem Notebook durch das Zeichen 'X' ersetzt wurden. 01:19 Ein bewährtes Verfahren besteht darin, Berechtigungsnachweise vor dem Publizieren in GitHub zu entfernen oder zu ersetzen. 01:24 Dieses Notebook ist jetzt zum Publizieren bereit. 01:27 Sie können den Zielpfad zusammen mit einer Commitnachricht angeben. 01:31 Es gibt auch die Möglichkeit, Inhalte ohne verdeckten Code zu publizieren, d. h. alle Zellen im Notebook, die mit den Kommentarzeichen für verdeckte Zellen beginnen, werden nicht publiziert. 01:42 Wenn Sie bereit sind, klicken Sie auf 'Publizieren'. 01:45 Die Nachricht weist darauf hin, dass das Notebook erfolgreich publiziert wurde, und sie stellt Links zum Notebook, zum Repository und zur Commit-Operation bereit. 01:54 Sehen wir uns die Commit-Operation an. 01:57 So sieht die Commit-Operation aus. Sie können zum Repository navigieren, um das publizierte Notebook anzuzeigen. 02:04 Abschließend können Sie das Notebook als Gist publizieren. 02:07 Gists sind eine weitere Möglichkeit, Ihre Arbeit auf GitHub zu teilen. 02:10 Jeder Gist ist ein Git-Repository, das verzweigt und geklont werden kann. 02:15 Es gibt zwei Gist-Typen: öffentliche Gists und geheime Gists. 02:19 Wenn Sie mit einem geheimen Gist beginnen, können Sie ihn später in einen öffentlichen Gist umwandeln. 02:24 Auch hier haben Sie die Möglichkeit, verdeckte Zellen zu entfernen. 02:29 Folgen Sie dem Link, um den publizierten Gist anzuzeigen. 02:32 Das sind also die Grundlagen der GitHub. 02:37 Weitere Videos finden Sie in der Dokumentation zu Cloud Pak for Data as a Service.
Zugriff auf GitHub über Ihr Konto aktivieren
Bevor Sie Notebooks auf " GitHub, veröffentlichen können, müssen Sie Ihr " Cloud Pak for Data as a Service -Konto für den Zugriff auf " GitHub freischalten. Sie aktivieren den Zugriff, indem Sie ein persönliches Zugriffstoken mit dem erforderlichen Zugriffsbereich in GitHub erstellen und das Token mit Ihrem Cloud Pak for Data as a Service -Konto verknüpfen.
Führen Sie die folgenden Schritte aus, um ein persönliches Zugriffstoken zu erstellen:
- Klicken Sie auf Ihren Avatar im Header und anschließend auf Profil und Einstellungen.
- Rufen Sie die Registerkarte Integrationen auf und klicken Sie im Dialogfeld auf den Link für persönliche GitHub -Zugriffstoken und generieren Sie ein neues Token.
- Wählen Sie auf der Seite für das neue persönliche Zugriffstoken den repo-Bereich aus und klicken Sie dann, um ein Token zu generieren.
- Kopieren Sie das generierte Zugriffstoken und fügen Sie es im Dialogfenster für die GitHub -Integration in Cloud Pak for Data as a Serviceein.
Projekt mit einem GitHub -Repository verlinken
Nachdem Sie das Zugriffstoken gespeichert haben, muss Ihr Projekt mit einem vorhandenen GitHub -Repository verbunden sein. Sie können nur zu einem vorhandenen GitHub -Repository aus einem Projekt verlinken. Private Repositorys werden unterstützt.
Um ein Projekt mit einem vorhandenen GitHub -Repository zu verlinken, müssen Sie über Administratorberechtigung für das Projekt verfügen. Alle Projektmitbearbeiter, die eine Administrator- oder Editorberechtigung besitzen, können Dateien in diesem GitHub-Repository veröffentlichen. Diese Benutzer müssen jedoch über die Zugriffsberechtigung für das Repository verfügen. Die Erteilung von Benutzerberechtigungen für Repositorys muss in GitHub erfolgen.
Gehen Sie wie folgt vor, um ein Projekt mit einem vorhandenen GitHub-Repository zu verknüpfen:
- Wählen Sie die Registerkarte Verwalten aus und rufen Sie die Seite Services und Integrationen auf.
- Klicken Sie auf die Registerkarte Integrationen anderer Anbieter.
- Klicken Sie auf Integration verbinden.
- Geben Sie das generierte Zugriffstoken aus Github ein.
Nun können Sie mit der Publizierung von Notebooks auf GitHub beginnen.
Informationen zum Ändern Ihrer Git -Integration finden Sie unter Integrationen verwalten.
Notebook auf GitHub publizieren
So publizieren Sie ein Notebook in GitHub:
- Öffnen Sie das Notebook im Bearbeitungsmodus.
- Klicken Sie auf das Symbol GitHub -Integration
und wählen Sie In GitHub in der Aktionsleiste des geöffneten Notebooks aus.
Wenn Sie den Namen der Datei eingeben, die auf GitHub publiziert werden soll, können Sie einen Ordnerpfad im GitHub-Repository angeben. Beachten Sie, dass Notebook-Dateien immer in die Stammverzweigung übertragen werden.
Wenn der Fehler An error occurred while publishing the notebook. Invalid access token permissions or repository does not exist. angezeigt wird, stellen Sie Folgendes sicher:
- Sie haben Ihr persönliches Zugriffstoken generiert, wie unter Zugriff auf GitHub über Ihr Konto aktivieren beschrieben, und das Token wurde nicht gelöscht.
- Das Repository, in dem Sie Ihr Notebook publizieren wollen, ist weiterhin vorhanden.
Übergeordnetes Thema: Lebenszyklus von Notebooks und Scripts verwalten