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.

Select Badges

Select Supported Platforms

Select Status

RSS

confluence (44) Versions 1.0.0

Installs/Configures Atlassian Confluence

Policyfile
Berkshelf
Knife
cookbook 'confluence', '= 1.0.0', :supermarket
cookbook 'confluence', '= 1.0.0'
knife supermarket install confluence
knife supermarket download confluence
README
Dependencies
Changelog
Quality 0%

chef-confluence Build Status

Description

Installs/Configures Atlassian Confluence server. Please see [COMPATIBILITY.md](COMPATIBILITY.md) for more information about Confluence releases that are tested and supported by this cookbook and its versions.

Requirements

Platforms

  • CentOS 6.3
  • RedHat 6.3
  • Ubuntu 12.04

Databases

  • MySQL
  • Postgres

Cookbooks

Required Opscode Cookbooks

Required Third-Party Cookbooks

Suggested Opscode Cookbooks

JDK/JRE

The Atlassian Confluence Linux installer will automatically configure a bundled JRE. If you wish to use your own JDK/JRE, with say the java cookbook, then as of this writing it must be Oracle and version 1.6/1.7 (Supported Platforms)

Necessary configuration with java cookbook:
* node['java']['install_flavor'] = "oracle"
* node['java']['oracle']['accept_oracle_download_terms'] = true
* recipe[java]

Attributes

These attributes are under the node['confluence'] namespace.

Attribute Description Type Default
arch architecture for Confluence installer - "x64" or "x32" String auto-detected (see attributes/default.rb)
checksum SHA256 checksum for Confluence install String auto-detected (see attributes/default.rb)
home_path home directory for Confluence user String /home/#{node['confluence']['user']}
install_path location to install Confluence String /opt/atlassian-confluence
install_type Confluence install type - "cluster-standalone", "cluster-war", "installer", "standalone", "war" String installer
url_base URL base for Confluence install String http://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence
url URL for Confluence install String auto-detected (see attributes/default.rb)
user user running Confluence String confluence
version Confluence version to install String 4.3.7

Confluence Database Attributes

All of these node['confluence']['database'] attributes are overridden by confluence/confluence encrypted data bag (Hosted Chef) or data bag (Chef Solo), if it exists

Attribute Description Type Default
host FQDN or "localhost" (localhost automatically installs ['database']['type'] server) String localhost
name Confluence database name String confluence
password Confluence database user password String changeit
port Confluence database port Fixnum 3306
type Confluence database type - "mysql" or "postgresql" String mysql
user Confluence database user String confluence

Confluence JVM Attributes

These attributes are under the node['confluence']['jvm'] namespace.

Attribute Description Type Default
minimum_memory JVM minimum memory String 512m
maximum_memory JVM maximum memory String 768m
maximum_permgen JVM maximum PermGen memory String 256m
java_opts additional JAVA_OPTS to be passed to Confluence JVM during startup String ""

Confluence Tomcat Attributes

These attributes are under the node['confluence']['tomcat'] namespace.

Any node['confluence']['tomcat']['key*'] attributes are overridden by confluence/confluence encrypted data bag (Hosted Chef) or data bag (Chef Solo), if it exists

Attribute Description Type Default
keyAlias Tomcat SSL keystore alias String tomcat
keystoreFile Tomcat SSL keystore file - will automatically generate self-signed keystore file if left as default String #{node['confluence']['home_path']}/.keystore
keystorePass Tomcat SSL keystore passphrase String changeit
port Tomcat HTTP port Fixnum 8090
ssl_port Tomcat HTTPS port Fixnum 8443

Recipes

  • recipe[confluence] Installs/configures Atlassian Confluence
  • recipe[confluence::apache2] Installs/configures Apache 2 as proxy (ports 80/443)
  • recipe[confluence::database] Installs/configures MySQL/Postgres server, database, and user for Confluence
  • recipe[confluence::linux_cluster-standalone] Installs/configures Confluence Cluster via Linux standalone archive"
  • recipe[confluence::linux_cluster-war] Deploys Confluence Cluster WAR on Linux"
  • recipe[confluence::linux_installer] Installs/configures Confluence via Linux installer"
  • recipe[confluence::linux_standalone] Installs/configures Confluence via Linux standalone archive"
  • recipe[confluence::linux_war] Deploys Confluence WAR on Linux"
  • recipe[confluence::tomcat_configuration] Configures Confluence's built-in Tomcat
  • recipe[confluence::windows_cluster-standalone] Installs/configures Confluence Cluster via Windows standalone archive"
  • recipe[confluence::windows_cluster-war] Deploys Confluence Cluster WAR on Windows"
  • recipe[confluence::windows_installer] Installs/configures Confluence via Windows installer"
  • recipe[confluence::windows_standalone] Installs/configures Confluence via Windows standalone archive"
  • recipe[confluence::windows_war] Deploys Confluence WAR on Windows"

