Skip to content
Snippets Groups Projects
de_help.md 6.06 KiB
Newer Older
  • Learn to ignore specific revisions
  • Hier finden Sie erste Hilfe zur Benutzung von JLU GitLab, aber diese kann [die offizielle Nutzerhilfe (auf Englisch)](https://gitlab.test.uni-giessen.de/help/user/index.md){:target="_blank"} nicht ersetzen.
    Für spezifische Informationen zu JLU GitLab, siehe [Informationen]({{ '/informationen/#what_is_jlugitlab' | relative_url }}).
    
    <!-- NOTE dies ist (derzeit) nur eine manuell verwaltete Liste. -->
    - [Wie benutzt man GitLab?](#how_to_gitlab)
    - [Erste Schritte](#first_steps)
    - [Sichtbarkeit von Projekten](#visibility_projects)
    - [Nutzerrollen in Projekten](#user_roles)
        - [Berechtigungen als *Guest*](#role_guest)
        - [Berechtigungen als *Reporter*](#role_reporter)
        - [Berechtigungen als *Developer*](#role_developer)
        - [Berechtigungen als *Maintainer*](#role_maintainer)
        - [Berechtigungen als *Owner*](#role_owner)
    - [Nutzergruppen](#groups)
    - [Einstellung von privater Informationen](#private_info)
    - [Letzte Schritte](#last_steps)
    - [Weitere Hilfe](#more_help)
    
    ## Wie benutzt man GitLab? {#how_to_gitlab}
    
    TODO: Viele Kleinigkeiten mit Browser möglich, für umfangreichere Arbeit aber Git lokal installieren.
    
    TODO: Hinweis auf Git-GUIs (ohne Empfehlung?).
    
    TODO: Hinweis auf Git-Funktionen in Matlab und anderen IDEs?
    
    ## Erste Schritte {#first_steps}
    
    TODO: Grobe Übersicht, links auf gute Ressourcen zum Weiterlernen ([siehe unten](#more_help)).
    
    ## Sichtbarkeit von Projekten {#visibility_projects}
    
    Jedes Projekt hat eine Sichtbarkeits-Einstellung als entweder *private*, *internal* oder *public*.
    Die Sichtbarkeit kann nur vom *Owner* des Projekts geändert werden (siehe [Nutzerrollen unten](#user_roles)).
    
    
    Johannes Keyser's avatar
    Johannes Keyser committed
    - Projekte mit Sichtbarkeit *private* sind nur für die [Mitglieder des Projekts](#user_roles) einsehbar.
    - Projekte mit Sichtbarkeit *internal* sind für alle Personen mit einem Nutzungskonto einsehbar, die eingeloggt sind.
    
      [Bitte lesen Sie hier, was dies im Fall von JLU GitLab bedeutet.]({{ '/informationen/#potential_users' | relative_url }})
    
    Johannes Keyser's avatar
    Johannes Keyser committed
    - Projekte mit Sichtbarkeit *public* sind auch für alle Personen einsehbar, die kein Nutzungskonto haben.
    
      [Bitte lesen Sie hier, was dies im Fall von JLU GitLab bedeutet.]({{ '/informationen/#potential_users' | relative_url }})
    
    
    Für mehr Details lesen Sie bitte die [offizielle Dokumentation (auf Englisch)](https://gitlab.test.uni-giessen.de/help/public_access/public_access.md#public-access){:target="_blank"}.
    
    ## Nutzerrollen in Projekten {#user_roles}
    
    TODO: Fehlende Bedeutungen von *Reporter* bis *Owner*.
    
    Wenn Sie andere Nutzende als Projektmitglied hinzufügen wollen, müssen Sie diesen auch eine bestimmte Rolle zuweisen:
    Sie können zwischen *Guest*, *Reporter*, *Developer*, *Maintainer* oder *Owner* auswählen.
    
    Jede dieser Rollen umfasst mehr Berechtigungen als die vorherige, siehe auch in der [offiziellen Dokumentation (auf Englisch)](https://gitlab.test.uni-giessen.de/help/user/permissions.md#project-members-permissions){:target="_blank"}.
    
    <!-- NOTE: Der Einfachheit halber, lass uns unten die Berechtigungen von den Verträgen STARTER, PREMIUM, ULTIMATE weglassen; unter der Annahme dass diese nicht Teil der Community Edition sind. -->
    
    ### Berechtigungen als *Guest* {#role_guest}
    
    Die *Guest*-Rolle ist für nicht-aktive Mitglieder die einige Inhalte lesen, und Tickets öffnen und kommentieren können.
    
    Projektmitglieder in der *Guest*-Rolle können
    das Projekt herunterladen,
    Kommentare einbringen,
    
    Projektdateien ansehen und Git-*pull*en,
    
    Wikiseiten ansehen,
    neue Tickets erstellen,
    verwandte Tickets ansehen,
    vertrauliche Tickets erstellen,
    und selbsterstellte vertrauliche Tickets ansehen.
    
    
    Wenn *Öffentliche Pipelines* in den *Projekteinstellungen > CI/CD* aktiviert ist, können sie zusätzlich
    
    eine Liste der Jobs anschauen,
    ein Job-Protokoll ansehen,
    und Job-Artefakte durchsehen und herunterladen.
    
    
    ### Berechtigungen als *Reporter* {#role_reporter}
    
    
    Die *Reporter*-Rolle ist für Mitglieder die mehr Einblick bekommen und im Ticketsystem arbeiten können.
    
    Projektmitglieder mit der *Reporter*-Rolle habe folgende zusätzliche Berechtigungen im Vergleich zur *Guest*-Rolle:
    
    Im Ticketsystem
    können sie Tickets zuweisen und
    mit Labels versehen,
    Kommentare sperren,
    und die Ticketliste und Labels verwalten.
    *Reporter* können außerdem Codeausschnitte speichern,
    den Status eines Commits einsehen,
    eine Container Registry ansehen,
    Umgebungen ansehen,
    eine Liste von Merge-Requests ansehen,
    Projekt-Statistiken ansehen,
    und die Error-Tracking-Liste ansehen.
    <!-- NOTE: Error Tracking (keine dt. Übersetzung) ist unter Vorgängen zu finden, man muss mit mit einem Sentry-Server verbinden. -->
    
    ### Berechtigungen als *Developer* {#role_developer}
    
    ### Berechtigungen als *Maintainer* {#role_maintainer}
    
    ### Berechtigungen als *Owner* {#role_owner}
    
    TODO: Gruppenmitglieder und deren Rollen und einhergehende Rechte.
    
    TODO: Hinweis, dass Projekte in Gruppen nicht beim Austritt gelöscht werden, sofern noch andere Nutzende in der Gruppe sind.
    
    [Ähnlich zur Sichtbarkeit von Projekten](#visibility_projects) kann die Sichtbarkeit von Gruppen auf *private*, *internal* oder *public* gesetzt werden, um den Zugriff entweder nur explizit ausgewählten Mitgliedern zu gewähren oder allen eingeloggten Nutzenden oder sogar allen Personen ohne Nutzungskonto.
    
    
    ## Einstellung von privater Informationen {#private_info}
    
    TODO: Einstellung der Commit-Emailadresse (in GitLab und lokal), Profil und Aktivitäten unsichtbar machen, ...
    
    
    TODO: Erklärung, was wann bei Austritt aus der JLU gelöscht wird (Nutzerdaten, *eigene* Projekte, ...), und was nicht (Projekte in Gruppen inkl Tickets und Kommentare, Commits, ...).
    
    
    Außer den Commits werden Daten anonymisiert (auf den Ghost-User übertragen).
    
    TODO: Mehr nützliche Links, evtl. in Kategorien.
    
    - Die offizielle Nutzerhilfe für JLU GitLab (auf Englisch), <https://gitlab.test.uni-giessen.de/help/user/index.md>
    - Kostenloses Online-Buch *Pro Git*, <https://git-scm.com/book/de>, teilweise auf Deutsch übersetzt