... | ... | @@ -26,7 +26,7 @@ and you should be shown a list with the parameters set above. |
|
|
|
|
|
**Creating an SSH key**
|
|
|
---------------------------
|
|
|
The default way for secure Git operation on OpenVT is the SSH protocol. Therefore, before you can start creating local clones of OpenVT repositories, you have to create your own SSH key and deposit it on the platform.
|
|
|
The default way for secure Git operation on OpenVT is the SSH protocol. Therefore, before you can start creating local clones of OpenVT repositories, you have to create your own SSH key and deposit it on the platform. It is possible to use most of the git functionalities also via SSL: if you would like to use this method, you can skip the following steps.
|
|
|
|
|
|
Before generating and depositing an SSH key, make sure your git configuration is correct (see above). A key generated with a wrong configuration will not work.
|
|
|
|
... | ... | @@ -47,7 +47,7 @@ ssh -T git@virtual.openVT.eu |
|
|
If everything is set up correctly, you will be prompted for your passphrase and get a welcome message if you type the correct passphrase.
|
|
|
|
|
|
|
|
|
**Cloning an OpenVT repository**
|
|
|
**Cloning an OpenVT repository with SSH/SSL**
|
|
|
--------------------------------------------------------------------------
|
|
|
Now we need to create your first local clone of a Gitlab repository. First, pick a repository on the OpenVT platform that you would like to clone (as a test, you can use the manual_and_guidelines repository, or just start your own private project). Browse to the corresponding repository screen (e.g., [this one](https://virtual.openvt.eu/platform_manual_and_guidelines/manual_and_guidelines)), find the blue "clone" button and copy the link for SSH cloning (the link starts with git@virtual.openvt.eu).
|
|
|
|
... | ... | @@ -63,11 +63,17 @@ mkdir <name_of_new_directory> |
|
|
```
|
|
|
where you replace <name_of_new_directory> with the name of the directory to create, and again browse into to that directory using cd.
|
|
|
|
|
|
Now, the actual cloning can happen:
|
|
|
Now, the actual cloning can happen: If you would like to use SSH (recommended method), type
|
|
|
```bash
|
|
|
git clone <SSH_cloning_link>
|
|
|
```
|
|
|
(replace <SSH_cloning_link> with the link that you have copied from the blue button on the repository web site). You should be prompted to enter the pass phrase of your SSH key which you have (hopefully) memorised earlier. If the process was successful, the clone of the repository should appear in the current directory, which you can check by typing
|
|
|
(replace <SSH_cloning_link> with the link that you have copied from the blue button on the repository web site). You should be prompted to enter the pass phrase of your SSH key which you have (hopefully) memorised earlier. If you prefer cloning via SSL, type instead
|
|
|
```bash
|
|
|
git clone <SSL_cloning_link>
|
|
|
```
|
|
|
You will be prompted for your OpenVT username and password, if the project you are about to clone requires any access privileges.
|
|
|
|
|
|
If in either case the process was successful, the clone of the repository should appear in the current directory, which you can check by typing
|
|
|
```bash
|
|
|
ls -l -tr
|
|
|
```
|
... | ... | @@ -79,7 +85,7 @@ The basic actions for working with a clone of an OpenVT repository are pulling a |
|
|
```bash
|
|
|
git pull
|
|
|
```
|
|
|
You will be prompted for your pass phrase and the files will be updated. Now, you can modify, add or remove files (using any command line or GUI tool of your choice). Once you are done, you have to commit your changes. In order to do that, use the command lione again to cd into the clone directory and perform the following steps:
|
|
|
You will be prompted for your pass phrase and the files will be updated. Now, you can modify, add or remove files (using any command line or GUI tool of your choice). Once you are done, you have to commit your changes. In order to do that, use the command line again to cd into the clone directory and perform the following steps:
|
|
|
```bash
|
|
|
git add .
|
|
|
```
|
... | ... | @@ -91,7 +97,7 @@ where you replace commit message with a meaningful description of the modificati |
|
|
```bash
|
|
|
git push origin master
|
|
|
```
|
|
|
this will prompt you for your pass phrase and upload your changes to OpenVT. If there is only one branch in your repository, you can skip the "origin master" options. On the other hand, if there are different branches, you can replace "master" with the branch to which you would like to push. Your modifications will now be accessible on OpenVT to anyone who has access to the project under consideration.
|
|
|
this will prompt you for your pass phrase (or user name and password, for SSL) and upload your changes to OpenVT. If there is only one branch in your repository, you can skip the "origin master" options. On the other hand, if there are different branches, you can replace "master" with the branch to which you would like to push. Your modifications will now be accessible on OpenVT to anyone who has access to the project under consideration.
|
|
|
|
|
|
Repeat this work flow every time that you would like to do modifications on the contents of your OpenVT repository.
|
|
|
If you would like to learn more about git and how to use more advanced actions such as branching and merging, please refer to the git documentation on [https://git-scm.com/docs](https://git-scm.com/docs).
|
... | ... | |