Projekte erstellen

Projekte sind das Herzstück Ihrer Open-Source-Arbeit auf openCode. Hier verwalten Sie Quelltexte, dokumentieren Entwicklungen und arbeiten im Team.

So legen Sie ein neues Projekt an

1. Loggen Sie sich ein unter https://gitlab.opencode.de oder folgen Sie dem Shortlink "GitLab" in Ihrem Dashboard.
2. Klicken Sie oben links auf das Plus-Symbol und wählen Sie Neues Projekt
3. Wählen Sie eine Vorlage oder starten Sie mit einem leeren Projekt
4. Geben Sie Ihrem Projekt einen Namen und eine kurze Beschreibung. Die URL Ihres Projekts wird basierend auf dem von Ihnen gewählten Namen erstellt.
5. Legen Sie die Sichtbarkeit fest: Öffentlich: Jeder kann das Projekt sehen, Intern: Nur eingeloggte Nutzer:innen haben Zugriff, Privat: Nur Sie und explizit eingeladene Personen

Info

openCode lebt von Offenheit. Nutzen Sie möglichst die Einstellung „Öffentlich“, wenn keine schützenswerten Informationen enthalten sind.

1. Zuletzt können Sie noch Mitglieder:innen der Öffentlichen Verwaltung und Ihre Dienstleister zum Projekt einladen, indem Sie die E-Mail-Adressen hinzufügen. Dies ist aber auch später noch möglich.
2. Schließen Sie die Einstellungen nach Ihren Vorlieben ab.Bestätigen Sie mit Projekt erstellen.

Bestehendes Projekt importieren

Sie haben ein Projekt z. B. auf GitHub oder in einem anderen GitLab? Kein Problem: Wählen Sie beim Erstellen des Projekts den Reiter Importieren und folgen Sie den Anweisungen.

Projekte spiegeln

Sie möchten ein bestehendes Projekt von einer anderen Plattform wie GitHub übernehmen? Nutzen Sie die Spiegelungsfunktion von GitLab.

1. Erstellen Sie ein neues Projekt auf gitlab.opencode.de
2. Gehen Sie in das neue Projekt und wählen Sie Einstellungen > Repository
3. Scrollen Sie zu Mirroring repositories
4. Tragen Sie die URL des externen Git-Repositories ein
5. Authentifizieren Sie sich ggf. (z. B. per Token)
6. Wählen Sie: Pull (Daten werden von extern nach GitLab geholt)
7. Speichern Sie die Einstellungen

Hinweis

Das Spiegeln kann automatisch (zeitgesteuert) oder manuell erfolgen. Achten Sie darauf, dass keine privaten Daten ungewollt übernommen werden.

Zusammenarbeit in Projekten

Damit Projekte reibungslos funktionieren, gibt es unterschiedliche Rollen mit passenden Rechten.

Rollen in GitLab

• Maintainer: Projektadministrator:innen – können alles verwalten
• Developer: können Code einreichen (Push), Merge Requests erstellen und Issues bearbeiten
• Reporter: können Issues anlegen und kommentieren, haben Leserechte im Code
• Guest: haben eingeschränkten Lesezugriff

Zusammenarbeit im Alltag

• Verwenden Sie Issues, um Aufgaben, Fehler oder Ideen festzuhalten
• Nutzen Sie Merge Requests, um Änderungen zu besprechen und gemeinsam freizugeben
• Dokumentieren Sie Projektziele, Zuständigkeiten und Lizenz in einer README.md

Ergänzend zur GitLab-Oberfläche können Sie sich im openCode-Forum austauschen.

Häufig gestellte Fragen und Probleme

Warum kann ich keine neuen Projekte anlegen?

Falls Sie der öffentlichen Verwaltung angehören, aber keine Projekte erstellen können, liegt das vermutlich daran, dass die Domain Ihrer E-Mail-Adresse ("der Teil hinter dem @-Zeichen") von uns noch nicht zugelassen worden ist. Zur Freigabe wenden Sie sich an unseren Support per E-Mail unter info@opencode.de. Falls Sie nicht der öffentlichen Verwaltung angehören können Sie leider keine Projekte erstellen. Um dennoch Projekte erstellen zu können müssen Sie von einem Mitglied der öffentlichen Verwaltung (ÖV) zu einer Gruppe hinzugefügt werden (hierzu benötigen Sie keine E-Mail der ÖV). In dieser Gruppe können Sie, wenn Sie mit den dafür notwendigen Rechten ausgestattet worden sind, auch selbständig Projekte anlegen.

Wie beteilige ich mich an anderen Projekten?

1. Sie können fremde Projekte, genauso wie Ihre eigenen Projekte klonen. 2. Projekte auf openCode haben Ihre eigenen Regelungen zum Annehmen von Code-Beiträgen und Merge-Anfragen. 3. Open Source lebt von der Zusammenarbeit: Scheuen Sie sich daher nicht davor anderen Projekten Ihre Unterstützung anzubieten, Tickets in den Projekten zu erstellen oder Fehler zu melden.

Wie kann ich eine eigenständige Kopie (Fork) eines anderen Projekts anlegen?

Möchten Sie ein bestehendes Projekt einer anderen Organisation der Öffentlichen Verwaltung für sich nutzen oder weiterentwickeln, dann können Sie einen Fork anlegen. Ein Fork anzulegen ist nur dann sinnvoll, wenn Sie vorhaben das Projekt selbst weiter zu entwickeln, oder wenn die Chance besteht, dass der Zugang zum Projekt nicht mehr möglich ist. Um ein Projekt zu forken befolgen Sie folgende Schritte: 1. Öffnen Sie das zu kopierende Projekt im openCode-GitLab und klicken Sie auf der oberen rechten Seite auf "Fork".  2. Damm öffnet sich eine Konfigurationsoberfläche, die der Projekt-Neuanlage (s.o.) ähnelt. Folgen Sie dem Ablauf und erstellen Sie so Ihre eigene Kopie des Projektes.