Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hfm/puppet-h2o
Handles installing, configuring, and running h2o via Puppet module
https://github.com/hfm/puppet-h2o
h2o http-server http2 http2-server https puppet
Last synced: 14 days ago
JSON representation
Handles installing, configuring, and running h2o via Puppet module
- Host: GitHub
- URL: https://github.com/hfm/puppet-h2o
- Owner: hfm
- License: mit
- Created: 2017-05-27T07:43:26.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-09T02:37:34.000Z (about 6 years ago)
- Last Synced: 2024-12-21T13:06:13.958Z (about 2 months ago)
- Topics: h2o, http-server, http2, http2-server, https, puppet
- Language: Ruby
- Homepage: https://forge.puppet.com/hfm/h2o
- Size: 45.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# h2o [](https://travis-ci.org/hfm/puppet-h2o) [](https://forge.puppet.com/hfm/h2o)
#### Table of Contents
1. [Description](#description)
1. [Setup - The basics of getting started with h2o](#setup)
* [Setup requirements](#setup-requirements)
* [Beginning with h2o](#beginning-with-h2o)
1. [Usage - Configuration options and additional functionality](#usage)
- [Configuring](#configuring)
- [Configuring modules from Hiera](#configuring-modules-from-hiera)
1. [Reference - An under-the-hood peek at what the module is doing and how](#reference)
- [Public Classes](#public-classes)
- [Private Classes](#private-classes)
- [Parameters](#parameters)
1. [Limitations - OS compatibility, etc.](#limitations)
1. [Development - Guide for contributing to the module](#development)
- [Running tests](#running-tests)
- [Testing quickstart](#testing-quickstart)
## Description
The h2o module handles installing, configuring, and running [h2o](https://h2o.examp1e.net/).
## Setup
### Setup Requirements
- [puppetlabs-stdlib](https://forge.puppet.com/puppetlabs/stdlib) (>= 4.0.0 < 5.0.0)
- [puppetlabs-apt](https://forge.puppet.com/puppetlabs/apt) (>= 2.0.0 < 5.0.0)
### Beginning with h2o
To install the h2o with default parameters, declare the `h2o` class.
```puppet
include ::h2o
```
## Usage
### Configuring h2o
```puppet
class { 'h2o':
package_ensure => '2.2.2-1~ubuntu16.04.1',
}
```
### Configuring modules from Hiera
```yaml
h2o::package_ensure: '2.2.2-1~ubuntu16.04.1'
```
## Reference
### Public Classes
- [`h2o`](#h2o): Installs and runs h2o.
### Private Classes
- `h2o::install`: Installs the h2o package.
- `h2o::repo`: Manages the h2o repository.
- `h2o::repo::yum`: Manages the Yum repository.
- `h2o::repo::apt`: Manages the Apt sources.
- `h2o::service`: Manages service.
### Parameters
#### `h2o` class
- `repo_ensure`: Specifies whether the h2o repository should exist. Type is the String. Default: 'present'.
- `package_ensure`: What state the package should be in. Type is the String. Default: 'installed'.
- `service_ensure`: Whether a service should be running. Type is the String. Default: 'running'.
- `service_enable`: Whether a service should be enabled to start at boot. Type is the Boolean. Default: true.
## Limitations
This module has been tested on:
- RedHat Enterprise Linux 6, 7
- CentOS 6, 7
- Scientific Linux 6, 7
- Fedora 22, 23, 24, 25
- Debian 7, 8
- Ubuntu 14.04, 16.04
## Development
### Running tests
The tinyproxy module contains tests for both [rspec-puppet](http://rspec-puppet.com/) (unit tests) and [beaker-rspec](https://github.com/puppetlabs/beaker-rspec) (acceptance tests) to verify functionality. For detailed information on using these tools, please see their respective documentation.
### Testing quickstart
Unit tests:
```console
$ bundle install
$ bundle exec rake test
```
Acceptance tests using docker:
```console
# List available beaker nodesets
$ bundle exec rake beaker_nodes
centos7
xenial
# Run beaker acceptance tests
$ BEAKER_set=xenial bundle exec rake beaker
```