The unbelievably successful vCheck script from Alan Renouf which can be used to provide a daily report on your vSphere (and other technologies) environment is now available on GitHub. This is a great move since it more easily enables further community input to develop this tool further by allowing you to submit contributions via a central repository.
If you’ve not used GitHub before then head over to the home page and create an account. There are clients for different OS flavours depending on your preference. To get started with Windows, download the GitHub for Windows client and login with your account.
Image may be NSFW.
Clik here to view.
If you wish to contribute to the project then head over to the vCheck page and create a fork:
Image may be NSFW.
Clik here to view.
You can now download the project files via the button Clone in Windows:
Image may be NSFW.
Clik here to view.
Your local client will then show the project available to work on:
Image may be NSFW.
Clik here to view.
So now you can start making changes to your local copy and then potentially submit fixes / enhancements:
Image may be NSFW.
Clik here to view.
To make a change, update the files in your local repository and send a commit up to your fork, preferably with comments on the changes that you made:
Image may be NSFW.
Clik here to view.
To submit these changes to the original project create a Pull Request – the details from your commit should be automatically populated:
Image may be NSFW.
Clik here to view.
Once the changes have been accepted by the project owner, you’ll see them incorporated on the Commits page of the original project:
Image may be NSFW.
Clik here to view.
Once other people start making changes, at some point you’ll want to update your fork and local repository with these updates. To do that you’ll need to head to the command line, since you can’t currently do that directly from the Windows client. You can open a shell into the right place, which will open a PowerShell console with the Git tools available.
Image may be NSFW.
Clik here to view.
Firstly you need to add the original project https://github.com/alanrenouf/vCheck-vSphere as an upstream
git remote add upstream https://github.com/alanrenouf/vCheck-vSphere.git
Then fetch the upstream:
git fetch upstream
Finally, merge the changes:
git merge upstream/master
Image may be NSFW.
Clik here to view.
You’ll now have the updated files locally. Synchronise your client with your fork on GitHub and that will be up-to-date too.
Image may be NSFW.
Clik here to view.
Look forward to other people joining this project!