https://github.com/sous-chefs/maven
Development repository for the maven cookbook
https://github.com/sous-chefs/maven
chef chef-cookbook chef-resource hacktoberfest managed-by-terraform maven
Last synced: 2 months ago
JSON representation
Development repository for the maven cookbook
- Host: GitHub
- URL: https://github.com/sous-chefs/maven
- Owner: sous-chefs
- License: apache-2.0
- Created: 2012-03-14T18:34:11.000Z (about 13 years ago)
- Default Branch: main
- Last Pushed: 2024-12-04T17:44:29.000Z (6 months ago)
- Last Synced: 2025-04-09T20:13:43.836Z (2 months ago)
- Topics: chef, chef-cookbook, chef-resource, hacktoberfest, managed-by-terraform, maven
- Language: Ruby
- Homepage: https://supermarket.chef.io/cookbooks/maven
- Size: 318 KB
- Stars: 36
- Watchers: 46
- Forks: 150
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# maven Cookbook
[](https://supermarket.chef.io/cookbooks/maven)
[](https://github.com/sous-chefs/maven/actions?query=workflow%3Aci)
[](#backers)
[](#sponsors)
[](https://opensource.org/licenses/Apache-2.0)
Install and configure Apache Maven from the binaries provided by the Maven project.
Provides the `maven` resource for pulling a maven artifact from a maven repository and placing it in an arbitrary location.
Note: This cookbook does not handle the installation of Java but does require it to be installed. This can be done either using the [Java cookbook](https://supermarket.chef.io/cookbooks/java) or your own cookbook. Check the [Maven website](https://maven.apache.org/docs/history.html) for more information about explicit Java requirements.
## Maintainers
This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit [sous-chefs.org](https://sous-chefs.org/) or come chat with us on the Chef Community Slack in [#sous-chefs](https://chefcommunity.slack.com/messages/C2V7B88SF).
## Requirements
### Platforms
- Debian/Ubuntu
- RHEL/CentOS/Scientific/Amazon/Oracle
- Fedora
- Windows
### Chef
- Chef 13+
### Cookbooks
- ark - used to unpack the maven tarball
## Attributes
- `node['maven']['version']` - specifies the version of maven to install.
- `node['maven']['m2_home']` - defaults to '/usr/local/maven/'
- `node['maven']['url']` - the download url for maven
- `node['maven']['checksum']` - the checksum, which you will have to recalculate if you change the download url using `shasum -a 256 FILENAME`
- `node['maven']['repositories']` - an array of maven repositories to use; must be specified as an array. Used in the maven LWRP.
- `node['maven']['setup_bin']` - whether or not to put mvn on your system path, defaults to false
- `node['maven']['mavenrc']['opts']` - value of `MAVEN_OPTS` environment variable exported via `/etc/mavenrc` template, defaults to `-Dmaven.repo.local=$HOME/.m2/repository -Xmx384m`
- `node['maven']['user']` - User to own Maven install, defaults to `root` or `Administrator` depending on platform.
- `node['maven']['group']` - Group to own Maven install, defaults to `root` or `Administrators` depending on platform.
## Recipes
### default
Installs maven according to the version specified by the `node['maven']['version']` attribute.
### settings
Installs gems required to parse settings.xml to ruby and hash and back to xml
## Usage
Install a version of Java JRE (Oracle or OpenJDK) that is at minimum the version of Java required by the [maven release you are installing](https://maven.apache.org/docs/history.html). This can be done either using the [Java cookbook](https://supermarket.chef.io/cookbooks/java) or your own cookbook.
Include the recipe where you want Apache Maven installed.
The maven lwrp has two actions, `:install` and `:put`. They are essentially the same accept that the install action will name the the downloaded file `artifact_id-version.packaging`. For example, the mysql jar would be named mysql-5.1.19.jar.
Use the put action when you want to explicitly control the name of the downloaded file. This is useful when you download an artifact and then want to have Chef resources act on files within that the artifact. The put action will creat a file named `name.packaging` where name corresponds to the name attribute.
## Providers/Resources
- [maven](./documentation/maven.md)
- [maven_settings](./documentation/maven_settings.md)
## Contributors
This project exists thanks to all the people who [contribute.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)
### Backers
Thank you to all our backers!
### Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.
