git/README.md

   1 ---
   2 title: Git
   3 homepage: https://git-scm.com
   4 tagline: |
   5   git: --fast-version-control
   6 description: |
   7   > Git is a fast, scalable, distributed revision control system with an
   8   > unusually rich command set that provides both high-level operations and full
   9   > access to internals.
  10 ---
  11
  12 Github's [Git 'Hello World'](https://guides.github.com/activities/hello-world/)
  13 is a good place to get started if you're new to git.
  14
  15 ### How to commit files
  16
  17 ```bash
  18 git add ./path/to/file1
  19 git add ./path/to/file2
  20 git commit -m "my summary for this commit"
  21 ```
  22
  23 ### How to ignore common files
  24
  25 In your project repository create a `.gitignore` file with patterns of fies to
  26 ignore
  27
  28 ```txt
  29 .env*
  30 *.bak
  31 *.tmp
  32 .*.sw*
  33 ```
  34
  35 ### How to create a branch
  36
  37 This will branch from the branch you're currently on.
  38
  39 ```bash
  40 git checkout -b my-branch-name
  41 ```
  42
  43 ### How to rebase
  44
  45 > To "rebase" simply means to undo any of your changes, apply updates from
  46 > another branch first, and then replay your changes.
  47
  48 Rebase when fetching new updates
  49
  50 ```bash
  51 git pull --rebase origin master
  52 ```
  53
  54 Rebase a feature branch from master before a merge
  55
  56 ```bash
  57 # update master
  58 git fetch
  59 git checkout master
  60 git pull
  61
  62 # go back to your feature branch
  63 git checkout my-feature
  64
  65 # start the rebase
  66 git rebase master
  67
  68 # fix conflicts if you need to, and then continue
  69 git add ./my-merged-file
  70 git rebase --continue
  71 ```
  72
  73 ### How to authenticate git with deploy tokens
  74
  75 Abbreviated from
  76 [The Vanilla DevOps Git Credentials & Private Packages Cheatsheet](https://coolaj86.com/articles/vanilla-devops-git-credentials-cheatsheet/):
  77
  78 First, update `.gitconfig` to handle each type of git URL (git, ssh, and http)
  79 as https:
  80
  81 ```bash
  82 git config --global url."https://api@github.com/".insteadOf "https://github.com/"
  83 git config --global url."https://ssh@github.com/".insteadOf "ssh://git@github.com/"
  84 git config --global url."https://git@github.com/".insteadOf "git@github.com:"
  85 ```
  86
  87 Next, create a `.git-askpass`:
  88
  89 ```bash
  90 echo 'echo $MY_GIT_TOKEN' > $HOME/.git-askpass
  91 chmod +x $HOME/.git-askpass
  92 ```
  93
  94 Finally, add the following ENVs to your deployment environment:
  95
  96 ```bash
  97 GIT_ASKPASS=$HOME/.git-askpass
  98
  99 # Relpace xxxx... with your deploy token
 100 MY_GIT_TOKEN=xxxxxxxxxxxxxxxx
 101 ```
 102
 103 In the case of Github it may be useful to create a read-only deploy user for
 104 your organization.
 105
 106 This can work with Docker, Github, Gitlab, Gitea, CircleCI, and many more.