Version information
Start using this module
Add this module to your Puppetfile:
mod 'vmware-vshield', '0.5.0'Learn more about managing modules with a PuppetfileDocumentation
VMware vShield module
This module manages resources in VMware vCloud Network and Security 5.1 (vCNS), i.e. vShield.
Description
VMware vCloud Network and Security is deployed via a virtual appliance. The module is able to attach vCNS to a vCenter and manages vCNS 5.1 resources via vShield API through REST.
+------------+ +--------+
| | vSphere | vCSA | <-
| Puppet | +-----> +--------+ |
| Management | | register
| Host | vShield +--------+ |
| | +-----> | vCNS | --
+------------+ +--------+
Installation
$ puppet module install vmware/vshield
Usage
Two transport connection is required for managing vShield resources, since vShield is dependent on a vCenter:
transport { 'vshield':
username => 'admin',
password => 'default',
server => 'vshield.lab'
}
transport { 'vcenter':
username => 'root',
password => 'vmware',
server => 'vcenter.lab',
options => { 'insecure' => true, },
}
Establishing connection to vCenter is specified by vshield_global_config:
vshield_global_config { 'vshield.lab'
vc_info => {
ip_address => 'vcenter.lab',
user_name => 'root',
password => 'vmware',
},
time_info => { 'ntp_server' => 'us.pool.ntp.org', }
dns_info => { 'primary_dns' => '8.8.8.8' },
transport => Transport['vshield'],
}
The vCenter transport server attribute must match vshield_global_config[vc_info][ip_address] returned by the vShield API. Connectivity to vCenter is necessary to translate resource (such as a datacenter, esx host, or folder name) to vSphere Managed Object Reference (MoRef) required by the vShield API.
vshield_edge can be deployed to compute resource in a datacenter:
vshield_edge { 'vshield.lab:edge_dmz':
ensure => present,
datacenter_name => 'datacenter_1',
compute => 'cluster_dmz_1',
enable_aesni => false,
enable_fips => false,
enable_tcp_loose => false,
vse_log_level => 'info',
fqdn => "edge.dmz.lab",
transport => Transport['vshield'],
}
See tests folder for additional examples.
Types in this module release
Dependencies
- vmware/vmware_lib (>= 0.0.1)
Copyright (C) 2013 VMware, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.