Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mgsisk/providence
Opinionated Vagrant shell provisioner for web development.
https://github.com/mgsisk/providence
provisioning vagrant web
Last synced: 15 days ago
JSON representation
Opinionated Vagrant shell provisioner for web development.
- Host: GitHub
- URL: https://github.com/mgsisk/providence
- Owner: mgsisk
- License: isc
- Created: 2021-04-28T21:00:30.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-04-25T20:23:57.000Z (over 1 year ago)
- Last Synced: 2024-10-03T12:21:50.166Z (3 months ago)
- Topics: provisioning, vagrant, web
- Language: Shell
- Homepage:
- Size: 771 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Providence (@mgsisk/providence)
Opinionated Vagrant shell provisioner for web development.
[![Latest release][badge-release]][url-release]
[![Build status][badge-build]][url-build]
[![Code quality][badge-quality]][url-codacy]
[![Maintainer funding][badge-funding]][url-funding]
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:
```sh
git clone https://github.com/mgsisk/providence.git providence
./providence/src/make.sh
```
## Usage
```ruby
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][]
[badge-build]: https://img.shields.io/github/workflow/status/mgsisk/providence/build
[badge-funding]: https://img.shields.io/github/sponsors/mgsisk
[badge-quality]: https://img.shields.io/codacy/grade/e18fdb6393be43b59ea02a285c1faca8
[badge-release]: https://img.shields.io/github/v/tag/mgsisk/providence?sort=semver
[changelog]: CHANGELOG.md
[code of conduct]: CODE_OF_CONDUCT.md
[contributions]: CONTRIBUTING.md
[contributors]: AUTHORS.md
[debian]: https://app.vagrantup.com/debian
[documentation]: docs/README.md
[isc]: LICENSE.md
[other works]: THANKS.md
[security]: SECURITY.md
[support resources]: SUPPORT.md
[url-build]: https://github.com/mgsisk/providence/actions?query=workflow%3Abuild
[url-codacy]: https://app.codacy.com/gh/mgsisk/providence
[url-funding]: CONTRIBUTING.md#funding
[url-release]: https://github.com/mgsisk/providence/releases
[vagrant shell provisioner]: https://www.vagrantup.com/docs/provisioning/shell