Using Bash Scripts

The following bash scripts can be used to run certain git commands across several repositories. These scripts can be run from any directory, and will return you to the directory in which you started. Creating aliases for your scripts for easy access is recommended.

Note

You must change ~/docs/* in each script to the location of the git repositories on your local machine.

Creating Bash Aliases

  1. Create the script in a convenient location, for example ~/scripts/

  2. Make the script executable:

    chmod a+x myscript.sh

  3. Open ~/.bashrc and add an alias for the script:

    alias myscript='~/scripts/myscript.sh'

  4. Save the change, then reload the file for the current terminal session:

    source ~/.bashrc

  5. Run the script by using the alias on the command line:

    myscript

Sample Scripts

repocheck.sh

Prints git status -s -b of repositories in the listed directories if they have uncommitted changes or if they are not on the master branch.

This script is helpful for checking if you have any work that has not been committed or pushed, and also for ensuring that you are on the master branches of each repo before attempting to merge from origin or upstream master. Note that the output is the short (-s) version. No message means that the working directory is clean and you are on the master branch. If you receive a message, run git status on the indicated repository for full information.

Example Output:

/docs/administration-guide
## v10...origin/v10
/docs/release-notes
/docs/rest-api-guide
## master...origin/master
M api-guide/index.rst
M api-guide/chapter1.rst
/docs/user-guide

branchlist.sh

This script runs git branch -a on all repositories. It shows you all the local and remote branches, and indicates which branches you have checked out. Remove the -a option to view only local branches.

Example Output:

/docs/administration-guide
* master
  remotes/origin/1.0
  remotes/origin/1.1
  remotes/origin/master

/docs/release-notes
  Enterprise
  Online
* master
  remotes/origin/Enterprise
  remotes/origin/Online
  remotes/origin/master

/docs/rest-api-guide
  Enterprise
* master
  remotes/origin/Enterprise
  remotes/origin/master

/docs/user-guide
  Enterprise
* master
  remotes/origin/Enterprise
  remotes/origin/master

pullall.sh

This script runs git pull on all remote repositories. It is helpful for pulling down changes from all your remote repositories in one action.

Example Output:

/docs/administration-guide
Already up-to-date.

/docs/release-notes
Already up-to-date.

/docs/REST-api-guide
Already up-to-date.

/docs/user-guide
Already up-to-date.