Gruppen und Namespaces
Im GitLab am KIT gibt es die globale Gruppe "KIT". Diese ist als Top-Level-Namespace angelegt:
https://gitlab.kit.edu/kit ⇤ KIT ist die Top-Level-Group/Top-Level-Namespace
Hinweise: Es ist nicht möglich, parallel zur Top-Level-Gruppe "KIT" eine weitere Top-Level-Gruppe zu erstellen. Alle Gruppen werden unterhalb von gitlab.kit.edu/kit/ angelegt.
ALLE weiteren Gruppen, Projekte und Mitglieder befinden sich also unterhalb dieses Top-Level-Namespace:
KIT Organisationseinheiten (OUs) und OU-Gruppen
Für die Institute und Fachbereiche des KIT sind im KIT-GitLab "OU-Gruppen" definiert und bereits angelegt - beispielsweise die OU-Gruppe „SCC“ (siehe Abbildung 1, oberer Teil).
Damit sind für diese Gruppen auch die Namespaces "gitlab.kit.edu/kit/OU-Gruppe" vorbelegt (z.B. gitlab.kit.edu/kit/scc). Eine Übersicht der vordefinierten OU-Gruppen befindet sich unten im Abschnitt KIT Organisationseinheiten (OUs).
Hintergrund für die Vorbelegung der OU-Gruppen
Vorteil der OU-Gruppen:
- Damit soll es den Instituten ermöglicht werden, unterhalb ihrer OU-Gruppe eine eigene Struktur von GitLab-Gruppen und -Projekten anzulegen und zu managen (über den oder die ITB als Verwalter).
- Dazu kann z.B. dem ITB der OU die Admin-Rolle für die OU-Gruppe zugeordnet und innerhalb OU können mit den Mitarbeitern die OU-internen Prozesse zum Anlegen von Gruppen und Projekten abgestimmt werden.
- Für OU-Gruppen und Subgruppen sowie Projekte innerhalb der OU ist ein statistischer Überblick möglich
- Für die Übernahme der Admin-Rolle kann an die GitLab-Admins eine entsprechende Anfrage gestellt werden.
Nachteile bei freier Vergabe von Gruppennamen:
- "NUR" Namespaces in GitLab (d.h. URLs) sind eineindeutig. Gruppennamen können jedoch mehrfach vergeben werden. D.h. auch ein OU-Gruppenname könnte bei freier Erstellung von Gruppen durch die Nutzenden mehrmals vergeben werden. Den zugeordneten Namespaces/URLs mit gleichem Namen werden dann jediglich durchnummeriert, d.h. dem Namen wird eine Zahl angehängt (z.B. gitlab.kit.edu/kit/OU-Gruppe-1, -2, -3,...). Dann wäre nicht mehr klar, welcher Namespace nun der originale Namespace der OU ist. Eine Verwechslungsgefahr ist gegeben. Daher werden OU-Gruppe nicht frei vergeben, sondern über das unter Gruppen und Namespaces beschriebene Verfahren.
Vererbung: Wenn Sie ein Mitglied zu einer Gruppe hinzufügen, wird dieses Mitglied auch allen Untergruppen hinzugefügt. Die Berechtigungen des Benutzers werden von der übergeordneten Gruppe geerbt.
Weitere Gruppen, Namespaces (persönliche Gruppen)
Neben den OU-Gruppen können Nutzende auch eigene Gruppen anlegen und managen. Diese Gruppen liegen auf der gleichen Ebene wie die OU-Gruppen. (siehe oben Abbildung 1 unterer Teil)
- Beispiel: Gruppe „XYZ-Projekt“ => Namespace: gitlab.kit.edu/kit/xyz-projekt
- Auch die persönlichen Namespaces liegen auf der Top-Level-Namespace Ebene: gitlab.kit.edu/vorname.nachname/
Gruppen anlegen
Der Benutzer kann entweder einer neuen Gruppe(OU Gruppe) direkt im KIT
https://gitlab.kit.edu/kit/<Gruppenamen>
oder einer Gruppe(Subgruppe) unter Ihrer Organisationseinheit im KIT erstellen.
https://gitlab.kit.edu/kit/OUs/<Gruppenamen>
Außerhalb des KIT können keine Gruppen angelegt werden.
https://gitlab.kit.edu/<Gruppenamen> (nicht möglich)
Neue Gruppe auf KIT erstellen
Neue Gruppen können unter https://docs.gitlab.kit.edu/group/ erstellt werden. Um auf die Seite zuzugreifen, müssen Sie sich mit dem KIT Federated Login Service (reguläres Anmeldeverfahren) anmelden.
Im Anfrageformular gibt es folgende Felder:
- Gruppenname
- Pflichtfeld
- Der Gruppenname muss mit einem
- Buchstaben (a-zA-Z)
- Ziffer (0-9)
- Unterstrich (_) beginnen
- Der Gruppenname darf nur
- Buchstaben (a-zA-Z)
- Ziffern (0-9)
- Bindestriche (-)
- Unterstriche (_) enthalten
- Beschreibung
- Optional
- Unterstützt Unicode
Gruppenerstellung unter SCC-Gruppe
Wenn Sie SCC-Mitglied sind, haben Sie eine zusätzliche Option, bei der Sie wählen können, ob Sie eine OU-Ebene-Gruppe oder eine SCC-Untergruppe erstellen möchten.
Am Ende des Formulars wird eine Vorschau der neu erstellten Gruppendetails angezeigt. Dort ist die neu erstellte URL für die Gruppe zu sehen, die automatisch aus dem Gruppennamen generiert wird.
Die Gruppe sollte in kurzer Zeit verfügbar sein, wenn die Bedingungen erfüllt sind. Die Bedingungen sind folgende: * Der Gruppenname ist für die Verwendung in KIT-GitLab verfügbar und wurde noch nicht erstellt. * Der entsprechende KIT-Benutzer für diese Einreichung ist bereits in KIT-GitLab registriert.
Sie erhalten eine E-Mail, sobald Ihre Einträge im System aktiv sind.
Die neue Gruppe hat den Sichtbarkeitsgrad "private". Das bedeutet, dass die Gruppe nur von Mitgliedern gesehen werden kann. Der Gruppenbesitzer kann die Sichtbarkeit jedoch auch auf "internal" (alle registrierten Benutzer können die Gruppe sehen) oder "public" (die Gruppe kann im Internet gesehen werden) in den Gruppeneinstellungen festlegen.
Gruppe auf KIT/OUs erstellen
Um eine Gruppe hinterlegen zu können, benötigen Sie zunächst eine Genehmigung zur Erstellung der Untergruppe innerhalb des KIT.
Wenn Sie in Ihrem Arbeitsbereich zur Kategorie "Gruppen" gehen(Oben Links), können Sie die primäre Gruppe "KIT" über explore groups finden.
Gehen Sie in die KIT-Gruppe
Entweder Sie sollten unter "KIT" eine neue Gruppe erstellen, indem Sie eine Zugriffsberechtigung beantragen. oder Sie suchen Ihr Institut zum Anlegen einer Untergruppe unter „KIT/IhreEinrichtung/Gruppe“. Klicken Sie bitte auf "Zugriff anfordern".
Sie sollten eine Genehmigung von GitLab einholen, sobald der Vorgang abgeschlossen ist. Nachdem Sie die Erlaubnis erhalten haben, können Sie weiter eine Untergruppe innerhalb des OUs erstellen.
Um eine Untergruppe in Ihren Organisationseinheiten zu erstellen, folgen Sie bitte dieser Anleitung. Klicken Sie Neue Untergruppe rechts oben oder unter dem Pluszeichen links oben
- Geben Sie unter "Untergruppenname" einen privaten Gruppennamen
- Die "Untergruppen-URL" wird automatisch ausgefüllt, nachdem der Untergruppenname erhalten wurde.
- "Sichtbarkeitsstufe(Visibility level)" ist bereits nur mit privat festgelegt.
Weitere Informationen zum Erstellen und Verwalten Ihrer Untergruppen und Mitglieder finden Sie unter den folgenden Links bei gitlab.com
Gruppenhierarchie und Mitgliedschaften
Dieses Diagramm zeigt das Konzept der Gruppenhierarchie und ihrer Mitgliedschaften. Mitglieder sind die Benutzer und Gruppen, die Zugriff auf das Projekt haben. GitLab-Benutzer können Mitglieder einer Gruppe oder eines Projekts mit unterschiedlichen Mitgliedschaftstypen werden: direkt, geerbt(inherited), geteilt(shared). Wenn Sie ein Mitglied zu einer Gruppe hinzufügen, wird dieses Mitglied auch allen Untergruppen hinzugefügt. Die Berechtigungen des Benutzers werden vom übergeordneten Element der Gruppe geerbt.
Wenn „OU Gruppe“ und Subgruppe eine Abteilung ist, z.B. „SYS“, dann vererben sich unterhalb von SYS mehr und mehr Mitglieder von Abteilung nach unten. Alternative können es aber unterhalb der OU-Gruppe, ebenso unterhalb von Subgruppe auch noch ein Subgruppe unabhängig von den Abteilungsstrukturen angelegt werden. „OU“ ist ein „Sammelbecken“. Anlegen dieser Gruppen aber immer auf Nachfrage des Gruppeninhabers (IT-Beauftragter) und das ist der Nachteil aus Sicht der Nutzenden. In den selbst angelegten Gruppen parallel auf OU-Ebene ist auch immer der Administrator von GitLAb als Owner mit dabei.
Mitglieder in Gruppen
Um eine Übersicht aller Gruppenmitglieder zu erstellen, geben Sie diese URL in Ihren Webbrowser ein.
https://gitlab.kit.edu/groups/"Gruppe_Namen"/-/group_members
Auf dieser Ansichtsseite können Sie Mitglieder hinzufügen oder entfernen oder die Gruppe selbst verlassen. Fortgeschrittene KIT-Benutzer können auch die API-Aufruf verwenden, um Informationen über ihre eigenen Mitglieder abzurufen.
KIT Organisationseinheiten (OUs)
Diese Tabelle zeigt die Liste der registrierten KIT-OUs in GitLab. Derzeit sind insgesamt 120 Institute registriert. Wenn Ihre Abteilung noch nicht in der OU in GitLab registriert ist, bitte das Gitlab-Team zu kontaktieren. Gerne ordnen wir Ihre Einrichtung der KIT-GitLab-Organisation zu.
| Nr. | Index | Abteilungen / Institut |
|---|---|---|
| 1 | SAAI | Archive for Architecture and Civil Engineering |
| 2 | EBI | Engler-Bunte-Institute |
| 3 | GIK | Geodetic Institute |
| 4 | GPI | Geophysical Institute |
| 5 | HIU | Helmholtz Institute Ulm for Electrochemical Energy Storage |
| 6 | IAMT | Institute for Advanced Membrane Technology |
| 7 | IAG | Institute of Algebra and Geometry |
| 8 | IANA | Institute for Analysis |
| 9 | IAR | Institute for Anthropomatics and Robotics |
| 10 | IAB | Institute for Applied Biosciences |
| 11 | IBU | Institute of Applied Business Studies and Management |
| 12 | AGW | Institute of Applied Geosciences |
| 13 | IAI | Institute for Automation and Applied Informatics |
| 14 | AIFB | Institute of Applied Informatics and Formal Description Methods |
| 15 | IAM | Institute for Applied Materials |
| 16 | IANM | Institute of Applied and Numerical Mathematics |
| 17 | APH | Institute of Applied Physics |
| 18 | IATF | Institute for Applied Thermofluidics |
| 19 | IAP | Institute for Astroparticle Physics |
| 20 | IBCS | Institute for Biological and Chemical Systems |
| 21 | IRS | Institute of Control Systems |
| 22 | IFAB | Institute for Human and Industrial Engineering |
| 23 | AOC | Institute for Inorganic Chemistry |
| 24 | IISM | Institute of Information Systems and Marketing |
| 25 | IBS | Institute for Structural Analysis |
| 26 | IBAP | Institute of Vocational and General Education |
| 27 | IBPT | Institute for Beam Physics and Technology |
| 28 | IBG | Institute for Biological Interfaces |
| 29 | BLT | Institute of Process Engineering in Life Sciences |
| 30 | IBT | Institute of Biomedical Engineering |
| 31 | IBF | Institute of Soil Mechanics and Rock Mechanics |
| 32 | CVT | Institute of Chemical Process Engineering |
| 33 | IEH | Institute of Electric Energy Systems and High-Voltage Engineering |
| 34 | ETI | Institute of Electrical Engineering |
| 35 | ENTECHNON | Institute of Entrepreneurship, Technology Management, and Innovation |
| 36 | EKUT | Institute of Architectural Design, Art, and Theory |
| 37 | IEB | Institute for Building Design and Technology |
| 38 | IESL | Institute for Urban and Landscape Design |
| 39 | ETP | Institute of Experimental Particle Physics |
| 40 | FAST | Institute of Vehicle System Technology |
| 41 | FBV | Institute for Finance |
| 42 | IFL | Institute for Materials Handling and Logistics |
| 43 | IFG | Institute of Functional Interfaces |
| 44 | IFGG | Institute of Geography and Geoecology |
| 45 | GER | Institute for German Studies: Literature, Language, Media |
| 46 | IHM | Institute for Pulsed Power and Microwave Technology |
| 47 | IFH | Institute for Hydromechanics |
| 48 | IHE | Institute of Radio Frequency Engineering and Electronics |
| 49 | IIP | Institute for Industrial Production |
| 50 | IIIT | Institute of Industrial Information Technology |
| 51 | IMI | Institute for Information Management in Engineering |
| 52 | IIWR | Institute for Information and Economic Law |
| 53 | IKFT | Institute of Catalysis Research und Technology |
| 54 | IFRT | Institute of Fusion and Reactor Technology |
| 55 | IFKM | Institut für Kolbenmaschinen |
| 56 | IKB | Institute for History of Art and Architecture |
| 57 | IMB | Institute of Concrete Structures and Building Materials |
| 58 | IFM | Institute of Mechanics |
| 59 | MVM | Institute for Mechanical Process Engineering and Mechanics |
| 60 | IMK | Institute of Meteorology and Climate Research |
| 61 | MRT | Institute of Measurement and Control with Machine Laboratory |
| 62 | IMS | Institute of Micro- and Nanoelectronic Systems |
| 63 | IMT | Institute of Microstructure Technology |
| 64 | IMVT | Institute for Micro Process Engineering |
| 65 | CEL | Communications Engineering Lab |
| 66 | INT | Institute of Nanotechnology |
| 67 | INR | Institute for Neutron Physics and Reactor Technology |
| 68 | INE | Institute for Nuclear Waste Disposal |
| 69 | IOR | Institute of Operations Research |
| 70 | IOC | Institute of Organic Chemistry |
| 71 | IPF | Institute of Photogrammetry and Remote Sensing |
| 72 | IPS | Institute for Photon Science and Synchrotron Radiation |
| 73 | IPQ | Institute of Photonics and Quantum Electronics |
| 74 | IPC | Institute of Physical Chemistry |
| 75 | PHI | Institute of Physics |
| 76 | IPEK | Institute of Product Engineering |
| 77 | WBK | Institute of Production Science |
| 78 | IPD | Institute for Program Structures and Data Organization |
| 79 | IQMT | Institute for Quantum Materials and Technologies |
| 80 | IPE | Institute for Data Processing and Electronics |
| 81 | IFR | Institute for Regional Science |
| 82 | ISD | Institute for School Pedagogy and Didactics |
| 83 | ISMK | Institute for Sociology, Media and Cultural Sciences |
| 84 | IFSS | Institute of Sports and Sports Science |
| 85 | STOCH | Institute of Stochastics |
| 86 | ISE | Institute of Highway and Railroad Engineering |
| 87 | ISTM | Institute of Fluid Mechanics |
| 88 | ITIV | Institute for Information Processing Technologies |
| 89 | ITAS | Institute for Technology Assessment and Systems Analysis |
| 90 | ITC | Institute for Technical Chemistry |
| 91 | ITCP | Institute for Chemical Technology and Polymer Chemistry |
| 92 | ITEC | Institute for Computer Engineering |
| 93 | ITM | Institute of Engineering Mechanics |
| 94 | ITEP | Institute for Technical Physics |
| 95 | ITT | Institute of Technical Thermodynamics |
| 96 | ITTK | Institute for Technical Thermodynamics and Refrigeration |
| 97 | TMB | Institute for Technology and Management in Construction |
| 98 | ITZ | Institute of Technology Futures |
| 99 | TM | Institute of Telematics |
| 100 | TFP | Institute of Theoretical Solid State Physics |
| 101 | ITI | Institute of Theoretical Informatics |
| 102 | ITP | Institute for Theoretical Physics |
| 103 | TTP | Institute for Theoretical Particle Physics |
| 104 | TKM | Institute for Theoretical Condensed Matter Physics |
| 105 | ITS | Institute of Thermal Turbomachines |
| 106 | TVT | Institute of Thermal Process Engineering |
| 107 | ITES | Institut für Thermische Energietechnik und Sicherheit |
| 108 | IFV | Institute for Transport Studies |
| 109 | IVD | Institute for Visualization and Data Analysis |
| 110 | ECON | Institute for Economic Policy Research |
| 111 | IWG | Institute for Water and River Basin Management |
| 112 | IWRMM | Institute for Scientific Computing and Mathematical Modelling |
| 113 | KASTEL | Institute of Information Security and Dependability |
| 114 | JKIP | Joseph Gottlieb Kölreuter Institut for Plant Sciences |
| 115 | KSRI | Karlsruhe Service Research Institute |
| 116 | LAS | Laboratory for Applications of Synchrotron Radiation |
| 117 | LEM | Laboratory for Electron Microscopy |
| 118 | LTI | Light Technology Institute |
| 119 | VAKA | Research Center for Steel, Timber, and Masonry |
| 120 | ZOO | Zoological Institute |