Updated on 2023-07-25 GMT+08:00

Using the TortoiseGit Client

Generating a PPK File

A PPK file is required for downloading and committing code on the TortoiseGit client. Assuming that an SSH key pair has been generated on the Git client. The methods to generate a PPK file are different in the following two scenarios:

  • The Public Key Has Been Added to Ssh-key in CodeArts Repo
    1. On theStart menu, search for and select PuttyGen.
    2. Click Load.

    3. Select the id_rsa file in the directory where the SSH key pair is stored and click Open.

    4. Click OK and select Save private key.

    5. Click Yes to generate a PPK file.
    6. Save the file to the directory where the SSH key pair is stored.

  • The Public Key Has Not Been Added to CodeArts Repo
    1. On theStart menu, search for and select PuttyGen.
    2. Click Generate to generate a key, as shown in the following figure.

    3. Click Save private key to save the generated key as a PPK file.

    4. Click Yes to generate a PPK file.
    5. Save the file to the directory where the SSH key pair is stored.

Creating a Git Version Repository

To create a repository for the first time, right-click in an empty directory on the local computer and choose Git Create repository here….

Cloning a Version Repository

  1. Open the local Git repository directory (where the repository is created) and choose TortoiseGit > Pull on the right-click menu.
  2. Click Manage Remotes.

  3. Specify the URL, select the PPK file for the Putty field, and click OK.

Push Version Repository

  1. Configure the username, email address, and signature key ID (PPK file).
  2. Right-click in the blank area and choose TortoiseGit > setting.
  3. Select Git, and set Name and Email.

    If the push fails, run the following script to locate the fault and send the git.log file generated to the technical support:

    #!/bin/bash 
    # this script will collect some logs for Coding.net  
    ### how to use ### 
    # first enter your git reposiztory  
    # then execute this bash, please make sure you have correct rights  
    echo "## git version  ##################" >> git.log 
    git version  >> git.log 
    echo "## ping ##########################" >> git.log 
    ping code*************.com  >> git.log 
    echo "## curl *************.com ###########" >> git.log 
    curl -v https://code*************.com >> git.log 2>&1 
    echo "## ssh -vT git@*************.com ##############" >> git.log 
    ssh -vT git@*************.com >> git.log 2>&1 
    echo "## git pull  ##############" >> git.log 
    GIT_CURL_VERBOSE=1 GIT_TRACE=1 GIT_TRACE_PACKET=1 git pull  >> git.log  2>&1