Groups

Estimated time 30 minutes

Overview

Questions

• How can I organize the projects of my (research) group and my collaborations?

Objectives

• Create a group.
• Move a project.
• Add a member to a group.
• Explain how the members of a group relate to its subgroups and projects.
• Delete a group.

In the first episode, we already got to know groups; GitLab’s way to organize projects. A group might hold a projects of a research group or those of a research project with contributors from multiple institutions. Together with members and their permissions they can be used to manage access to multiple repositories (for example, restrict access to certain repositories to staff while others may be accessed by student assistants as well).

In this episode we will create (and delete) a group, move our project, and learn how members of a group relate to its subgroups and projects.

Creating a Group

---

In the top menu bar, we open the drop-down menu labeled with a boxed plus and select the menu item “New Group”. On the next page, we select “Create group”, because that is what we want to do.

This leads to the following page:

Create group form

Choose any name for the group, for example a fictional research group like “Ant-Sized Elephants’ Applications Lab”. When you move the focus out of the input field, for example by pressing the tabulator key, GitLab will suggest a URL for the group. Usually, we might want to adapt it, but for now all we care about that it is available.

You can leave the group’s visibility private. The visibility of a group works like that of a project.

We will leave the remaining fields as they are and create the group by clicking the blue button labeled “Create group”. GitLab will navigate to the group home page, listing the group’s subgroups and projects (currently none).

Now, we will have a look at how to create a project in the new group.

In the top menu bar, we open the drop-down menu labeled with a boxed plus and select the menu item “New Project”. On the next page, we select “Create blank project”.

This leads to the create blank project form page. We do not really want to create a project. Instead we have a look at the drop-down field under the heading “Project URL”. It will either show your username or one of the groups you belong to.

If the field does not show the URL of the group that we just created, clicking on the field should open a drop-down list which includes it and allows us to select it.

Submitting the form with our group’s URL selected would create a project in that group.

Move Project to Group

---

We will now move our project to our group.

On the side menu, we select “Settings” then “General”. On that page, we expand the section labeled “Advanced” and scroll down to the subsection labeled “Transfer Project”.

Now, please read the subsections notes, with an emphasis on the list of things to be aware of.

A few comments on the last two items of the list:

The second to last tells us that we will need to update our local repositories to point to the new location. Because we are moving the project to a group from our own projects, the URL will change. So the URL we specified when adding the remote to our local repository will no longer be valid. We will test this, but will not change the URL, because we will move the project back in a bit.

The last item on the list informs us about potential visibility changes. For example, moving a public project to a private group, will cause the project to become private.

Having carefully read and thought about the warnings, we are ready to move our project. We select the group that we previously created from the drop-down field and click the button labeled “Transfer project”.

A dialog appears and we confirm, that we are sure, by typing in the name of our project and clicking the button labeled “Confirm”.

The project will be transferred to the group.

To test that the URL changed, we switch to the shell and navigate to the directory containing our repository; Not the repository of our co-learner!

Running

git remote get-url origin

{: .language-bash}

should tell us that our project points to the old project URL. So, let us try to run

git pull

{: .language-bash}

Already up to date.

{: .output}

That result is unexpected. The reason for this is that GitLab will redirect the old URLs to the new ones, as long as the old URLs do not point to a new project.

Adding Members to Group

---

Adding Members

Add your instructor as a member of your group with the role of “Guest”. The process is the same as to add members to a project.

Hint: After adding a member, you might need to reload the members page to see the new member in the list.

This exercise should take about 5 minutes.

Show me the solution

Steps to solve the challenge:

1. Navigate to the group home page.
2. Select “Group information”, then “Members” from the side bar menu.
3. Click the “Invite members” button.
4. Fill in the dialog to invite your instructor with the “Guest” role.
5. Click the “Invite” button.

After adding a member to the group, we have look at the member list of our research diary project.

The list has three entries: ourselves, our co-learner, and our instructor. We have the “Owner” role and, as its creator, are a direct member of the project. Our co-learner has the “Developer” role that we assigned them and are also a direct member of the project, as we added them directly to the project.

The entry we are really interested in is that of the instructor. We added them as a “Guest” to the group. Now, they show up in the list of this project with the same role. The reason is, as the column “Source” tells us, that our project is in our group, and our instructor is a member of that group.

That means, projects and groups inherit the members of the group they belong to.

Move project

Move your project back to your username space.

This exercise should take about 5 minutes.

Delete Group

---

Now that our group is empty again, we will delete it, to be polite users of free resources. (If you created a group, that you actually intend to keep, do not delete it.)

Delete a Group

Delete your group. You find the deletion form at the same position in the group’s settings, as the project deletion form in a project’s settings.

This exercise should take about 5 minutes.

Show me the solution

Steps to solve the challenge:

1. Navigate to the group home page.
2. Select “Settings”, then “General” from the side bar menu.
3. Expand the “Advanced” section and scroll all the way down.
4. Click “Remove group”.
5. Fill in the dialog and click “Confirm”.

Keypoints

• Groups and subgroups are used to organize projects.
• Groups can have members.
• Projects and groups inherit members from the group they belong to.