Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oracle/puppet-solaris_providers
Oracle Solaris Puppet Module
https://github.com/oracle/puppet-solaris_providers
puppet solaris
Last synced: 3 months ago
JSON representation
Oracle Solaris Puppet Module
- Host: GitHub
- URL: https://github.com/oracle/puppet-solaris_providers
- Owner: oracle
- License: apache-2.0
- Created: 2016-08-16T15:09:59.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-07-24T15:37:24.000Z (6 months ago)
- Last Synced: 2024-07-24T17:35:11.071Z (6 months ago)
- Topics: puppet, solaris
- Language: Ruby
- Homepage:
- Size: 741 KB
- Stars: 9
- Watchers: 13
- Forks: 20
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# solaris_providers Module for Puppet
[](https://travis-ci.org/oracle/puppet-solaris_providers)
#### Table of Contents
1. [Overview](#overview)
2. [Module Description - What the module does and why it is useful](#module-description)
3. [Setup - The basics of getting started with solaris_providers](#setup)
* [What solaris_providers affects](#what-solaris_providers-affects)
* [Beginning with solaris_providers](#beginning-with-solaris_providers)
4. [Usage - Configuration options and additional functionality](#usage)
5. [Limitations - OS compatibility, etc.](#limitations)
6. [Development - Guide for contributing to the module](#development)
## Overview
The Oracle Solaris Providers module includes Solaris-specific implementations of
types and providers. These include some common features as well as features
found exclusively on Oracle Solaris.
## Module Resource Type Reference
The Oracle Solaris Providers module currently enables configuration of the
following:
* Boot Environments via beadm
* Naming Services via svccfg, svcprop
* Image Pacakging System (IPS) configuration via pkg
* Solaris Integrated Load Balancer (ILB) via ilbadm
* Solaris Elastic Virtual Switch (EVS) via evsadm
* Service Management Facility (SMF) Properties via svccfg, svcprop
* IP Interface Configuration via ipadm
* Datalink Management via dladm
* ZFS ACLs and file Attributes via chmod
Oracle Solaris Providers override the core Puppet providers for:
* Zones via zoneadm, zonecfg
### See [documentation index](https://oracle.github.io/puppet-solaris_providers/_index.html) for details
## Setup
For Solaris 11.4 (onwards) pkg install puppet
No additional setup or configuration is required.
### Beginning with solaris_providers
Common activities include modifying service properties
Two ways to change the domain configuration:
1. Via svccfg
```ruby
# Service is provided by Core Puppet
# Make sure dns/client:default is running
# Required for notification of property change
service { 'svc:/network/dns/client:default':
ensure => 'running'
}
# Set domain to oracle.lab, dns/client:default must be refreshed to
# write the config to /etc/resolv.conf
svccfg { 'svc:/network/dns/client:default/:properties/config/domain':
ensure => 'present',
type => 'astring',
value => 'oracle.lab',
notify => Service['svc:/network/dns/client:default'];
}
```
2. Via the DNS provider
```ruby
# Set the domain to oracle.lab
dns { 'current':
domain => 'oracle.lab'
}
```
Set the server for puppet/agent
```ruby
# enable puppet:agent
service { 'svc:/application/puppet:agent':
ensure => 'running'
}
# configure puppet:agent, refresh the service to write puppet.conf
svccfg { 'svc:/application/puppet:agent/:properties/config/server':
ensure => 'present',
type => 'astring',
value => 'puppet',
notify => Service['svc:/application/puppet:agent'],
}
```
## Usage
See links to extracted documents listed above.
## Limitations
These modules were created for use on Oracle Solaris 11 and 11.4.
## Development
Contributors should issue pull requests via Github see [contributing](CONTRIBUTING.md) and [testing](TESTING.md).
### Notes
Package installation is via Puppet Core package provider
Solaris providers are shipped with Solaris in the oracle-solaris_providers IPS package and installed automatically with puppet. Use of the module from this repo is possible but not addressed in this document.
## Contributing
This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
## Security
Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process
## License
Copyright (c) 2015, 2024 Oracle and/or its affiliates.
Released under the Apache License Version 2.0 as shown at
http://www.apache.org/licenses/LICENSE-2.0.