47 lines
18 KiB
JSON
47 lines
18 KiB
JSON
|
{
|
||
|
|
"name": "postgresql",
|
||
|
|
"description": "Installs and configures postgresql for clients or servers",
|
||
|
|
"long_description": "Description\n===========\n\nInstalls and configures PostgreSQL as a client or a server.\n\nRequirements\n============\n\n## Platforms\n\n* Debian, Ubuntu\n* Red Hat/CentOS/Scientific (6.0+ required) - \"EL6-family\"\n* Fedora\n* SUSE\n\nTested on:\n\n* Ubuntu 10.04, 11.10, 12.04\n* Red Hat 6.1, Scientific 6.1, CentOS 6.3\n\n## Cookbooks\n\nRequires Opscode's `openssl` cookbook for secure password generation.\n\nRequires a C compiler and development headers in order to build the\n`pg` RubyGem to provide Ruby bindings in the `ruby` recipe.\n\nOpscode's `build-essential` cookbook provides this functionality on\nDebian, Ubuntu, and EL6-family.\n\nWhile not required, Opscode's `database` cookbook contains resources\nand providers that can interact with a PostgreSQL database. This\ncookbook is a dependency of database.\n\nAttributes\n==========\n\nThe following attributes are set based on the platform, see the\n`attributes/default.rb` file for default values.\n\n* `node['postgresql']['version']` - version of postgresql to manage\n* `node['postgresql']['dir']` - home directory of where postgresql\n data and configuration lives.\n\n* `node['postgresql']['client']['packages']` - An array of package names\n that should be installed on \"client\" systems.\n* `node['postgresql']['server']['packages']` - An array of package names\n that should be installed on \"server\" systems.\n* `node['postgresql']['contrib']['packages']` - An array of package names\n that could be installed on \"server\" systems for useful sysadmin tools.\n\n* `node['postgresql']['enable_pgdg_apt']` - Whether to enable the apt repo\n by the PostgreSQL Global Development Group, which contains newer versions\n of PostgreSQL.\n\n* `node['postgresql']['enable_pgdg_yum']` - Whether to enable the yum repo\n by the PostgreSQL Global Development Group, which contains newer versions\n of PostgreSQL.\n\nThe following attributes are generated in\n`recipe[postgresql::server]`.\n\n* `node['postgresql']['password']['postgres']` - randomly generated\n password by the `openssl` cookbook's library.\n (TODO: This is broken, as it disables the password.)\n\nConfiguration\n-------------\n\nThe `postgresql.conf` and `pg_hba.conf` files are dynamically\ngenerated from attributes. Each key in `node['postgresql']['config']`\nis a postgresql configuration directive, and will be rendered in the\nconfig file. For example, the attribute:\n\n node['postgresql']['config']['listen_address'] = 'localhost'\n\nWill result in the following line in the `postgresql.conf` file:\n\n listen_address = 'localhost'\n\nThe attributes file contains default values for Debian and RHEL\nplatform families (per the `node['platform_family']`). These defaults\nhave disparity between the platforms because they were originally\nextracted from the postgresql.conf files in the previous version of\nthis cookbook, which differed in their default config. The resulting\nconfiguration files will be the same as before, but the content will\nbe dynamically rendered from the attributes. The helpful commentary\nwill no longer be present. You should consult the PostgreSQL\ndocumentation for specific configuration details.\n\nSee __Recipes__ `config_initdb` and `config_pgtune` below to\nauto-generate many postgresql.conf settings.\n\nFor values that are \"on\" or \"off\", they should be specified as literal\n`true` or `false`. String values will be used with single quotes. Any\nconfiguration option set to the literal `nil` will be skipped\nentirely. All other values (e.g., numeric literals) will be used as\nis. So for example:\n\n node.default['postgresql']['config']['logging_collector'] = true\n node.default['postgresql']['config']['datestyle'] = 'iso, mdy'\n node.default['postgresql']['config']['ident_file'] = nil\n node.default['postgresql']['config']['port] = 5432\n\nWill result in the following config lines:\n\n logging_collector = 'on'\n datestyle = 'iso,mdy'\n port = 5432\n\n(no line printed for `ident_file` as it is `nil`)\n\nThe `pg_hba.conf` file is dynamical
|
||
|
|
"maintainer": "Opscode, Inc.",
|
||
|
|
"maintainer_email": "cookbooks@opscode.com",
|
||
|
|
"license": "Apache 2.0",
|
||
|
|
"platforms": {
|
||
|
|
"ubuntu": ">= 0.0.0",
|
||
|
|
"debian": ">= 0.0.0",
|
||
|
|
"fedora": ">= 0.0.0",
|
||
|
|
"suse": ">= 0.0.0",
|
||
|
|
"amazon": ">= 0.0.0",
|
||
|
|
"redhat": ">= 6.0",
|
||
|
|
"centos": ">= 6.0",
|
||
|
|
"scientific": ">= 6.0",
|
||
|
|
"oracle": ">= 6.0"
|
||
|
|
},
|
||
|
|
"dependencies": {
|
||
|
|
"apt": ">= 0.0.0",
|
||
|
|
"build-essential": ">= 0.0.0",
|
||
|
|
"openssl": ">= 0.0.0"
|
||
|
|
},
|
||
|
|
"recommendations": {
|
||
|
|
},
|
||
|
|
"suggestions": {
|
||
|
|
},
|
||
|
|
"conflicting": {
|
||
|
|
},
|
||
|
|
"providing": {
|
||
|
|
},
|
||
|
|
"replacing": {
|
||
|
|
},
|
||
|
|
"attributes": {
|
||
|
|
},
|
||
|
|
"groupings": {
|
||
|
|
},
|
||
|
|
"recipes": {
|
||
|
|
"postgresql": "Includes postgresql::client",
|
||
|
|
"postgresql::ruby": "Installs pg gem for Ruby bindings",
|
||
|
|
"postgresql::client": "Installs postgresql client package(s)",
|
||
|
|
"postgresql::server": "Installs postgresql server packages, templates",
|
||
|
|
"postgresql::server_redhat": "Installs postgresql server packages, redhat family style",
|
||
|
|
"postgresql::server_debian": "Installs postgresql server packages, debian family style"
|
||
|
|
},
|
||
|
|
"version": "3.0.0"
|
||
|
|
}
|