Syncing your fork or clone with the latest version from CloudSim Plus repository¶
Syncing your fork¶
If you want to contribute to CloudSim Plus, you have to fork the project so that you can make changes at your own copy of the repository. Once you have forked CloudSim Plus, this quick tutorial shows you how to sync your fork with the official repository in order to get the latest development version.
Open a terminal inside the directory where you cloned the CloudSim Plus repository and execute the following commands:
- Add a remote to the official repository in order to track changes on
it (this step has to be performed just once, if you already have
execute it and try to execute again, git will just tell you that a
remote called “upstream” already exists):
git remote add upstream https://github.com/manoelcampos/cloudsim-plus
- Get the latest version from the upstream remote (that is pointing to
the official repository):
git fetch upstream
- Switch to your master branch to merge the changes from the upstream:
git checkout master
- Merge the changes from the master branch got from the upstream remote
into your master:
git merge upstream/master
- As CloudSim Plus is a Maven project, usually it is worth to execute
mvn clean installto clean the build directory, re-build the project and install the new updated CloudSim Plus jars into your local maven repository. This procedure is useful to avoid errors when trying to use a new version.
- Push the changes to your fork at github:
git push origin master
More information on syncing forks can be found here.
Syncing your clone¶
If you just want to download CloudSim Plus source code so that you can use it into your project, study its code, documentation and examples, you can simply clone it locally at your computer. The clone doesn’t create a copy of the repository into your GitHub account. However, if you are planning to make changes and request their inclusion in CloudSim Plus, you have to fork the project.
If you have just cloned the repository, to update your local copy with the official repository it is as simple as executing
git pull at the command line.