46 lines
18 KiB
JSON
46 lines
18 KiB
JSON
|
{
|
||
|
|
"name": "database",
|
||
|
|
"description": "Sets up the database master or slave",
|
||
|
|
"long_description": "Database Cookbook\n=================\n\nThe main highlight of this cookbook is the `database` and\n`database_user` resources for managing databases and database users in\na RDBMS. Providers for MySQL, PostgreSQL and SQL Server are also\nprovided, see usage documentation below.\n\nThis cookbook also contains recipes to configure mysql database\nmasters and slaves and uses EBS for storage, integrating together with\nthe application cookbook utilizing data bags for application related\ninformation. These recipes are written primarily to use MySQL and the\nOpscode mysql cookbook. Other RDBMS may be supported at a later date.\nThis cookbook does not automatically restore database dumps, but does\ninstall tools to help with that.\n\nRequirements\n============\n\nChef version 0.10.10+.\n\nPlatform\n--------\n\n* Debian, Ubuntu\n* Red Hat, CentOS, Scientific, Fedora, Amazon\n\nCookbooks\n---------\n\nThe following Opscode cookbooks are dependencies:\n\n* mysql\n* postgresql\n* xfs\n* aws\n\nResources/Providers\n===================\n\nThese resources aim to expose an abstraction layer for interacting\nwith different RDBMS in a general way. Currently the cookbook ships\nwith providers for MySQL, PostgreSQL and SQL Server. Please see\nspecific usage in the __Example__ sections below. The providers use\nspecific Ruby gems installed under Chef's Ruby environment to execute\ncommands and carry out actions. These gems will need to be installed\nbefore the providers can operate correctly. Specific notes for each\nRDBS flavor:\n\n- MySQL: leverages the `mysql` gem which is installed as part of the\n `mysql::ruby` recipe. You can use `database::mysql` to include this,\n too.\n- PostgreSQL: leverages the `pg` gem which is installed as part of the\n `postgresql::ruby` recipe. You can use `database::postgresql` to\n include this, too.\n Currently does not work in Chef \"omnibus\" full stack installs, see COOK-1406.\n- SQL Server: leverages the `tiny_tds` gem which is installed as part\n of the `sql_server::client` recipe.\n\n`database`\n----------\n\nManage databases in a RDBMS. Use the proper shortcut resource\ndepending on your RDBMS: `mysql_database`, `postgresql_database` or\n`sql_server_database`.\n\n### Actions\n\n- :create: create a named database\n- :drop: drop a named database\n- :query: execute an arbitrary query against a named database\n\n### Attribute Parameters\n\n- database_name: name attribute. Name of the database to interact with\n- connection: hash of connection info. valid keys include :host,\n :port, :username, :password\n- sql: string of sql or a block that executes to a string of sql,\n which will be executed against the database. used by :query action\n only\n\n### Providers\n\n- **Chef::Provider::Database::Mysql**: shortcut resource `mysql_database`\n- **Chef::Provider::Database::Postgresql**: shortcut resource `postgresql_database`\n- **Chef::Provider::Database::SqlServer**: shortcut resource `sql_server_database`\n\n### Examples\n\n # create a mysql database\n mysql_database 'oracle_rules' do\n connection ({:host => \"localhost\", :username => 'root', :password => node['mysql']['server_root_password']})\n action :create\n end\n\n # create a sql server database\n sql_server_database 'mr_softie' do\n connection ({:host => \"127.0.0.1\", :port => node['sql_server']['port'], :username => 'sa', :password => node['sql_server']['server_sa_password']})\n action :create\n end\n\n # create a postgresql database\n postgresql_database 'mr_softie' do\n connection ({:host => \"127.0.0.1\", :port => 5432, :username => 'postgres', :password => node['postgresql']['password']['postgres']})\n action :create\n end\n\n # create a postgresql database with additional parameters\n postgresql_database 'mr_softie' do\n connection ({:host => \"127.0.0.1\", :port => 5432, :username => 'postgres', :password => node['postgresql']['password']['postgres']})\n template 'DEFAULT'\n encoding 'DEFAULT'\n tablespace 'DEFAULT'\n conn
|
||
|
|
"maintainer": "Opscode, Inc.",
|
||
|
|
"maintainer_email": "cookbooks@opscode.com",
|
||
|
|
"license": "Apache 2.0",
|
||
|
|
"platforms": {
|
||
|
|
"debian": ">= 0.0.0",
|
||
|
|
"ubuntu": ">= 0.0.0",
|
||
|
|
"centos": ">= 0.0.0",
|
||
|
|
"suse": ">= 0.0.0",
|
||
|
|
"fedora": ">= 0.0.0",
|
||
|
|
"redhat": ">= 0.0.0",
|
||
|
|
"scientific": ">= 0.0.0",
|
||
|
|
"amazon": ">= 0.0.0"
|
||
|
|
},
|
||
|
|
"dependencies": {
|
||
|
|
"mysql": ">= 1.3.0",
|
||
|
|
"postgresql": ">= 1.0.0",
|
||
|
|
"aws": ">= 0.0.0",
|
||
|
|
"xfs": ">= 0.0.0"
|
||
|
|
},
|
||
|
|
"recommendations": {
|
||
|
|
},
|
||
|
|
"suggestions": {
|
||
|
|
},
|
||
|
|
"conflicting": {
|
||
|
|
},
|
||
|
|
"providing": {
|
||
|
|
},
|
||
|
|
"replacing": {
|
||
|
|
},
|
||
|
|
"attributes": {
|
||
|
|
},
|
||
|
|
"groupings": {
|
||
|
|
},
|
||
|
|
"recipes": {
|
||
|
|
"database": "Empty placeholder",
|
||
|
|
"database::ebs_backup": "Considered deprecated, older way of backing up EBS volumes",
|
||
|
|
"database::ebs_volume": "Sets up an EBS volume in EC2 for the database",
|
||
|
|
"database::master": "Creates application specific user and database",
|
||
|
|
"database::snapshot": "Locks tables and freezes XFS filesystem for replication, assumes EC2 + EBS"
|
||
|
|
},
|
||
|
|
"version": "1.3.12"
|
||
|
|
}
|