cookbook 'kloudspeaker', '~> 0.2.1'
kloudspeaker (3) Versions 0.2.1 Follow0
Installs and configures Kloudspeaker
cookbook 'kloudspeaker', '~> 0.2.1', :supermarket
knife supermarket install kloudspeaker
knife supermarket download kloudspeaker
Kloudspeaker Cookbook
Installs and configures Kloudspeaker, the feature-rich document management and sharing platform.
Requirements
This cookbook has been tested on:
- CentOS 7
- Chef 12.6
Usage
kloudspeaker::default
Installs Kloudspeaker, served by nginx and MariaDB. For more fine-grained control, you may pick from the recipes below instead.
kloudspeaker::application
Downloads the Kloudspeaker zip and installs it using the ark cookbook, under /var/www/kloudspeaker
by default. It creates an index.html
file based on attributes under node['kloudspeaker']['client']
. It then creates a configuration.php
file based on attributes under node['kloudspeaker']['configuration']
.
If you wish to host your database on a different node then set the db
attributes on that node instead, with the exception of host
, which should be set on the application node. The application node will source the db
attributes through a Chef search using the FQDN specified in host
. You should therefore set up the database node first.
kloudspeaker::database
Creates a database with a dedicated user on your chosen backend. MySQL and PostgreSQL are currently supported by this recipe. A password for the user is randomly generated and saved to an attribute.
kloudspeaker::mariadb
Installs the MariaDB server, as well as the Ruby gem needed to create the database and user in the database recipe above. Certain db
attributes are also prefilled appropriately.
Remember that the mariadb cookbook sets a blank root password by default so be sure to change it.
kloudspeaker::php
Installs PHP-FPM, as well as some required PHP extensions, including the relevant extension for your chosen database backend. To have it select the right backend automatically, execute the mariadb recipe first. This recipe is called by the nginx recipe below.
kloudspeaker::nginx
Installs and configures nginx to point to the PHP-FPM pool set up by the recipe above.
kloudspeaker::webdav
Downloads the Kloudspeaker WebDAV plugin zip and installs it using the ark cookbook, under /var/www/kloudspeaker/backend/dav
by default. It creates an index.php
file based on attributes under node['kloudspeaker']['webdav']['configuration']
. The WebDAV URL defaults to /backend/dav
but you can change the BASE_URI
attribute to something more convenient like /dav/
; don't forget the trailing slash here!
TODO
- Support more of the additional downloadable plugins
- mysql recipe (for using MySQL instead of MariaDB)
- postgresql recipe (does Kloudspeaker really support PostgreSQL?)
- apache recipe (for using Apache httpd instead of nginx)
Contributing
You know what to do. ;)
License and Authors
- Author:: James Le Cuirot (james.le-cuirot@yakara.com)
# Copyright (C) 2015-2016 Yakara Ltd # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License.
Dependent cookbooks
ark >= 0.0.0 |
database >= 0.0.0 |
mariadb >= 0.0.0 |
mysql2_chef_gem >= 0.0.0 |
chef_nginx >= 0.0.0 |
php-fpm >= 0.0.0 |
selinux_policy >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
0.2.1 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.2.1 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
0.2.1 failed this metric
FC064: Ensure issues_url is set in metadata: kloudspeaker/metadata.rb:1
FC065: Ensure source_url is set in metadata: kloudspeaker/metadata.rb:1
FC066: Ensure chef_version is set in metadata: kloudspeaker/metadata.rb:1
FC069: Ensure standardized license defined in metadata: kloudspeaker/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.2.1 passed this metric
Testing File Metric
0.2.1 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
0.2.1 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
0.2.1 failed this metric
0.2.1 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
0.2.1 failed this metric
FC064: Ensure issues_url is set in metadata: kloudspeaker/metadata.rb:1
FC065: Ensure source_url is set in metadata: kloudspeaker/metadata.rb:1
FC066: Ensure chef_version is set in metadata: kloudspeaker/metadata.rb:1
FC069: Ensure standardized license defined in metadata: kloudspeaker/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.2.1 passed this metric
Testing File Metric
0.2.1 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
0.2.1 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
0.2.1 failed this metric
FC065: Ensure source_url is set in metadata: kloudspeaker/metadata.rb:1
FC066: Ensure chef_version is set in metadata: kloudspeaker/metadata.rb:1
FC069: Ensure standardized license defined in metadata: kloudspeaker/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
0.2.1 passed this metric
Testing File Metric
0.2.1 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
0.2.1 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
0.2.1 failed this metric
0.2.1 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