Gitlab
From CVL Wiki
(Created page with "== GitLab == The ECE department is hosting a GitLab instance at https://git.ece.vt.edu. It is avaiable for anyone with an ECE account to use. It uses Git, ...") |
|||
| Line 2: | Line 2: | ||
The ECE department is hosting a GitLab instance at https://git.ece.vt.edu. It is avaiable for anyone with an [[Getting Started|ECE account]] to use. It uses Git, which is a powerful and popular version control system. If you need help getting started with git there are a number of tutorials. | The ECE department is hosting a GitLab instance at https://git.ece.vt.edu. It is avaiable for anyone with an [[Getting Started|ECE account]] to use. It uses Git, which is a powerful and popular version control system. If you need help getting started with git there are a number of tutorials. | ||
* http://rogerdudler.github.io/git-guide/ a quick and dirty getting started guide | * http://rogerdudler.github.io/git-guide/ a quick and dirty getting started guide | ||
| + | * http://www.sitepoint.com/git-for-beginners/ another getting started guide what explains a little more | ||
* http://git-scm.com/book/en/v2/ a comprehensive guide and explanation of git | * http://git-scm.com/book/en/v2/ a comprehensive guide and explanation of git | ||
* http://www.git-tower.com/blog/git-cheat-sheet-detail/ a good cheat sheet for users who are familiar with git | * http://www.git-tower.com/blog/git-cheat-sheet-detail/ a good cheat sheet for users who are familiar with git | ||
| Line 18: | Line 19: | ||
If you're working on a group project and wish to give other users access to the repository you should create a new group first, then add the project to the group. | If you're working on a group project and wish to give other users access to the repository you should create a new group first, then add the project to the group. | ||
| + | |||
| + | When you create a new project you must name it and choose a visibility level: Private, Internal, or Public. Private means that only you, or someone you give permission to may see the repository. Internal means that everyone with an ECE account can see your repository. Public means that the repository will be listed on the GitLab site without needing an account. No matter which visibility level you choose, only users you explicitly give permission to edit can edit the project. The other options are optional, but if you want the project to be part of an existing group, change the "Namespace" option to the group you wish to use. | ||
| + | |||
| + | [[File:newproject.png]] | ||
| + | |||
| + | After you created the page there will be instructions on how to get the repository set up. In order to push or pull you must first add your ssh key to your GitLab account. You will see a warning at the top of the page. | ||
| + | [[File:sshwarning.png]] | ||
| + | |||
| + | On Linux or Mac, you can find your ssh key by entering the following on a terminal | ||
| + | <pre> | ||
| + | cat ~/.ssh/id_rsa.pub | ||
| + | </pre> | ||
| + | If the file does not exist, you can generate it with the following | ||
| + | <pre> | ||
| + | ssh-keygen -t rsa | ||
| + | </pre> | ||
Revision as of 15:40, 11 February 2015
GitLab
The ECE department is hosting a GitLab instance at https://git.ece.vt.edu. It is avaiable for anyone with an ECE account to use. It uses Git, which is a powerful and popular version control system. If you need help getting started with git there are a number of tutorials.
- http://rogerdudler.github.io/git-guide/ a quick and dirty getting started guide
- http://www.sitepoint.com/git-for-beginners/ another getting started guide what explains a little more
- http://git-scm.com/book/en/v2/ a comprehensive guide and explanation of git
- http://www.git-tower.com/blog/git-cheat-sheet-detail/ a good cheat sheet for users who are familiar with git
- http://nvie.com/posts/a-successful-git-branching-model/ a model for group projects using git
Getting Started
GitLab is modeled after popular VCS hosting sites like GitHub.
To access the site enter your ECE account username and password on the login page. This password is usually different from your pid password.
From here you will be brought to the dashboard. You can view your recent activity and projects you're involved with. To create a new project either click the plus icon on the top toolbar or the new project button.
If you're working on a group project and wish to give other users access to the repository you should create a new group first, then add the project to the group.
When you create a new project you must name it and choose a visibility level: Private, Internal, or Public. Private means that only you, or someone you give permission to may see the repository. Internal means that everyone with an ECE account can see your repository. Public means that the repository will be listed on the GitLab site without needing an account. No matter which visibility level you choose, only users you explicitly give permission to edit can edit the project. The other options are optional, but if you want the project to be part of an existing group, change the "Namespace" option to the group you wish to use.
After you created the page there will be instructions on how to get the repository set up. In order to push or pull you must first add your ssh key to your GitLab account. You will see a warning at the top of the page.
On Linux or Mac, you can find your ssh key by entering the following on a terminal
cat ~/.ssh/id_rsa.pub
If the file does not exist, you can generate it with the following
ssh-keygen -t rsa
