Repositories
Ein Repository enthält die Dateien, Branches und den Verlauf eines Projekts. Diese Anleitung zeigt, wie Sie ein Repository erstellen und von Ihrem Computer aus eine Verbindung dazu herstellen.
Repository erstellen
Abschnitt betitelt „Repository erstellen“- Öffnen Sie Git in Ihrem Workspace.
- Wählen Sie oben rechts das Menü + und dann New Repository.
- Geben Sie einen Namen und optional eine kurze Beschreibung ein.
- Legen Sie die Sichtbarkeit fest. Neue Repositories sind standardmäßig Privat – nur Mitglieder, denen Sie Zugriff gewähren, können sie sehen.
- Wählen Sie optional Initialize Repository, um eine README-Datei, eine
.gitignore-Datei und eine Lizenz hinzuzufügen. - Wählen Sie Create Repository.
Contributors können Repositories nicht direkt in der Git-Organisation des Workspace erstellen; Repositories werden über PlaidCloud erstellt.
Persönliches Zugriffstoken erzeugen
Abschnitt betitelt „Persönliches Zugriffstoken erzeugen“Da Sie sich über PlaidCloud anmelden, hat Ihr Konto kein separates Git-Passwort. Um per HTTPS über die Befehlszeile zu klonen oder zu pushen, erstellen Sie ein persönliches Zugriffstoken und verwenden es anstelle eines Passworts.
- Wählen Sie oben rechts Ihren Avatar und dann Einstellungen. Die Einrichtungskarte auf der Registerkarte Git verlinkt ebenfalls direkt auf diese Seite.
- Öffnen Sie die Registerkarte Anwendungen.
- Geben Sie unter Zugriffstoken verwalten einen Namen ein, der beschreibt, wo Sie das Token verwenden (zum Beispiel
laptop). - Wählen Sie die Berechtigung write:repository, damit das Token klonen und pushen kann.
- Wählen Sie Generate Token.
- Kopieren Sie das Token und bewahren Sie es sicher auf. Sie können es danach nicht mehr einsehen.
Repository klonen
Abschnitt betitelt „Repository klonen“-
Öffnen Sie Git in Ihrem Workspace und wählen Sie die Kopierschaltfläche neben der Clone-Adresse des Repositorys (wählen Sie How to clone für die Einrichtungsschritte). Sie können auch im Repository Code wählen und die HTTPS-URL kopieren.
-
Führen Sie in einem Terminal
git clonemit dieser URL aus:Terminal-Fenster git clone <clone URL> -
Wenn Git nach einem Passwort fragt, fügen Sie das Zugriffstoken ein. Verwenden Sie den Benutzernamen, der bereits in der URL steht.
-
Legen Sie den Namen und die E-Mail-Adresse fest, die Git in Ihren Commits speichert, mit den Werten, die die Einrichtungskarte anzeigt:
Terminal-Fenster git config --global user.name "Your Name"git config --global user.email "you@example.com"
Zum Pushen benötigen Sie Contributor- oder Administrator-Zugriff; als Viewer können Sie lesen, aber nicht pushen. Siehe Zugriffsstufen.
Änderungen committen und pushen
Abschnitt betitelt „Änderungen committen und pushen“Gehen Sie in einem geklonten Repository wie folgt vor:
- Stagen Sie Ihre Änderungen:
git add . - Halten Sie sie mit einer Nachricht fest:
git commit -m "Describe what changed" - Senden Sie sie an PlaidCloud Git:
git push
Ihre Commits erscheinen in den Ansichten Commits und Aktivität des Repositorys sowie in jedem Branch oder Pull Request, der sie enthält.
Zugriff und Sichtbarkeit verwalten
Abschnitt betitelt „Zugriff und Sichtbarkeit verwalten“Öffnen Sie die Registerkarte Einstellungen eines Repositorys, um es umzubenennen, seine Sichtbarkeit zu ändern oder das Eigentum zu übertragen. Damit andere Mitglieder mitarbeiten können, verwenden Sie Einstellungen → Collaborators und fügen Sie sie per Benutzernamen mit der Rolle Lesen, Schreiben oder Administrator hinzu.
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“- Panel-App aus diesem Repository bereitstellen – hier gepushten App-Code in eine bereitgestellte App verwandeln
- Dash-App aus diesem Repository bereitstellen – derselbe Weg für eine Plotly-Dash-App
- Arbeit mit Issues verfolgen
- Änderungen mit Pull Requests vorschlagen