Menu

Chef Supermarket

Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

View our collection of guides, documentation, and articles

Cookbooks
Advanced Options

Select Badges

Select Supported Platforms

Select Status

RSS

chef-server-populator (17) Versions 1.1.4

Populate chef server with stuff you want

Policyfile
Berkshelf
Knife 
cookbook 'chef-server-populator', '= 1.1.4', :supermarket
cookbook 'chef-server-populator', '= 1.1.4'
knife supermarket install chef-server-populator
knife supermarket download chef-server-populator
README
Dependencies
Changelog
Quality 0%

Chef Server Populator

Creates orgs, clients, and admin users and installs provided public keys. Simplifies managing and
recreating Chef Server nodes. Provides backup and restore recipes for
complete Chef Server recovery.

New Chef 12 Support

Chef 12 is supported in version 1.0 and above. If you need Chef 11
support, please pin your environment to version 0.4.0.

Usage

When bootstrapping with the chef-server cookbook and chef-solo:

  • Download and unpack chef-server, chef-server-ingredient, packagecloud, and chef-server-populator cookbooks
  • Upload public keys to be used by users, org-validator, and clients (optionally)
  • Create json for organization, user, and (optionally) client(s)
  • Run chef-solo

See the default[:chef_server_populator][:solo_org] and
default[:chef_server_populator][:solo_org_user] attribute hashes in
attributes/default.rb for the required attribute structure.

When converging with chef-client:

  • Create data bag to hold data bag items with user, org, and client information
  • Create data bag items with user, org, and client information
  • Set data bag related attributes

Applicable attributes:

  • node[:chef_server_populator][:databag] - name of the data bag

Structure of the data bag item:

