Commit 0a2ebc3c authored by Xueshan Feng's avatar Xueshan Feng
Browse files

README.md

parent b5ac4db1
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
**GitLab FAQs**
- [What is the minimum setup before I start using gitlab?](#what-is-the-minimum-setup-before-i-start-using-gitlab)
- [How to generate and upload gitlab ssh-key?](#how-to-generate-and-upload-gitlab-ssh-key)
- [What is a gitlab project?](#what-is-a-gitlab-project)
- [What is the username space?](#what-is-the-username-space)
- [How many personal gitlab projects I can create?](#how-many-personal-gitlab-projects-i-can-create)
- [What is the default project visibility?](#what-is-the-default-project-visibility)
- [What is a gitlab group?](#what-is-a-gitlab-group)
- [I got 403 forbidden when clicking on Groups, why?](#i-got-403-forbidden-when-clicking-on-groups-why)
- [I clicked 'sign in', but it gives me simpleSAMLphp 'Access forbidden' error](#i-clicked-sign-in-but-it-gives-me-simplesamlphp-access-forbidden-error)
- [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]
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
## What is the minimum setup before I start using gitlab?
## <a name="minimum-setup" ></a> What is the minimum setup before I start using gitlab?
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.
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.
## How to generate and upload gitlab ssh-key?
## <a name="generate-ssh-key">How to generate and upload gitlab ssh-key?
* [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)
## What is a gitlab project?
## <a name="git-project"></a> What is a gitlab project?
A gitlab project is equivalent to a git repository.
A gitlab project is all things about a project: a git repository, wiki, issues, documentations, etc.
## What is the username space?
## <a name="username-space"></a> What is the username space?
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:
......@@ -36,22 +33,22 @@ When you create a new project in GitLab, the default namespace for the project i
git@code.stanford.edu:<sunetid>/<project>.git
```
## How many personal gitlab projects I can create?
## <a name="project-limit"></a> How many personal gitlab projects I can create?
The default personal project limit is 10.
## What is the default project visibility?
## <a name="project-visibility"></a> What is the default project visibility?
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.
## What is a gitlab group?
## <a name="gitlab-group"></a> What is a gitlab group?
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).
## I got 403 forbidden when clicking on Groups, why?
## <a name="403-forbidden"></a>I got 403 forbidden when clicking on Groups, why?
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.
## I clicked 'sign in', but it gives me simpleSAMLphp 'Access forbidden' error
## <a name="sign-in-error"></a>I clicked 'sign in', but it gives me simpleSAMLphp 'Access forbidden' error
Account sign up is intergated with Stanford SSO and is allowed for full sunetid users who are in a controlled workgroup only.
\ No newline at end of file
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment