cookbook 'rackspace-dns', '~> 1.1.2'
rackspace-dns (3) Versions 1.1.2 Follow2
Manages DNS records and zones in Rackspace Cloud DNS
cookbook 'rackspace-dns', '~> 1.1.2', :supermarket
knife supermarket install rackspace-dns
knife supermarket download rackspace-dns
chef-rackspace-dns
Description
Adds resources for managing DNS zones and records in Rackspace DNS
Requirements
A Rackspace Cloud account is required to use
this cookbook. You will need a valid username and API key to authenticate into
your account.
You can sign up for an account here.
Dependencies
The following dependencies are installed via rsdns::default.
Packages
- libxml2-dev
- libxslt-dev
Gems
Usage
Account Credentials
It is highly recommended you store your Rackspace Cloud authentication
credentials in an encrypted data bag. This cookbook looks for an encrypted
data bag rackspace
and the cloud
data bag item. The item should look like
the following.
{ "id": "cloud", "username": "your_rackspace_username", "apikey": "your_rackspace_api_key", "region": "[us|uk]" }
region
should be set to us
or uk
, depending on where your account was
created. If you signed up for your Rackspace Cloud account through
rackspace.com, then you have a us
account. If you signed up through
rackspace.co.uk, then you have a uk
account. The default if neither is
supplied is us
.
Alternatively, you can set the credentials through attributes.
default[:rsdns][:rackspace_username] = 'your_rackspace_username' default[:rsdns][:rackspace_api_key] = 'your_rackspace_api_key' default[:rsdns][:rackspace_auth_region] = '[us|uk]'
Resources
Record
This is an example of creating an A record for the host via recipe. It assumes
that the domain for node[:domain]
exists as a domain on your Rackspace Cloud
account. See the Zone resource for creating a zone via recipe.
rsdns_record node[:fqdn] do domain node[:domain] value node[:ipaddress] type 'A' ttl 300 end
The only required attributes are domain
and value
. The available attributes
are:
-
name
- Defaults to the name of the resource -
domain
- Required -
value
- Required (Example: IP Address an A record should resolve to) -
type
- Default 'A' -
ttl
- Default '300' (String or Integer is fine) -
priority
- Defaultnil
, but useful with MX and TXT records
Zone
This is an example of creating a new domain (also known as a zone) via recipe.
rsdns_zone node[:domain] do email 'foo@bar.com' ttl 300 end
The only required attribute is email
. ttl
defaults to 300.
Attributes
default[:rsdns][:rackspace_username] = 'your_rackspace_username' default[:rsdns][:rackspace_api_key] = 'your_rackspace_api_key' default[:rsdns][:rackspace_auth_region] = '[us|uk]'
Recipes
default.rb
Installs the necessary packages and ruby gems.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.1.2 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.1.2 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
1.1.2 failed this metric
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:58
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:67
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:71
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:75
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:88
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:92
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:28
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:35
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:38
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:47
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:51
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.1.2 passed this metric
Testing File Metric
1.1.2 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
1.1.2 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
1.1.2 failed this metric
1.1.2 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
1.1.2 failed this metric
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:58
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:67
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:71
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:75
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:88
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:92
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:28
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:35
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:38
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:47
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:51
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.1.2 passed this metric
Testing File Metric
1.1.2 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
1.1.2 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
1.1.2 failed this metric
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:67
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:71
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:75
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:88
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/record.rb:92
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:28
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:35
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:38
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:47
FC085: Resource using new_resource.updated_by_last_action to converge resource: rackspace-dns/providers/zone.rb:51
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
1.1.2 passed this metric
Testing File Metric
1.1.2 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
1.1.2 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
1.1.2 failed this metric
1.1.2 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