Commit f661bc7c authored by Niko Luostarinen's avatar Niko Luostarinen
Browse files

Completed aalto_version_quickstart_guide.md

parent d67cebbb
### Info & Login to the system
## Info & Login to the system
<br>
A new, centrally managed version control system is available for all Aalto users at https://version.aalto.fi
<br><br>
......@@ -6,6 +6,64 @@ If you have any problems with the system, please contact servicedesk@aalto.fi
<br><br>
Aalto users are able to login to the system with Haka authentication (Picture 1). External users with HAKA account can also use the same method to access the system.
External users with locally configured credentials, will have to type their credentials to the dedicated fields. Within the “Standard”, tab (Picture 2).
<br>
<br><br>
![Login](/Quickstart/quickstart-pictures/login.png)
![Standard](/Quickstart/quickstart-pictures/standard-selection.png)
\ No newline at end of file
![Standard](/Quickstart/quickstart-pictures/standard-selection.png)
<br><br>
## Creating a new project
<br>
After a successful login, new user will see a welcome page, where a new project can be created or an existing project can be browsed. External users cannot create new projects.
<br><br>
If users want to create a new project, they will simply press the “New project” button and after that, the new project will be named, description and the privacy-settings
(visibility level) of the project can be configured (see Picture 4). The new project - screen also allows the user to import repositories from external systems, such as Github.
<br><br>
![NewProject](/Quickstart/quickstart-pictures/newproject.png)
## Configuring the client for use:
In order to obtain a local copy of a repository, you will need to install a Git-client on your computer.
<br><br>
For centrally managed Aalto computers, The Software Self-service portal has one available, SW_Git_Aalto.
<br><br>
To login with Git-client (https) to a repository, use Aalto-credentials:
- Username: username@aalto.fi
- Password: Aalto password
### Git global setup:
```
Configuring your username, the information can be found inside the site of a repository
(https://version.aalto.fi/your_username/repository_name)
git config --global user.name "your.username"
git config --global user.email "Aalto email-address"
```
### Create a new repository
```
git clone http://version.aalto.fi/your_username/Testproject.git
cd Testproject
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master
```
### Existing folder or Git repository
```
cd existing_folder
git init
git remote add origin http://version.aalto.fi/your_username/Testproject.git
git add .
git commit
git push -u origin master
```
## Size limit of a repository
Currently, the size of a repository has not been limited but avoid using the service as a storage for large files.
## More information regarding the usage of GIT
For more information, how to use GIT as a version control system, feel free to familiarize yourself <br>
with the Pro Git – book composed by Scott Chacon & Ben Straub, link to the book below: <br>
https://git-scm.com/book/en/v2
<br>
GitLab also provides comprehensive user guides; feel free to familiarize yourself with them at <br>
https://version.aalto.fi/gitlab/help
\ 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