Script to manage Git projects with multiple submodules and multiple environment branches per repository.

If you have several initialized submodules in your project, and you handle several environment branches both in the project as in the related submodules, then you have a Git-Matrix case:

 ------------------------------------- | B | B | B | B | | B | | R | R | R | R | | R | | A | A | A | A | | A | | N | N | N | N | ... | N | | C | C | C | C | | C | | H | H | H | H | | H | | 1 | 2 | 3 | 4 | | X | ------------------------|-----|-----|-----|-----|-----|-----| | S U B M O D U L E 1 | | | | | | X | |-----------------------|-----|-----|-----|-----|-----|-----| | S U B M O D U L E 2 | G | | | | I | | |-----------------------|-----|-----|-----|-----|-----|-----| | S U B M O D U L E 3 | | I | | R | | | |-----------------------|-----|-----|-----|-----|-----|-----| | S U B M O D U L E 4 | | | T | | | | |-----------------------|-----|-----|-----|-----|-----|-----| | . . . | | A | | | | | |-----------------------|-----|-----|-----|-----|-----|-----| | S U B M O D U L E Y | M | | | | | | ------------------------------------------------------------- 

You directly move across the project environment branches using the usual Git commands such as git checkout <branch> or any other similar.

Being positioned at the branch you want to update, you can directly run the ./bin/git_matrix.sh script from the project root folder, which performs the following tasks:

• Updates the active local branch (git pull) and submodules status (git submodule init & git submodule update).
• Updates all environment branches of each submodule.
• If the active branch is the first environment branch (the branch defined in the first position), the script directly positions each submodule in the last commit (HEAD) of its first environment branch.
• If the active branch is any other different from the first, the script merges the previous environment branch in order to propagate the commited and pushed changes made in the previous environment/s of the project, and then perfoms the following execution alternatives:
  • If the script has been executed with the [-k|--keep] optional parameter, it keeps for each submodule the current commit versioned in the active branch, discarding the new submodules versions (commits) that may have been updated due to the merge process.
  • If the script has been executed without any parameter, it shows for each submodule the current commit versioned in the active branch, and interactively asks to select the environment branch in which you want to position the submodule, offering an additional option to keep the current commit.
• Commits the changes made by the previous action, in the event that there are, including as commit message the list of updates made by the script.

To configure the git_matrix.sh script within your project, just run the following command from the project root folder:

$ curl -s https://raw.githubusercontent.com/rubenmromero/git-matrix/master/install.sh |bash 

As a result of this execution, the git_matrix.sh script is configured in the bin directory located in the project root folder.