README.md 3.15 KB
Newer Older
Xueshan Feng's avatar
Xueshan Feng committed
1
**GitLab FAQs**  
Xueshan Feng's avatar
Xueshan Feng committed
2

Xueshan Feng's avatar
Xueshan Feng committed
3
4
5
6
7
8
9
10
11
12
- [What is the minimum setup before I start using gitlab?](#minimum-setup)
- [How to generate and upload gitlab ssh-key?](#generate-ssh-key)
- [What is a gitlab project?](#gitlab-project)
- [What is the username space?](#username-space)
- [How many personal gitlab projects I can create?](#project-limit)
- [What is the default project visibility?](#project-visibility)
- [What is a gitlab group?](#gitlab-group)
- [I got 403 forbidden when clicking on Groups, why?](#403-forbidden)
- [I clicked 'sign in', but it gives me simpleSAMLphp 'Access forbidden' error](#sign-in-error)
- [How do I migrate github project to gitlab]
Xueshan Feng's avatar
Xueshan Feng committed
13

Xueshan Feng's avatar
Xueshan Feng committed
14
## <a name="minimum-setup" ></a> What is the minimum setup before I start using gitlab?
Xueshan Feng's avatar
Xueshan Feng committed
15
16
17

Most of your profile settings are already populated from Stanford directory when you sign up with GitLab,  such as your account id (sunetid), name, email. You should not change these.

Xueshan Feng's avatar
Xueshan Feng committed
18
19
You can click **Profile Settings** button on the left panel to change default appearance for your GitLab web interface. You definitely want to look into is the "SSH Keys" tab. In this tab, click the "Add SSH Key" button to add SSH keys so you can communicate with GitLab through git command. 

Xueshan Feng's avatar
Xueshan Feng committed
20
## <a name="generate-ssh-key">How to generate and upload gitlab ssh-key?
Xueshan Feng's avatar
Xueshan Feng committed
21
22
* [Generate ssh-key](http://doc.gitlab.com/ce/ssh/README.html)
* [Add ssh-key](http://doc.gitlab.com/ce/gitlab-basics/create-your-ssh-keys.html#add-your-ssh-key)
Xueshan Feng's avatar
Xueshan Feng committed
23

Xueshan Feng's avatar
Xueshan Feng committed
24
## <a name="git-project"></a> What is a gitlab project?
Xueshan Feng's avatar
Xueshan Feng committed
25

Xueshan Feng's avatar
Xueshan Feng committed
26
A gitlab project is all things about a project: a git repository, wiki, issues, documentations, etc. 
Xueshan Feng's avatar
Xueshan Feng committed
27

Xueshan Feng's avatar
Xueshan Feng committed
28
## <a name="username-space"></a> What is the username space?
Xueshan Feng's avatar
Xueshan Feng committed
29

Xueshan Feng's avatar
Xueshan Feng committed
30
31
32
33
34
35
When you create a new project in GitLab, the default namespace for the project is the personal namespace associated with your GitLab userid. The git repositories created in your personal namespace looks like this:

```
git@code.stanford.edu:<sunetid>/<project>.git
```

Xueshan Feng's avatar
Xueshan Feng committed
36
## <a name="project-limit"></a> How many personal gitlab projects I can create?
Xueshan Feng's avatar
Xueshan Feng committed
37
38
39

The default personal project limit is 10.

Xueshan Feng's avatar
Xueshan Feng committed
40
## <a name="project-visibility"></a> What is the default project visibility?
Xueshan Feng's avatar
Xueshan Feng committed
41
42
43

Project visibility level in GitLab can be either private, internal or public. The default is **private**. As a project owner, you can change your project visibility by using your projetct's "Settings" function. 

Xueshan Feng's avatar
Xueshan Feng committed
44
## <a name="gitlab-group"></a> What is a gitlab group? 
Xueshan Feng's avatar
Xueshan Feng committed
45

Xueshan Feng's avatar
Xueshan Feng committed
46
Gitlab group allows you group projects together into one namespace (directory), so you can give other users permission to all projects in one place. You are allowed to create groups or transfer personal projects to a group your are a member of. Here is more information about [gitlab groups](http://doc.gitlab.com/ee/workflow/groups.html#gitlab-groups).
Xueshan Feng's avatar
Xueshan Feng committed
47

Xueshan Feng's avatar
Xueshan Feng committed
48
## <a name="403-forbidden"></a>I got 403 forbidden when clicking on Groups, why?
Xueshan Feng's avatar
Xueshan Feng committed
49
50
51

To explore groups hosted on code.stanford.edu, you need to sign in. Click the green button **Sign In** at the upper right corner to sign in. 

Xueshan Feng's avatar
Xueshan Feng committed
52
## <a name="sign-in-error"></a>I clicked 'sign in', but it gives me simpleSAMLphp 'Access forbidden' error
Xueshan Feng's avatar
Xueshan Feng committed
53
54

Account sign up is intergated with Stanford SSO and is allowed for full sunetid users who are in a controlled workgroup only.