User:
json
{
"id": "user_name",
"full_name": "User Name",
"email": "name@domain.tld",
"chef_server": {
"client_key": "public key contents",
"type": [
"user"
],
"orgs": {
"organization": {
"enabled": true,
"admin": true
}
}
}

Note: While users can belong to multiple organizations, and the above
hash structure allows you to define multiple associations, the
chef-server-populator currently only supports the first organization
that is defined in the data bag.

Client:
json
{
"id": "client_name",
"chef_server": {
"client_key": "public key contents",
"type": [
"client"
],
"orgs": [ "organization" ]
}
}

Note: If no organization is specified for a client, it will be added
to the default organization. The client enabled and admin settings
can be set at the top level of the chef_server hash or in and orgs
hash as in the User example.

Org:
json
{
"id": "org_name",
"full_name": "Organization Name",
"chef_server": {
"client_key": "public key contents",
"type": [
"org"
],
"enabled": true
}
}

Note: Creating the org will create a client called <org>-validator which uses the public key specified when
creating the org.

Restoring from a backup:

  • Set path to restore file with node[:chef_server_populator][:restore][:file]
  • The restore recipe is run if a restore file is set
  • The restore file can be remote or local

When enabling backups:

  • Include chef-server-populator::restore recipe
  • Set backup cron interval with node[:chef_server_populator][:schedule]
  • Optionally set a remote storage location with node[:chef_server_populator][:backup][:remote][:connection]
  • Backups include both a pg_dump of the entire chef database and a tarball of the Chef data directory

Public Key Format

The format of the public key specified with the json object needs to be a single line string with new lines
represented with the \n character

You can use one of the below commands to convert your public key file into the correct string format (credit
to the certificates cookbook for these)

cat <filename> | sed s/$/\\\\n/ | tr -d '\n'
-OR-
/usr/bin/env ruby -e 'p ARGF.read' <filename>
-OR-
perl -pe 's!(\x0d)?\x0a!\\n!g' <filename>

If you need to obtain the public key string for your private key first, then run the following on the .pem
file containing the private key

openssl rsa -in <path_to_keyfile>.pem -pubout

Extras

Need to use the IP address of the node for a bit, or another name instead of
having node[:fqdn]?

  • node[:chef_server_populator][:servername_override]

Keep chef server configured via chef client:

  • node[:chef_server_populator][:chef_server]

If the hash is non-empty, it will write the chef-server dna.json and trigger a
reconfigure when ever the attributes are updated.

Known Issues

  • As mentioned above, user and client data bag items currently only support the first organization provided. Multi-org support is forthcoming.

Examples

Take a look in the examples directory for basic bootstrap templates that will
build a new erchef server, using existing keys and client, and
register itself, or restore an existing chef server from a backup.

Info

Dependent cookbooks

chef-server >= 3.1.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

v.1.1.4

  • Fixes all users created as admins
  • Updates user creation to require explicit enabled setting
  • Updates client admin to default to false

v1.1.2

  • Adds myriad unit tests.
  • Fixes issue #23 where users were not assigned to orgs.
  • Fixes issue #22 where client recipe failed if no chef_server hash set.

v1.1.0

  • Fixes and loosens idempotency tests to account for Chef Server version differences
  • Updates Client recipe to create orgs, then users, then clients
  • Fixes non-existent org attribute in solo recipe
  • Fixes missing user keys in test suite
  • Moves common org/user/client creation specs to the spec helper
  • Refactors Backup/Restore to work with Chef 12. Uses Miasma rather than Fog.

v1.0.2

  • Org recipe only included for solo run, since client run expects data bag items.

v1.0.0

  • Updates to support Chef 12
  • Removes support for Chef 11
  • Adds support for organization creation in solo and client contexts
  • Updates backup/restore recipes for new psql path and new table & field names. (Not fully tested)
  • Replaces many knife and psql commands with native chef-server-clt management commands

v0.4.0

  • Allow for creation of clients, users, or both
  • Store backup configuration in separate JSON file
  • Provide proper retries to account for temporary server unavailability
  • Include full server restart on restore from backup
  • Provide 'latest' backup files along with named files
  • Convert backup script from template to cookbook file
  • Make service restarts more consistent

v0.3.2

  • Add client creation retries to stabilize initial bootstrap
  • Updates to example bootstrap script
  • Add support for backup/restore (thanks @luckymike!)

v0.3.0

  • Include chef-server dependency
  • Update configuration overrides for chef-server
  • Use :endpoint attribute for custom hostname/ip

v0.2.0

  • Provide distinct solo vs. client recipes
  • Client recipe configures dna.json and uses ctl for reconfigure

Foodcritic Metric 
            
1.1.4 failed this metric
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:1
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:2
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:3
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:4
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:5
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:6
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:7
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:8
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:10
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:12
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:15
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:20
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:22
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:24
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:25
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:26
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:28
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:29
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:30
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:31
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:32
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:41
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:47
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:55
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/attributes/default.rb:57
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:1
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:9
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:18
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:22
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:27
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:32
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:38
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:40
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/backups.rb:56
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:3
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:13
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:15
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:16
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:20
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:39
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:153
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:154
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:157
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:158
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:1
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:2
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:5
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:6
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:9
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:10
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:11
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:12
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:13
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:14
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:15
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:16
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:18
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:19
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:20
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:21
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:22
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:23
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:24
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/default.rb:10
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/default.rb:11
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/org.rb:3
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/org.rb:4
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/org.rb:6
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/org.rb:7
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/org.rb:28
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:2
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:3
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:5
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:9
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:12
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:13
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:15
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/restore.rb:19
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:3
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:4
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:9
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:10
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:12
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:18
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:19
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:21
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:22
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:25
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:26
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:34
FC001: Use strings in preference to symbols to access node attributes: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/templates/default/chef-server-backup.rb.erb:7
FC002: Avoid string interpolation where not required: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/client.rb:3
FC002: Avoid string interpolation where not required: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/solo.rb:9
FC019: Access node attributes in a consistent manner: /tmp/cook/6b1c8cd9f3eb19f6f78dfdcc/chef-server-populator/recipes/configurator.rb:2

Chris Roberts Chris Roberts
Heavy Water Software
Cameron Johnston
Michael Weinberg

Details

Updated May 15, 2015 Created on

Supported Platforms

    None Specified

License

All rights reserved

Download Cookbook