cookbook 'infoblox', '~> 2.1.0'
infoblox (3) Versions 2.1.0 Follow4
Provision and deprovisiong VMware vCenter VMs, and maintain DNS, via Infoblox.
cookbook 'infoblox', '~> 2.1.0', :supermarket
knife supermarket install infoblox
knife supermarket download infoblox
Infoblox Cookbook
The Infoblox cookbook wraps the public APIs available in the "infoblox" gem and is capable of performing functions related to provisioning and de-provisioning vCenter server VMs. It also allows DHCP and DNS configuration to be provided from a centrally managed Infoblox appliance. The motive behind the cookbook was the integration of the DDI (DNS, DHCP and IPAM) with the virtual/Cloud provisioning. Currently it is integrated with vSphere. In future it will be available for EC2, openstack and more.
Prerequisites
Configure your Chef workstation setup. The cookbook is tested against Chef version 12.1.1 and above. The OS can be Windows or any Linux machine as the workstation. The focookbook can be run against any of the 3 types of chef-servers.
- Hosted chef
- Private chef-server
- Chef-zero, without having an actual chef server configured.
In all of the above cases, it will run the workflows and create records and VMs.
As an environment presetup, You need to have the following configured before using this cookbook.
- A single vCenter server host.
- A single vNIOS VM acting as a grid master.
- A chef workstation setup in a VM in the network.
- DNS and DHCP configured/objects created in the grid master.
Note: While running the chef-client, Please make sure that you have set the environment variable "WAPI_VERSION".
EX: export WAPI_VERSION=1.4.2
Configuration
In order to communicate with the vCenter API you will have to provide your credentials in the infoblox cokkbooks attributes files.
Ex: In infoblox/attributes/default.rb
default['vcenter']['vcenter_host'] = ''
default['vcenter']['username'] = ''
default['vcenter']['password'] = ''
In order to communicate with the grid master you will have to provide your vNIOS credentials.
default['infoblox']['nios_appliance'] = '' # ip address of the vNIOS appliance
default['infoblox']['username'] = '' # username of the vNIOS appliance
default['infoblox']['password'] = '' # password of the vNIOS appliance
VM Specific Configurations
Provide the below details related to the VM that will be provisioned.
Ex: In infoblox/attributes/vm.rb
default['vcenter']['template_name'] = 'redhat' #Name of the template/image using which the VM will be cloned
default['vcenter']['datacenter'] = 'IB' #Name of the datacenter
default['vcenter']['datastore'] = 'datastore1' #Name of the datastore
default['vcenter']['domain'] = 'demo.com' #Name of the domain for the VM
default['vcenter']['network_name'] = ["VM Network"] #Provide in array as shown
default['vcenter']['gateway'] = ['172.26.1.1'] #Provide in array as shown
default['vcenter']['subnet_mask'] = '255.255.255.0'
default['vcenter']['dns_server_list'] = ['172.26.1.2'] #Provide in array as shown
default['vcenter']['network_adapter'] = 'Network adapter 1'
default['vcenter']['resource_pool'] = '172.26.1.4'
# provisioned VM details
default['vcenter']['vm']['username'] = 'root' #Login username for the VM
default['vcenter']['vm']['password'] = 'xyz' #Login password for the VM
default['vcenter']['vm']['num_cpus'] = 2
default['vcenter']['vm']['memory_mb'] = 1024
# override this attributes for next available ip in range and network.
default['vcenter']['vm']['ipaddress'] = nil
Recipe: reserve_static_ip
The following attributes are required while running reserve_static_ip recipe. So provide the values in the file infoblox/attributes/reserve_static_ip.rb
default['reserve_static_ip']['vm_name'] = 'staticVM-3' # required for reserve and remove workflows
default['reserve_static_ip']['ipv4addr'] = '172.26.1.52'
default['reserve_static_ip']['record_type'] = ['host'] # or %w(A PTR host fixedaddress)
Optional Attributes:
default['reserve_static_ip']['mac'] = ''
default['reserve_static_ip']['view'] = 'default'
default['reserve_static_ip']['ptrdname'] = 'clogeny01.test.local''
default['reserve_static_ip']['canonical'] = 'clogeny1.qa.com'
default['reserve_static_ip']['extattrs'] = { 'Site' => { 'value' => 'Test Value' } }
default['reserve_static_ip']['comment'] = "Test Record for Reserve Static IP workflow"
default['reserve_static_ip']['aliases'] = ['aliases1', 'aliases2']
default['reserve_static_ip']['disable'] = false
Recipe: reserve_ip_in_network
The following attributes are required while running reserve_ip_in_network recipe. So provide the values in the file infoblox/attributes/reserve_ip_in_network.rb
default['reserve_ip_in_network']['vm_name'] = 'networkVM-3'
default['reserve_ip_in_network']['network'] = '10.10.70.0/24'
default['reserve_ip_in_network']['record_type'] = ['A', 'PTR', 'host', 'fixedaddress']
Optional Attributes:
default['reserve_ip_in_network']['exclude'] = ['10.10.70.1', '10.10.70.2', '10.10.70.3'] # ips to exclude
default['reserve_ip_in_network']['ptrdname'] = 'clogeny01.test.local'
default['reserve_ip_in_network']['aliases'] = ['aliases1', 'aliases2']
default['reserve_ip_in_network']['canonical'] = 'clogeny01.test.local'
default['reserve_ip_in_network']['comment'] = "Test Record for Reserve Static IP workflow"
default['reserve_ip_in_network']['extattrs'] = { 'Site' => { 'value' => 'Test Value' } }
default['reserve_ip_in_network']['mac'] = ''
default['reserve_ip_in_range']['view'] = 'default'
default['reserve_ip_in_range']['disable'] = false
Recipe: reserve_ip_in_range
The following attributes are required while running reserve_ip_in_range recipe. So provide the values in the file infoblox/attributes/reserve_ip_in_range.rb
default['reserve_ip_in_range']['vm_name'] = 'rangeVM-3'
default['reserve_ip_in_range']['start_addr'] = '10.10.70.100'
default['reserve_ip_in_range']['end_addr'] = '10.10.70.220'
default['reserve_ip_in_range']['record_type'] = ['A', 'PTR', 'host', 'fixedaddress']
Optional Attributes:
default['reserve_ip_in_range']['exclude'] = ['10.10.70.100', '10.10.70.101']
default['reserve_ip_in_range']['ptrdname'] = 'clogeny01.test.local'
default['reserve_ip_in_range']['aliases'] = ['aliases1', 'aliases2']
default['reserve_ip_in_range']['canonical'] = 'clogeny01.test.local'
default['reserve_ip_in_range']['comment'] = "Test Record for Reserve Static IP workflow"
default['reserve_ip_in_range']['extattrs'] = { 'Site' => { 'value' => 'Test Value' } }
default['reserve_ip_in_range']['mac'] = ''
default['reserve_ip_in_range']['view'] = 'default'
default['reserve_ip_in_range']['disable'] = false
Recipe: remove_reserved_ip
--The following attributes are required while running remove_reserved_ip recipe. So provide the values in the file infoblox/attributes/remove_reserved_ip.rb
default['remove_reserved_ip']['vm_name'] = 'clogeny01'
default['remove_reserved_ip']['ipv4addr'] = '172.26.1.62'
default['remove_reserved_ip']['record_type'] = ['host'] # %w(A PTR host fixedaddress)
Optional Attributes:
default['remove_reserved_ip']['ptrdname'] = 'clogeny01.test.local'
default['remove_reserved_ip']['canonical'] = 'clogeny1.test.local'
Creating A specific Record without provisioning VM
Here we show only for PTR record. Other records can be created just by setting their attribute values and running their recipes.
The following attributes are required while Creating a PTR record. So provide the values in the file infoblox/attributes/ptr_record.rb
- If the IP Address belongs to a reverse-mapped authoratative zone
default['ptr_record']['ipv4addr'] = '' # IPv4 address eg. 10.10.70.100
default['ptr_record']['ptrdname'] = '' # domain name of DNS PTR record in FQDN format. eg. clogeny.test.local
- If the IP doesn't belong to a reverse-mapped authoratative zone
default['ptr_record']['name'] = '' # name of record in FQDN format eg. infoblox01.test.local
default['ptr_record']['ptrdname'] = '' # domain name of DNS PTR record in FQDN format. eg. clogeny.test.local
Optional Attributes:
default['ptr_record']['view'] = 'default' # name of DNS view in which record resides.
default['ptr_record']['extattrs'] = {}
Support
This cookbook is a joint effort between Chef and Infoblox.
Chef customers experiencing a technical issue with this cookbook should open a support ticket for assistance. All other users should feel free to log a GitHub issue in this repository.
For non-technical inquiries regarding this cookbook, please log a GitHub issue, or send an email to one of the following addresses:
- Chef: partnereng@chef.io
- Infoblox: chef-support@infoblox.com
License
Copyright:: Copyright (c) 2015 Chef Software, Inc.
License:: Apache License, Version 2.0
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.
Contributing
- Fork it ( https://github.com/chef-partners/infoblox-cookbook/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
infoblox CHANGELOG
v2.1.0 (2016-03-28)
- Add attributes infoblox.data_bag_name and infoblox.data_bag_item so that user - flexibility in the databag being used.
- Infoblox does not know 'extattrs', set 'extensible_attributes' instead.
- Add actions :create_or_update and :update to infoblox_host_record. These search by hostname only. If the host's ipv4address changes, a new Infoblox::HostIpv4addr is added unless replace_ipv4addrs is true.
v2.0.0 (2016-03-18)
- #2: Raise exceptions on failure in infoblox_api.rb so that converge will be stopped. (@jcejohnson)
v1.0.0
- Initial release
Collaborator Number Metric
2.1.0 passed this metric
Contributing File Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.1.0 failed this metric
FC064: Ensure issues_url is set in metadata: infoblox/metadata.rb:1
FC065: Ensure source_url is set in metadata: infoblox/metadata.rb:1
FC066: Ensure chef_version is set in metadata: infoblox/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: infoblox/metadata.rb:1
FC069: Ensure standardized license defined in metadata: infoblox/metadata.rb:1
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:29
FC120: Do not set the name property directly on a resource: infoblox/recipes/aaaa_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/aaaa_record.rb:18
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:7
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:23
FC120: Do not set the name property directly on a resource: infoblox/recipes/fixedaddress.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/host_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/host_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/ptr_record.rb:9
FC120: Do not set the name property directly on a resource: infoblox/recipes/ptr_record.rb:24
FC120: Do not set the name property directly on a resource: infoblox/recipes/remove_reserved_ip.rb:10
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_ip_in_network.rb:14
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_ip_in_range.rb:14
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_static_ip.rb:10
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
2.1.0 passed this metric
Testing File Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.1.0 passed this metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.1.0 failed this metric
FC064: Ensure issues_url is set in metadata: infoblox/metadata.rb:1
FC065: Ensure source_url is set in metadata: infoblox/metadata.rb:1
FC066: Ensure chef_version is set in metadata: infoblox/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: infoblox/metadata.rb:1
FC069: Ensure standardized license defined in metadata: infoblox/metadata.rb:1
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:29
FC120: Do not set the name property directly on a resource: infoblox/recipes/aaaa_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/aaaa_record.rb:18
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:7
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:23
FC120: Do not set the name property directly on a resource: infoblox/recipes/fixedaddress.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/host_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/host_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/ptr_record.rb:9
FC120: Do not set the name property directly on a resource: infoblox/recipes/ptr_record.rb:24
FC120: Do not set the name property directly on a resource: infoblox/recipes/remove_reserved_ip.rb:10
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_ip_in_network.rb:14
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_ip_in_range.rb:14
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_static_ip.rb:10
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
2.1.0 passed this metric
Testing File Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.1.0 failed this metric
FC065: Ensure source_url is set in metadata: infoblox/metadata.rb:1
FC066: Ensure chef_version is set in metadata: infoblox/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: infoblox/metadata.rb:1
FC069: Ensure standardized license defined in metadata: infoblox/metadata.rb:1
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/a_record.rb:29
FC120: Do not set the name property directly on a resource: infoblox/recipes/aaaa_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/aaaa_record.rb:18
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:7
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/cname_record.rb:23
FC120: Do not set the name property directly on a resource: infoblox/recipes/fixedaddress.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/host_record.rb:8
FC120: Do not set the name property directly on a resource: infoblox/recipes/host_record.rb:17
FC120: Do not set the name property directly on a resource: infoblox/recipes/ptr_record.rb:9
FC120: Do not set the name property directly on a resource: infoblox/recipes/ptr_record.rb:24
FC120: Do not set the name property directly on a resource: infoblox/recipes/remove_reserved_ip.rb:10
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_ip_in_network.rb:14
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_ip_in_range.rb:14
FC120: Do not set the name property directly on a resource: infoblox/recipes/reserve_static_ip.rb:10
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
2.1.0 passed this metric
Testing File Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.1.0 failed this metric
2.1.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number