|
|
|
*Introduction**
|
|
|
|
|
|
|
|
Git is our chosen method for handling version control, there are several methods you can use but this document will assume you're using TortoiseGit a windows GUI Based client.
|
|
|
|
A guide for installing GIT for Windows & TortoiseGit can be found below.
|
|
|
|
|
|
|
|
__________________________
|
|
|
|
**Prerequisites**
|
|
|
|
- [ ] Administrator privileges
|
|
|
|
- [ ] Access to a command-line
|
|
|
|
- [ ] Your favourite coding text editor
|
|
|
|
__________________________
|
|
|
|
**Installing GIT for Windows**
|
|
|
|
|
|
|
|
1. Browse to the official [Git for Windows](https://gitforwindows.org/)
|
|
|
|
2. Click the download link for Windows and allow the download to complete.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Extract and Launch Git Installer
|
|
|
|
|
|
|
|
3. Browse to the download location (or use the download shortcut in your browser). Double-click the file to extract and launch the installer.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. Allow the app to make changes to your device by clicking Yes on the User Account Control dialogue that opens.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
5. Review the GNU General Public License, and when you’re ready to install, click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
6. The installer will ask you for an installation location. Leave the default, unless you have reason to change it, and click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7. A component selection screen will appear. Leave the defaults unless you have a specific need to change them and click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8. The installer will offer to create a start menu folder. Simply click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9. Select a text editor you’d like to use with Git. Use the drop-down menu to select Notepad++ (or whichever text editor you prefer) and click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10. This installatvion step allows you to change the PATH environment. The PATH is the default set of directories included when you run a command from the command line. Leave this on the middle (recommended) selection and click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11. The next option relates to server certificates. Choose Open SSL Library
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12. The next selection converts line endings. It is recommended that you leave the default selection. This relates to the way data is formatted and changing this option may cause problems. Click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
13. Choose the terminal emulator you want to use. The default MinTTY is recommended, for its features. Click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14. Choose the Default behaviour of "git pull" Choose default. Click Next
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
15. Credinatial Manager, GIT Credinatial manager core is recommended. as Git Manager is now deprecated.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
16. The default options are recommended, however, this step allows you to decide which extra option you would like to enable. If you use symbolic links, which are like shortcuts for the command line, tick the box. Click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
17. Configuring Experimental options, leave it default. Click Install.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Complete Git Installation Process**
|
|
|
|
|
|
|
|
16. Once the installation is complete, tick the boxes to view the Release Notes or click Finish.
|
|
|
|
|
|
|
|
_________________________________________
|
|
|
|
|
|
|
|
**Installing TortoiseGit**
|
|
|
|
|
|
|
|
1. Download the latest TortoiseGit release from the [download page](https://tortoisegit.org/download/)
|
|
|
|
|
|
|
|
2. Double click the downloaded file to begin the installation process.
|
|
|
|
If you receive a pop-up stating, "Do you want to run this file?", click "Run".
|
|
|
|
|
|
|
|
Click "Next" on the initial screen.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. Read the information on the screen, and if you agree with it, click "Next" to continue.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. Read the information and then click "Next" to continue.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
5. Read the information and then click "Install" when ready. Afterward, you might get one more pop-up prompt asking for permission to install. Click Yes or Ok to install
|
|
|
|
|
|
|
|
6. Finally, click "Finish". Congrats! You've just installed TortoiseGit.'
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7. After click Finish, A New Dialogue will open, it will help you to make a tunnel by SSH from your system to Git.nexval.com where 2FA is enabled.
|
|
|
|
Choose language, Click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8. Configuring git.exe path should be set to C:\Program Files\Git\bin
|
|
|
|
|
|
|
|
Click on the check now button & validate. Then Click Next.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9. Fill in your name and @nexval.com as an email when prompted. Click Next
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10. Select TortoiseGitPlink for SSH and manager for Credential Helper.
|
|
|
|
Click the Generate PuTTY key pair button and hit Generate in the popup that appears
|
|
|
|
Drag your mouse around the screen as instructed until a key is generated
|
|
|
|
|
|
|
|
1- Enter your @nexval.com.com email as the key comment.
|
|
|
|
2- Choose a random secure password in the passphrase fields. (Note it separately)
|
|
|
|
3- Select all the Public Key value.
|
|
|
|
4- Copy that value from here & save it into a separate notepad file. This is Public Key Value
|
|
|
|
5-6 Save both the public and private key down in a location where you cannot lose it, the public key should be saved as a .pub file and the private key as a .ppk file
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11. Log in to Git.nexval.com with your @nexval.com Azure account
|
|
|
|
12. Using the dropdown menu on the top-right of your screen, go to Edit Profile then SSH keys.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
13. Under SSH Keys, add or Paste your public key (That value copied by you on a separate notepad file, take reference from 10.4) click add key.
|
|
|
|
If the public key is correct, the title name will automatically appear here
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
____
|
|
|
|
Next, check that TortoiseGit is installed. Start by right-clicking on the desktop and making a new folder called something like "project" (you should already see some TortoiseGit options in the context menu):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
______________________________________
|
|
|
|
|
|
|
|
**Using TortoiseGit**
|
|
|
|
|
|
|
|
First Commit & Setup for the git.nexval.com where 2FA is enabled.
|
|
|
|
|
|
|
|
**Creating a new repository**
|
|
|
|
|
|
|
|
1. Create your repository or Blank Project on git.nexval.com making sure to add a README when asked
|
|
|
|
Go To project, Click create a Blank Project.
|
|
|
|
On the next screen, give the Project Name & click create project.
|
|
|
|
Once Project created, Click Copy link of Clone with SSH
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2. Go to your Laptop, Create a New Folder where your code is stored.
|
|
|
|
Right-click to open the context menu and select the Git Clone option
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. Fill in your project's SSH URL which you can get from the repository page on git.nexval.com, check to make sure the directory is set correctly.
|
|
|
|
|
|
|
|
Tick the Load Putty Key option and select your PuTTY private key file (It should have a .ppk extension) by either selecting it from the dropdown menu or by browsing to it with the … button
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Enter the password that is given during public key creation.
|
|
|
|
Click Yes, if popup prompt for fingerprint matching (Only First Time)
|
|
|
|
Click Okay and it will download the files (Reference 10-2)
|
|
|
|
After the files have been downloaded, move your project/repo into the folder and commit the new files
|
|
|
|
|
|
|
|
**Commits**
|
|
|
|
1. Navigate to your project folder, Create a New File
|
|
|
|
2. Right-click the project folder and select the Git Commit → … option
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. Select the files you want to commit, optionally you can double click any file to check it's changes
|
|
|
|
4. Write your commit message
|
|
|
|
5. Press the Commit button in the bottom right
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
6. After all of your changes have been committed in their own commits, right click the project folder again and select the Git Sync option
|
|
|
|
Click Push and your changes will be uploaded to git.nexval.com on your project.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7. Login into Git.nexval.com
|
|
|
|
navigate your project/repo and here you can see your latest commit.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
