debian-mirror-gitlab/doc/gitlab-basics/create-group.md

51 lines
1.8 KiB
Markdown
Raw Normal View History

2015-09-11 14:41:01 +05:30
# How to create a group in GitLab
Your projects in GitLab can be organized in 2 different ways:
2016-11-03 12:29:30 +05:30
under your own namespace for single projects, such as `your-name/project-1` or
under groups.
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
If you organize your projects under a group, it works like a folder. You can
manage your group members' permissions and access to the projects.
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
---
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
To create a group:
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
1. Expand the left sidebar by clicking the three bars at the upper left corner
and then navigate to **Groups**.
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
![Go to groups](img/create_new_group_sidebar.png)
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
1. Once in your groups dashboard, click on **New group**.
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
![Create new group information](img/create_new_group_info.png)
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
1. Fill out the needed information:
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
1. Set the "Group path" which will be the namespace under which your projects
will be hosted (path can contain only letters, digits, underscores, dashes
and dots; it cannot start with dashes or end in dot).
2017-08-17 22:00:37 +05:30
1. The "Group name" will populate with the path. Optionally, you can change
it. This is the name that will display in the group views.
2016-11-03 12:29:30 +05:30
1. Optionally, you can add a description so that others can briefly understand
what this group is about.
1. Optionally, choose and avatar for your project.
1. Choose the [visibility level](../public_access/public_access.md).
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
1. Finally, click the **Create group** button.
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
## Add a new project to a group
2015-09-11 14:41:01 +05:30
There are 2 different ways to add a new project to a group:
2016-11-03 12:29:30 +05:30
- Select a group and then click on the **New project** button.
![New project](img/create_new_project_from_group.png)
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
You can then continue on [creating a project](create-project.md).
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
- While you are [creating a project](create-project.md), select a group namespace
you've already created from the dropdown menu.
2015-09-11 14:41:01 +05:30
2016-11-03 12:29:30 +05:30
![Select group](img/select_group_dropdown.png)