Skip to content
Sous Chefs confluence Cookbook
Branch: master
Clone or download
Xorima and damacus Readme Maintainers (#177)
This commit adds information about us, the maintainers, and how to contact us on slack/ our website
Latest commit d2ef431 May 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Add CircleCI and Danger (#165) Oct 15, 2018
.delivery Add CircleCI and Danger (#165) Oct 15, 2018
.github Add/update codeowners to use github teams (#167) Dec 12, 2018
attributes set default version to 6.2.0 May 31, 2017
libraries Change Log update (#173) Mar 11, 2019
recipes Add workaround for https://jira.atlassian.com/browse/CONF-35722 (#148) Feb 23, 2017
spec Change Log update (#173) Mar 11, 2019
templates/default Add workaround for https://jira.atlassian.com/browse/CONF-35722 (#148) Feb 23, 2017
test
.foodcritic fix according to style checks Jul 12, 2017
.gitignore Add "vendor" dir to .gitignore Aug 14, 2015
.kitchen.digitalocean.yml Add kitchen-sync to allow faster rysnc transport. Jan 21, 2016
.kitchen.docker.yml
.kitchen.yml avoid Chef Client 13 for now Apr 5, 2017
.rubocop.yml Add CircleCI and Danger (#165) Oct 15, 2018
Berksfile Berksfile: Add temporary lock for "postgresql" cookbook version Jan 2, 2017
CHANGELOG.md Change Log update (#173) Mar 11, 2019
CONTRIBUTING.md Update contribution and testing guidelines according to Chef Software… Nov 18, 2015
Dangerfile Standardise Danger (#176) May 10, 2019
Gemfile Update testing configuration Dec 26, 2016
LICENSE Add LICENSE file Dec 9, 2013
README.md Readme Maintainers (#177) May 14, 2019
TESTING.md Update testing instructions Jan 24, 2017
chefignore Update chefignore Aug 5, 2016
metadata.rb Update metadata.rb (#171) Mar 5, 2019

README.md

Confluence Cookbook

Cookbook Version Build Status OpenCollective OpenCollective License

Description

Installs/Configures an instance of Atlassian Confluence.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

  • RHEL/CentOS 6, 7
  • Ubuntu 14.04, 16.04

Cookbooks

JDK/JRE

The Atlassian Confluence Linux installer will automatically configure a bundled JRE.

If you prefer Confluence standalone installation, then you have to manage JDK/JRE 8 (Supported Platforms) on this node. It can be done with java cookbook and appropricate attributes:

node.default['java']['jdk_version'] = "8"
include_recipe 'java'

Attributes

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

Attribute Description Type Default
checksum SHA256 checksum for Confluence install String auto-detected by library method
home_path home directory for Confluence user String /var/atlassian/application-data/confluence
install_path location to install Confluence String /opt/atlassian/confluence
install_type Confluence install type - "installer", "standalone" String installer
url URL for Confluence install String auto-detected by library method
user user running Confluence String confluence
version Confluence version to install String 6.1.2

--Notice:-- If ['confluence']['install_type'] is set to installer, then the installer will try to upgrade your Confluence instance located in ['confluence']['install_path'] (if it exists) to the ['confluence']['version'].

If you want to avoid an unexpected upgrade, just set or override ['confluence']['version'] attribute value to that of your current confluence version.

Confluence Database Attributes

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

Attribute Description Type Default
host FQDN or IP of database server ("127.0.0.1" automatically installs ['database']['type'] server) String "127.0.0.1"
name Confluence database name String confluence
password Confluence database user password String changeit
port Confluence database port Fixnum 3306 for MySQL, 5432 for PostgreSQL
type Confluence database type - "mysql", "postgresql", or "hsqldb" 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 ""
bundled_jre prefer JRE bundled with linux installer Boolean true

Confluence Autotune Attributes

These attributes are under the node['confluence']['autotune'] namespace. Autotune automatically determines appropriate settings for certain attributes. This feature is inspired by the autotune recipe in the https://github.com/afklm/jira cookbook. This initial version only supports JVM min and max memory size tuning.

There are several tuning types that can be set:

  • 'mixed' - Confluence and DB run on the same system
  • 'dedicated' - Confluence has the system all to itself
  • 'shared' - Confluence shares the system with the DB and other applications

Total available memory is auto discovered using Ohai but can be overridden by setting your own value in kB.

Attribute Description Type Default
enabled Whether or not to autotune settings. Boolean false
type Type of tuning to apply. One of 'mixed', 'dedicated' and 'shared'. String mixed
total_memory Total system memory to use for autotune calculations. String Ohai value

Confluence Tomcat Attributes

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

Attribute Description Type Default
port Tomcat HTTP port Fixnum 8090

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_installer] Installs/configures Confluence via Linux installer"
  • recipe[confluence::linux_standalone] Installs/configures Confluence via Linux standalone archive"
  • recipe[confluence::tomcat_configuration] Configures Confluence's built-in Tomcat
  • recipe[confluence::crowd_sso] Configures user authentication with Crowd single sign-on

Usage

Confluence Data Bag

For security purposes it is recommended to use data bag for storing secrets like passwords and database credentials.

You can override any attributes from the ['confluence'] namespace using the confluence/confluence data bag. It could be either encrypted or not encrypted by your choice.

Example:

{
  "id": "confluence",
  "confluence": {
    "database": {
      "type": "postgresql",
      "name": "confluence_db",
      "user": "confluence_user",
      "password": "confluence_db_password"
    }
  }
}

(Note - "confluence" nesting level is required!)

These credentials will be used for your Confluence installation instead of appropriate attribute values.

Data bag's and item's names are optional and can be changed by overriding attributes ['confluence']['data_bag_name'] and ['confluence']['data_bag_item']

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.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

https://opencollective.com/sous-chefs#backers

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

https://opencollective.com/sous-chefs/sponsor/0/website https://opencollective.com/sous-chefs/sponsor/1/website https://opencollective.com/sous-chefs/sponsor/2/website https://opencollective.com/sous-chefs/sponsor/3/website https://opencollective.com/sous-chefs/sponsor/4/website https://opencollective.com/sous-chefs/sponsor/5/website https://opencollective.com/sous-chefs/sponsor/6/website https://opencollective.com/sous-chefs/sponsor/7/website https://opencollective.com/sous-chefs/sponsor/8/website https://opencollective.com/sous-chefs/sponsor/9/website

You can’t perform that action at this time.