Download
Instead of downloading the repository and running the installation, you can try the Docker version, see Docker image.
The easiest way to start is to clone the repository:
git clone https://github.com/Ziwi01/proveasio.git ~/proveasio
masterholds the tested changes fromdevelop: documentation, new tools, fixes. All versions default tolatest. CI runs the full installation on this branch every week.developholds all recent changes, sometimes including features still being tested. Use it to try what is coming next.- Tags match the GitHub releases. They were stable when released, but the
latestversions they install change over time.
Check out master, then create your own branch (git checkout -b my-branch).
Pin versions in ansible/vars/overrides.yml. The tools and their version keys are in ansible/roles/software/vars/main.yml, and current-versions.yml in the repository root lists the versions your last run installed.
A branch of your own also makes other customizations easy to keep.
Releases
The project publishes releases from time to time.
You can download a release and unpack it. You then lose the easy way to track your changes and to merge new updates, so cloning the repository is recommended.
Updating
On master or develop, run git pull to get the latest changes. If you changed files locally, you may need to resolve conflicts.
On your own branch, run git fetch and merge master or develop into it (on your branch: git merge origin/master).
With a release tarball, you have to download the new version and move your changes into it by hand.
Then run the playbook again, see Installation.