Usage

Confluence Server Data Bag

For securely overriding attributes on Hosted Chef, create a confluence/confluence encrypted data bag with the model below. Chef Solo can override the same attributes with a confluence/confluence unencrypted data bag of the same information.

required:
* ['database']['type'] "mysql" or "postgresql"
* ['database']['host'] FQDN or "localhost" (localhost automatically
installs ['database']['type'] server)
* ['database']['name'] Name of Confluence database
* ['database']['user'] Confluence database username
* ['database']['password'] Confluence database username password

optional:
* ['database']['port'] Database port, standard database port for
['database']['type']
* ['tomcat']['keyAlias'] Tomcat HTTPS Java Keystore keyAlias, defaults to self-signed certifcate
* ['tomcat']['keystoreFile'] Tomcat HTTPS Java Keystore keystoreFile, self-signed certificate
* ['tomcat']['keystorePass'] Tomcat HTTPS Java Keystore keystorePass, self-signed certificate

Repeat for other Chef environments as necessary. Example:

{
  "id": "confluence"
  "development": {
    "database": {
      "type": "postgresql",
      "host": "localhost",
      "name": "confluence",
      "user": "confluence",
      "password": "confluence_db_password",
    },
    "tomcat": {
      "keyAlias": "not_tomcat",
      "keystoreFile": "/etc/pki/java/wildcard_cert.jks",
      "keystorePass": "not_changeit"
    }
  }
}

Confluence Server Installation

The simplest method is via the default recipe, which uses node['confluence']['install_type'] to determine best method.

  • Optionally (un)encrypted data bag or set attributes
    • knife data bag create confluence
    • knife data bag edit confluence confluence --secret-file=path/to/secret
  • Add recipe[confluence] to your node's run list.

Custom Confluence Configurations

Using individual recipes, you can use this cookbook to configure Confluence to fit your environment.

  • Optionally (un)encrypted data bag or set attributes
    • knife data bag create confluence
    • knife data bag edit confluence confluence --secret-file=path/to/secret
  • Add individual recipes to your node's run list.

Testing and Development

Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant and Berkshelf.

gem install bundler --no-ri --no-rdoc
git clone git://github.com/bflad/chef-confluence.git
cd chef-confluence
bundle install
bundle exec vagrant up BOX # BOX being centos6 or ubuntu1204

You may need to add the following hosts entries:

  • 33.33.33.10 confluence-centos-6
  • 33.33.33.11 confluence-ubuntu-1204

The running Confluence server is accessible from the host machine:

CentOS 6 Box:
* Web UI: https://33.33.33.10/

Ubuntu 12.04 Box:
* Web UI: https://33.33.33.11/

You can then SSH into the running VM using the vagrant ssh command.
The VM can easily be stopped and deleted with the vagrant destroy
command. Please see the official Vagrant documentation
for a more in depth explanation of available commands.

Contributing

Please use standard Github issues/pull requests and if possible, in combination with testing on the Vagrant boxes.

License and Author

Author:: Brian Flad (bflad@wharton.upenn.edu)

Copyright:: 2013

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

apache2 >= 0.0.0
database >= 0.0.0
mysql >= 0.0.0
mysql_connector >= 0.0.0
postgresql >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

v1.0.0

  • Production ready with Linux installer/standalone installs
  • Split out individual recipes for installation and configuration
  • Default recipe now includes Apache 2 proxy
  • Built-in checksum handling
  • Moved apache2 attributes into default attributes

v0.1.0

  • Initial beta release

Foodcritic Metric
            

1.0.0 failed this metric

FC031: Cookbook without metadata file: /tmp/cook/8ef18dc3834c53faa46161b6/confluence/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/8ef18dc3834c53faa46161b6/confluence/metadata.rb:1