Skip to content

Instantly share code, notes, and snippets.

@noelboss
Last active September 4, 2024 16:25
Show Gist options
  • Save noelboss/3fe13927025b89757f8fb12e9066f2fa to your computer and use it in GitHub Desktop.
Save noelboss/3fe13927025b89757f8fb12e9066f2fa to your computer and use it in GitHub Desktop.
Simple automated GIT Deployment using Hooks

Simple automated GIT Deployment using GIT Hooks

Here are the simple steps needed to create a deployment from your local GIT repository to a server based on this in-depth tutorial.

How it works

You are developing in a working-copy on your local machine, lets say on the master branch. Most of the time, people would push code to a remote server like github.com or gitlab.com and pull or export it to a production server. Or you use a service like deepl.io to act upon a Web-Hook that's triggered that service.

But here, we add a "bare" git repository that we create on the production server and pusblish our branch (f.e. master) directly to that server. This repository acts upon the push event using a 'git-hook' to move the files into a deployment directory on your server. No need for a midle man.

This creates a scenario where there is no middle man, high security with encrypted communication (using ssh keys, only authorized people get access to the server) and high flexibility tue to the use of .sh scripts for the deployment.

Prerequisit

  1. Know how to use GIT, Terminal etc.
  2. Have a local working-working copy ready
  3. Have SSH access to your server using private/public key

Todos

  1. Create a folder to deploy to on production server (i.e. your httpds folder)
  2. Add a bare repository on the productions server
  3. Add the post-receive hook script to the bare repository (and make it executable)
  4. Add the remote-repository resided on the production server to your local repository
  5. Push to the production server, relax.

1. Have a local working-working copy ready

Nuf said. I asume we are working on master – but you could work on any branch.

2. Create a folder to deploy to

ssh into your prodctionserver:

$ ssh user@server.com
$ mkdir ~/deploy-folder

3. Add a bare repository on the productions server

Now we create a "bare" repository – one that does not contain the working copy files. It basicaly is the content of the .git repository folder in a normal working copy. Name it whatever you like, you can also ommit the .git part from project.git or leave it to create the repository in an exisiting empty folder:

$ git init --bare ~/project.git

4. Add the post-receive hook script

This scrtipt is executed when the push from the local machine has been completed and moves the files into place. It recides in project.git/hooks/ and is named 'post-receive'. You can use vim to edit and create it. The script does check if the correct branch is pushed (not deploying a develop branch for example). You can download a sample post-receive script below. Also, don't forget to add execute permissions to said script;

chmod +x post-receive

5. Add remote-repository localy

Now we add the this bare repository to your local system as a remote. Where "production" is the name you want to give the remote. This also be called "staging" or "live" or "test" etc if you want to deploy to a different system or multiple systems.

$ cd ~/path/to/working-copy/
$ git remote add production demo@yourserver.com:project.git

