2. Our Git Server2.1 Accessing RepositoriesI have set up the open-source Git management software GitLab on the server, which can be accessed at
http://smlg.fiu.edu/gitlab. Clicking the link will most likely bring up a login screen.
2.2 Getting an AccountIn order to login, a GitLab administrator will need to set up a username and temporary password. This account should be linked to the email and name that was typed in section 1.5. Dr. Yoo and I may try to set up an account for everyone who needs one. If you need a login or have difficulties accessing your account or want to change some of the admin-level user information, then you may want to get in touch through email.
2.3 Basic SetupOnce you are provided with a username and password, log in and change the password to something you can remember. Since SMTP through the server does not work, you will not be able to use "Forgot your password?". If you do need to reset your password, you will need to request a reset from an admin (e.g. Dr. Yoo).
Once you are inside your account, you may want to add an SSH RSA key-pair to make use of SSH file transfers. In the case that you already have a key-pair, then just skip the generation step. If you are on Windows, you may need to do something more (try googling "ssh-keygen windows").
- Code: Select all
ssh-keygen
cat ~/.ssh/id_rsa.pub
In the first command, you can either just click <ENTER> for everything (you can change details if you want also). After the second command, copy all the output and then go to
Profile Settings > SSH > Add SSH Key through the GitLab interface.
2.4 File TransferCommunication with the remote server is done through either SSH or HTTP. I would recommend using SSH since HTTP has a limitation on memory and requires more resources.
If you want to use HTTP, you may need to run the command
- Code: Select all
git config --global http.postBuffer 524288000
which should allow you to transfer larger amounts of data.
Either way, the location of the project through HTTP and SSH is shown after clicking on the project inside GitLab. For subsequent sections, I will use the syntax for SSH communication.
2.5 Creating a New ProjectOne of the main uses for the GitLab interface is to create a new project on the server. This can be done at the first page of GitLab after logging in. Click on the
+ New Project and fill out the page that comes up. After clicking
Create Project, you should see instructions on how to perform your first commit.
2.6 Using the Web InterfaceThe web interface also provides some tools to help you get used to using Git. For example, after clicking on a project, you can directly browse the code (both current and previous versions) through the
Files tab. There are many other capabilities available like viewing differences between versions and adding a Wiki.