Difference between revisions of "Git"

From Lingoport Wiki
Jump to: navigation, search
(SSH)
(.netrc)
Line 39: Line 39:
 
git config --global user.name "Your Name"
 
git config --global user.name "Your Name"
 
</pre>
 
</pre>
  +
  +
In 2021, GitHub depreciated the use of the password and instead recommends using a personal access token instead or other authentication methods. To create a token, follow [[these steps | https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token ]]. Save the token after creating it. Then in the <code>~jenkins/.netrc</code> file, replace the password with the new token.
  +
<pre>
  +
machine github.com
  +
login gitUserName
  +
password <personal access token>
  +
</pre>
  +
  +
On the command line, if prompted for a password, use the token instead.
   
 
== Test ==
 
== Test ==

Revision as of 17:49, 18 February 2021

Install Git

On the Unix box, install Git. To do so, follow this link:

Git User

A Git user must be provided by the development organization. This Git user must have clone, pull, and push access to the projects' repositories to be on-boarded. This Git user is used for all projects.

Scripts started by the jenkins user clone and push to and from the repository; The Git user login and password must be set as per this page:

Storing the Git Credentials

One possibility is to store the Git credentials on the command line as the Jenkins user that runs the scripts. To do so, please refer to the Git Tools Credentials documentation page:

  • The store mode saves the credentials to a plain-text file on disk, and they never expire. This means that until you change your password for the Git host, you won’t ever have to type in your credentials again.

For example,

 git config --global credential.helper store

To test the credentials, execute a git clone (or git pull, etc.) command as the Jenkins Linux user: It will ask you for a username password at the prompt. Once that's entered, re-run a git clone (or git pull, etc.) command: This time, the user should not be prompted for the username password.

This method may work in some cases better than the methods below, for example in some cases with Git over TFS.

SSH

One possibility is to have a user (jenkins on a Continuous Integration (CI) system) have an SSH key to be added to the GitHub account for that Linux user. For instance, log in as 'jenkins' on the CI system. Then generate an SSH key if it does not already exist, and add the SSH key to the GitHub account. To do so, follow the instructions listed at https://help.github.com/articles/generating-an-ssh-key/ .

.netrc

A possible alternative to the SSH key route is using .netrc.

The following is an example of a ~jenkins/.netrc file on Unix:

  machine github.com
  login gitUserName
  password gitPassword

And on the command line, make sure the following is entered:

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

In 2021, GitHub depreciated the use of the password and instead recommends using a personal access token instead or other authentication methods. To create a token, follow https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token . Save the token after creating it. Then in the ~jenkins/.netrc file, replace the password with the new token.

  machine github.com
  login gitUserName
  password <personal access token> 

On the command line, if prompted for a password, use the token instead.

Test

Make sure you can clone some repository using git clone, without having to enter at the prompt the login and password of the Git user.