Make sure "project.git" coresponds to the name you gave in step 3. If you are using Tower or a similar App, you will see the newly added remote in your sidebar under "Remotes" (make sure it's not collapsed).

6. Push to the production server

Now you can push the master branch to the production server:

$ git push production master

If you are using tower, you can drag&drop the master branch onto the new production remote. That's it. Have questions, improvements?

(c) Noevu Schweizer KMU Webseiten

#!/bin/bash
TARGET="/home/webuser/deploy-folder"
GIT_DIR="/home/webuser/www.git"
BRANCH="master"
while read oldrev newrev ref
do
# only checking out the master (or whatever branch you would like to deploy)
if [ "$ref" = "refs/heads/$BRANCH" ];
then
echo "Ref $ref received. Deploying ${BRANCH} branch to production..."
git --work-tree=$TARGET --git-dir=$GIT_DIR checkout -f $BRANCH
else
echo "Ref $ref received. Doing nothing: only the ${BRANCH} branch may be deployed on this server."
fi
done
@shakibamoshiri
Copy link

shakibamoshiri commented Feb 19, 2021

@altcointrading

It is super simple, you can follow bellow setps

> cd /tmp
> # create two dirs 
> mkdir repo{,.git}
> cd repo
> git init
> git remove add server /tmp/repo.git
> # go back to repo.git
> cd ../repo.git
> git init --bare
> cd hooks 
> # remove all scripts 
> rm -fr *
> # create update script
> vim update 
> # add a shell script e.g.
#!/bin/bash
echo "this is update file"

> # create new one
> vim post-receive 
> # add shell script 
#/bin/bash
echo "this is post-receive file"

> # add exec permission to them
> chmod u+x *
> # go back to /tmp/repo
> cd /tmp/repo
> echo "this is line 1' >> file
> git add file
> git commit -m 'Add new file';
> git push -u server master

and you will have output like this

Counting objects: 3, done.
Writing objects: 100% (3/3), 227 bytes | 227.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote: this is update in hooks
remote: this is post-receive in hooks
To /tmp/repo.git
 * [new branch]      master -> master
Branch 'master' set up to track remote branch 'master' from 'server'.

20210219_16o2114

remote: Resolving deltas: 100% (474/474), done.
remote: Ref refs/heads/master received. Deploying master branch to production...
remote: fatal: Not a git repository: '/home/myuser/www.git'

this part is coming back from bare repository which is a kind of server here it prints into stdout or stderr which is received by git client, the one you used to do git push ...

and inside hooks

20210219_16o2941

@zedxos
Copy link

zedxos commented Feb 23, 2021

@altcointrading

It is super simple, you can follow bellow setps

> cd /tmp
> # create two dirs 
> mkdir repo{,.git}
> cd repo
> git init
> git remove add server /tmp/repo.git
> # go back to repo.git
> cd ../repo.git
> git init --bare
> cd hooks 
> # remove all scripts 
> rm -fr *
> # create update script
> vim update 
> # add a shell script e.g.
#!/bin/bash
echo "this is update file"

> # create new one
> vim post-receive 
> # add shell script 
#/bin/bash
echo "this is post-receive file"

> # add exec permission to them
> chmod u+x *
> # go back to /tmp/repo
> cd /tmp/repo
> echo "this is line 1' >> file
> git add file
> git commit -m 'Add new file';
> git push -u server master

and you will have output like this

Counting objects: 3, done.
Writing objects: 100% (3/3), 227 bytes | 227.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote: this is update in hooks
remote: this is post-receive in hooks
To /tmp/repo.git
 * [new branch]      master -> master
Branch 'master' set up to track remote branch 'master' from 'server'.

20210219_16o2114

remote: Resolving deltas: 100% (474/474), done.
remote: Ref refs/heads/master received. Deploying master branch to production...
remote: fatal: Not a git repository: '/home/myuser/www.git'

this part is coming back from bare repository which is a kind of server here it prints into stdout or stderr which is received by git client, the one you used to do git push ...

and inside hooks

20210219_16o2941

Hmmm ty

@Dimitri-WEI-Lingfeng
Copy link

Dimitri-WEI-Lingfeng commented Mar 11, 2021

very useful and simple! thank you!

@Devoleksiy
Copy link

I like the implementation.
What command can I add files from the working directory, for example, the working folder was not empty.
Any advice, I Might be able to move on.

@Hawzen
Copy link

Hawzen commented May 10, 2021

Life saver

@junglistcode
Copy link

so if the server disappears or you delete it, you lose your git repository...

what about staging or test environment? different git repository? this makes no sense

But you'd just lose the remote right? You still have your local on your develepment machine won't u?

@norley-tucker
Copy link

Thanks very much, very helpful!

@shakibamoshiri
Copy link

win-20220321_18o0859

here is my new approach with these steps

  • setting up a git server
  • create a bare repo on git server - git init --bare
  • setting up post-update on bare repo
  • setting up a working tree which pulls form bare repo (git init)
  • pushing from working tree to another server after some tests with port-merge

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment