metadata.json

{
  "name": "users",
  "description": "Creates users from a databag search",
  "long_description": "Description\n===========\n\nCreates users from a databag search.\n\nRequirements\n============\n\nPlatform\n--------\n\n* Debian, Ubuntu\n* CentOS, Red Hat, Fedora\n* FreeBSD\n\nData bag named \"users\" must exist. See USAGE.\n\nUsage\n=====\n\nThis cookbook is specific for setting up sysadmin group and users for now.\n\n    include_recipe \"users::sysadmins\"\n\nUse knife to create a data bag for users.\n\n    knife data bag create users\n\nCreate a user.\n\n    knife data bag users bofh\n    {\n      \"id\": \"bofh\",\n      \"ssh_keys\": \"ssh-rsa AAAAB3Nz...yhCw== bofh\",\n      \"groups\": \"sysadmin\",\n      \"uid\": 2001,\n      \"shell\": \"\\/bin\\/bash\",\n      \"comment\": \"BOFH\",\n      \"nagios\": {\n        \"pager\": \"8005551212@txt.att.net\",\n        \"email\": \"bofh@example.com\"\n      },\n      \"openid\": \"bofh.myopenid.com\"\n    }\n\nThe latest version of knife supports reading data bags from a file and automatically looks in a directory called +data_bags+ in the current directory. The \"bag\" should be a directory with JSON files of each item. For the above:\n\n    mkdir data_bags/users\n    $EDITOR data_bags/users/bofh.json\n\nPaste the user's public SSH key into the ssh_keys value. Also make sure the uid is unique, and if you're not using bash, that the shell is installed. Group must be sysadmin.\n\nThe recipe will also create the sysadmin group. If you're using the opscode sudo cookbook, they'll have sudo access in the default site-cookbooks template. They won't have passwords though, so the sudo cookbook's template needs to be adjusted so the sysadmin group has NOPASSWD.\n\nThe sysadmin group will be created with GID 2300. This may become an attribute at a later date.\n\nThe Apache cookbook can set up authentication using OpenIDs, which is set up using the openid key here. See the Opscode 'apache2' cookbook for more information about this.\n\nLicense and Author\n==================\n\nAuthor:: Joshua Timberman (<joshua@opscode.com>)\nAuthor:: Seth Chisamore (<schisamo@opscode.com>)\n\nCopyright:: 2009-2011, Opscode, Inc\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n",
  "maintainer": "Opscode, Inc.",
  "maintainer_email": "cookbooks@opscode.com",
  "license": "Apache 2.0",
  "platforms": {
    "ubuntu": ">= 0.0.0",
    "debian": ">= 0.0.0",
    "redhat": ">= 0.0.0",
    "centos": ">= 0.0.0",
    "fedora": ">= 0.0.0",
    "freebsd": ">= 0.0.0"
  },
  "dependencies": {
  },
  "recommendations": {
  },
  "suggestions": {
  },
  "conflicting": {
  },
  "providing": {
  },
  "replacing": {
  },
  "attributes": {
  },
  "groupings": {
  },
  "recipes": {
    "users::sysadmin": "searches users data bag for sysadmins and creates users"
  },
  "version": "1.0.0"
}