https://github.com/raphink/puppet-netcf
Netcf provider for Puppet
https://github.com/raphink/puppet-netcf
Last synced: 12 months ago
JSON representation
Netcf provider for Puppet
- Host: GitHub
- URL: https://github.com/raphink/puppet-netcf
- Owner: raphink
- Created: 2012-12-10T14:01:15.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2014-07-03T14:59:08.000Z (almost 12 years ago)
- Last Synced: 2025-05-14T05:36:43.502Z (about 1 year ago)
- Language: Ruby
- Size: 116 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Netcf module for Puppet
**Manages network settings using the Netcf library.**
This is the Puppet netcf module.
## Rationale
Managing network interfaces cleanly using Puppet is not an easy task. Fortunately, the `netcf` library provides an OS-agnostic interface which allows to manage network settings natively through an XML-based API.
This module uses the `netcf` Ruby bindings to provide a set of types and providers for Puppet in order to cleanly manage network settings.
## Requirements
This module requires [the netcf Ruby bindings](https://github.com/raphink/netcf-ruby)
## Resources
### `netcf_if`
The `netcf_if` type is a generic type which lets you manage any kind of interface (or even more than one) by passing an XML description of it. The XML description (as per [`netcf`'s XML schema](https://git.fedorahosted.org/cgit/netcf.git/tree/tests/interface)) is passed to the `netcf` library to define the interface.
Sample usage:
```puppet
netcf_if {"eth1":
ensure => up,
definition => '
',
}
```
### `network_if`
The `network_if` is a type to manage simple network interfaces through the `netcf` library.
Sample usage:
```puppet
network_if { 'eth0':
ensure => 'down',
type => 'ethernet',
start_mode => 'onboot',
ipv4_ips => ['192.168.1.3/24'],
}
```
## Contributing
Please report bugs and feature request using [GitHub issue
tracker](https://github.com/camptocamp/puppet-netcf/issues).
For pull requests, it is very much appreciated to check your Puppet manifest
with [puppet-lint](https://github.com/camptocamp/puppet-netcf/issues) to follow the recommended Puppet style guidelines from the
[Puppet Labs style guide](http://docs.puppetlabs.com/guides/style_guide.html).
## License
Copyright (c) 2014 All rights reserved.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .