Skip to content

Erstellung und Verwalten von Projekten

Auf dieser Seite erfahren Sie, wie Sie ein Projekt erstellen, was zu tun ist, wenn Sie als Angehöriger der Öffentlichen Verwaltung keine neuen Projekte anlegen können, und welche Tags für GitLab CI/CD-Runner auf openCode verfügbar sind.

Dieser Leitfaden bietet Ihnen alle wichtigen Informationen, um Ihre Projekte effizient zu verwalten.

Wie erstelle ich ein Projekt auf openCode?

1. Öffnen Sie zunächst die "Startseite"

Startseite öffnen

2. Mit der blauen Schaltfläche oben rechts "Neues Projekt" können Sie ein neues Projekt erstellen.

Neues Projekt erstellen

3. Sie haben jetzt die Möglichkeit, ein leeres Projekt zu erstellen oder ein Projekt basierend auf einer Vorlage auszuwählen.

Wenn Sie an dieser Stelle unsicher sind, welche Option für Sie die richtige ist, empfehlen wir, an dieser Stelle ein leeres Projekt zu erstellen.

Leeres Projekt erstellen

4. Nachdem sie diese Schritte abgeschlossen haben öffnet sich eine Seite mit Einstellungen für Ihre neue Gruppe.

  • Legen sie nun einen Namen für Ihr neues Projekt fest.
  • Die URL Ihres Projekts wird basierend auf dem von Ihnen gewählten Namen erstellt. Falls Sie die URL dennoch anpassen möchten, bedenken Sie bitte, dass eine nachträgliche Änderung nicht mehr möglich ist.
  • Sie haben weiterhin die Möglichkeit, die Sichtbarkeit ihres Projekts festzulegen. Projekte sollen dabei auf openCode im Standard öffentlich sichtbar sein, private Projekte sind aus diesem Grund nur für 6 Monate in der Aufbauphase zulässig und müssen danach veröffentlicht werden.
  • Zuletzt können Sie noch Mitglieder und Kolleg:innen (der Öffentlichen Verwaltung und ihrer Dienstleister) zur Gruppe einladen, indem Sie die E-Mail-Adressen der entsprechenden Kolleg:innen hinzufügen. Dies ist an einem späteren Zeitpunkt aber auch noch möglich.
  • Schließen Sie die Einstellungen nach ihren Vorlieben ab und klicken sie zur Erstellung des neuen Projekts auf die blaue Schaltfläche "Projekt erstellen".

Konfiguration eines neuen Projekts

  • Legen Sie zuerst eine Gruppenstruktur an oder beantragen Sie die Aufnahme in die Gruppe Ihrer Organisation und legen sie ihr Projekt dort an.
  • Achten Sie darauf, dass sie vor dem nutzen der Links zum erstellen einer neuen Gruppe in Ihrem Browser eine aktive Open Code Sitzung haben bei der Sie sich angemeldet haben. Sonst funktionieren diese nicht.
Ich gehöre der Öffentlichen Verwaltung an, kann aber keine neuen Projekte anlegen?
  1. Ist Ihr Arbeitgeber der Öffentlichen Verwaltung zuzuordnen und Sie sind nicht in der Lage Projekte oder Gruppen anzuelgen, ist Ihr Arbeitgeber wahrscheinlich noch nicht zugelassen worden.
  2. Zur Freigabe Ihres Arbeitgebers als Entität der Öffentlichen Verwaltung wenden Sie sich an den Support unter info@opencode.de und beantragen die Freigabe.
  3. Die E-Mail Domain Ihres Arbeitgebers wird im Anschluss geprüft und freigegeben.
  4. Jeder Account mit der freigegebenen Domain erhält die Rechte zur Erstellung von Gruppen und Projekten.
Wie beteilige ich mich an anderen Projekten?
  1. Sie können fremde Projekte, genauso wie Ihre eigenen Projekte, über ihre Git-Instanz oder Ihre IDE klonen.
  2. Projekte auf openCode haben ihre eigenen Regelungen zum Annehmen von Kontributionen und Merge-Requests. Hierzu ist eine Maintainer- oder _Owner-_Rolle notwendig.
  3. Open Source lebt von Zusammenarbeit, scheuen Sie sich daher nicht davor anderen Projekten Ihre Unterstützung anzubieten, Tickets in den Projekten zu erstellen, oder Fehler zu melden.

Ein Projekt klonen

  • Setzen Sie sich mit dem Projektteam auseinander und klären sie, ob Kontributionen erwünscht sind, oder ob Ihre Ideen zu den Zielen des Projekts passen.
  • Alle Kontributionen werden von den Projekten selbst verwaltet. Es gibt daher keine Verpflichtung, Kontributionen anzunehmen.
  • Wollen Sie ein Projekt grundlegend verändern oder selbst weiterentwickeln, können Sie es Forken.
Verändern von anderen Projekten (Fork)
  1. Möchten Sie ein bestehendes Projekt einer anderen Organisation der Öffentlichen Verwaltung für sich nutzen oder weiterentwickeln, dann können Sie dieses Forken ( ein "Fork" ist eine Kopie eines Repositories, die es einem Benutzer ermöglicht, Änderungen vorzunehmen, ohne das ursprüngliche Projekt zu beeinflussen).
  2. Forks sind nur 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.
  3. Bei openCode finden Sie die Fork-Funktion in der Projektansicht. Sie müssen bei dieser auf die gleiche Weise vorgehen, wie bei der Erstellung eines Projektes.

Einen Fork erstellen

  • Ein geforktes Projekt ist ein eigenständiges Projekt, daher werden die Änderungen des ursprünglichen Projektes nicht übernommen.
  • Sollten Sie eine aktuelle Version des ursprünglichen Projekts bei sich ablegen, nutzen Sie einen Git-Mirror (auch zu anderen Plattformen möglich).
  • Die Möglichkeit der Erstellung von Forks eines Projekts, kann von dem Projekt-Owner untersagt werden. Wenden Sie sich in diesem Fall direkt an das jeweilige Projektteam.
Welche Tags existieren für Gitlab CI/CD-Runner auf openCode?

Welche Tags existieren für Gitlab CI/CD-Runner auf openCode?

  • openCode bietet allen Projekten eine Anbindung an einen Shared Runner.
  • Shared Runner werden standardmäßig eingesetzt wenn nichts anderes in der .gitlab-ci.yml definiert wurde.
  • Sollten Standard Runner in deren Ressourcenausstattung nicht für Ihren Einsatzweck geeignet sein existieren dedizierte High Ressource Runner auf openCode.
  • Konfiguration der Runner entsprechend der GitLab Dokumentation für Tags der Runner.
  • Tag: opencode-high
  • Exemplarische Einbindung:
    job-name:
        tags:
            - opencode-high
    
  • GitLab bietet nativ die Möglichkeit eigene Runner anzubinden.
  • Die Spezifikation von eigenen Runnern obliegt jedem Projekt selber.
  • Konfiguration der Runner entsprechend der GitLab Dokumentation für Runner.

Last update: January 15, 2025
Created: January 15, 2025