Providence (@mgsisk/providence)

Opinionated Vagrant shell provisioner for web development.

Providence is an opinionated Vagrant shell provisioner for web development using Debian base boxes. It includes:

• Caches – Memcached, Redis
• Container Engines – Docker
• Content Management Systems – WordPress
• Databases – CouchDB, MariaDB, MongoDB, PostgreSQL, SQLite
• Languages – Go, Node, Perl, PHP, Python, Ruby, Rust
• Package Managers – Bundler, Cargo, Composer, NPM, Pipenv
• Static Site Generators – Hugo, Jekyll, Pelican, Zola
• Utilities – Adminer, Docker Compose, MailHog, Git LFS, git-svn, GitHub CLI, node-build, ocp, perl-build, phpMemcachedAdmin, phpRedisAdmin, postfix, ruby-build, ShellCheck, ShellSpec, vim, Webgrind, webmin, WP-CLI, xmllint
• Version Control Systems – Git, Mercurial, Subversion
• Version Managers – goenv, nodenv, plenv, pyenv, rbenv, rustup
• Web Servers – Apache, Nginx

Installation

The easiest way to use Providence is as a remote shell provisioner, but you can download and build it locally with:

git clone https://github.com/mgsisk/providence.git providence
./providence/src/make.sh

Usage

Vagrant.configure('2') do |config|
  config.vm.box = 'debian/buster64'
  config.vm.hostname = 'providence.test'
  config.vm.network 'private_network', type: 'dhcp'
  config.vm.provision 'shell', path: 'https://github.com/mgsisk/providence/releases/download/v0.1.6/provisioner.sh'
end

Support resources are available if you need help with this project. Refer to the documentation for more detailed information on what Providence does and how it works.

Contributing

Contributions are always welcome; please read the code of conduct before you begin. See the changelog for notable project changes, and report any security concerns you find.

Thanks

To the contributors that help to build, fund, and maintain this project; the other works that have contributed to and inspired this project; and anyone that has found this project useful.

License

ISC