Any abuse of our Gitlab setup can result in punishment or demotion.
Create an account
Before you can gain access to any Diversion Network Staff Gitlab Repositories you must create a Gitlab account.
This is free to do however please ensure you pick a reasonable username so we can recognize who is who. Anyone who also has access to that repository can see your name, username and email so please be cautious.
Accounts can be made for free here.
Two Factor Authentication
In order to protect our Gitlab from any vunerabilities or other weaknesses we require anyone who wants access to have Two Factor Authentication enabled for their account.
2FA provides a 6 digit code which resets every 30 seconds reqired as a second step when logging in. This makes it almost impossible for hackers to brute force their way into your account.
However, this means whenever you login to a new device or get logged out, you need to get a code from your phone to login or use one of your Backup Codes. Setup is easy and can be done as follows.
If you have not setup any other programs with Two Factor Authentication then we reccomend for you to download Google Authenticator on your Phone. iOS / Android
Click here to go to the Gitlab Two Factor Authentication page.
In Google Authenticator click the Plus symbol and click Scan a Barcode. Line the QR code on the website up with the box on the phone and your phone will buzz when it has found it.
Enter the 6 digit code into the Pin Code box and click Register with two-factor app.
As of right now there is no automatic way to gain access to the repositories you require, simply drop Dogatron03#4871 or Clijmart#5793 a message on Discord with your Gitlab Username.
Diversion Network uses two main technologies to store our staff and development data. This data is hosted by Gitlab, hense why you use Gitlab.com to access it.
However, at its heart Gitlab uses a technology called Git to manage the files. In order to be able to upload and download files you must download Git on your computer.
The downloads page is located here. Run the installer like any other software. Unless you know what you are doing, default options will work just fine.
Once Git has been installed you need to link Gitlab with Git. You will have to do this for every computer that you need to access Diversion Network files on.
First, you must generate a unique key which Gitlab uses to encrypt all data sent to you. To do this, open up Git Bash. Either type it into the search bar or right click in File Explorer on empty space.
Paste in the following command: ssh-keygen -t ed25519 -C "Diversion Network SSH". The command will come up with several prompts, simply press enter until you are returned to a command prompt.
Then, in File Explorer, go to the following location by clicking on the address bar and pasting in %USERPROFILE%/.ssh.
You should see two files with the same name however one of them ends in .pub and may be detected as a Microsoft Publisher file, however it is not.
Simply right click the .pub file and clicking Open With Notepad++.
To tell which is which you may need to enable File Name Extensions by clicking View -> and checking File Name Extensions.
Copy everything in that file and paste it into the text box here. Click Add Key
Your account should now be linked with Gitlab
Setting up a local repository
A repository on Gitlab is effectively a folder containing one type of data.
For example there is a seperate repository for Maps in rotations and Maps that need to be developed. You can browse the repositories avaliable to you here.
Select the repository you wish to make a local copy of and click Clone and copy the Clone with SSH URL.
If this is your first time setting up a local repository I recommend making a Diversion Network folder on your computer so you can keep files organized.
In the desired folder in File Manager, right click the space and click Git Bash Here. If this option does not come up, press start and open Git Bash. Type cd [folder url].
Type in git clone and then paste in the URL from above. Press enter to start the download. Lots of text may appear on the window but should be ignored as long as when it finishes the files have been downloaded.
A folder should have been created for you with all of the desired files inside. In case of downloading a big repository such as the Build Backup, this may take some time to download.
Inside the folder may be a file called setup.sh. If there is run it and follow the instructions before doing anything else.
To update your local repository with any changes other people have made, always good practice to do before starting any work on DN Files, double click the download.sh file and wait for it to finish.
In order to upload any changes you have made, always run download.sh first to ensure you wont have any conflicting changes, then double click on upload.sh.
In order to check that the files have been uploaded correctly visit the repository on Gitlab.
Support with Git
If you have any issues with the setup or use of Gitlab whilst working on Diversion Network resources, please do not hesitate to contact either Dogatron03#4871 or Clijmart#5793 on Discord or drop a message in #staff-chat or #mapdev-chat.
If you suspect something is wrong please report it straight away so the problem can be dealt with quickly. Please follow all advice given to you by any member of Lead Staff or another staff member to ensure the system continues to work as it should.