cookbook 'bamboo', '= 2.0.6'
bamboo
(33) Versions
2.0.6
-
Follow11
Installs and configures Bamboo
cookbook 'bamboo', '= 2.0.6', :supermarket
knife supermarket install bamboo
knife supermarket download bamboo
Bamboo status
Description
Installs/Configures Atlassian Bamboo
Usage
Bamboo Server Installation
- Add
recipe[bamboo]
to your node's run list.
Bamboo Agent Installation
- Add
recipe[bamboo::agent]
to your node's run list.
Recipes
- recipe "bamboo::default", "Installs the bamboo server with optional backup in place and logging to graylog."
- recipe "bamboo::server", "Only installs the bamboo server."
- recipe "bamboo::database", "Only installs the bamboo database."
- recipe "bamboo::agent", "Installs a bamboo agent."
Requirements
Platforms
- CentOS 6.x
- Mac OS X 10.10
- Ubuntu >= 14.04
Databases
- MySQL
- Postgres
Cookbook dependencies
Required Opscode Cookbooks
Third-Party Cookbooks
- mysql_connector (if using MySQL database)
- backup (if using backup)
Bamboo attributes
These attributes are under the node['bamboo']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
url | Url for your bamboo installation | String | http://localhost |
home_dir | Bamboo install directory | String | /opt/bamboo |
data_dir | Bamboo data directory | String | /var/bamboo |
user | user to run Bamboo | String | bamboo |
group | group for user bamboo | String | bamboo |
user_home | home dir for user bamboo | String | /home/bamboo |
version | Bamboo version to install | String | 5.3 |
download_url | URL for Bamboo install | String | auto-detected (see attributes/default.rb) |
checksum | SHA256 checksum for Bamboo install | String | auto-detected (see attributes/default.rb) |
Bamboo agent attributes
These attributes are under the node['bamboo']['agent']
namespace. Agents attributes can be different than the server attributes.
Attribute | Description | Type | Default |
---|---|---|---|
home_dir | Bamboo install directory | String | /opt/bamboo |
data_dir | Bamboo data directory | String | /var/bamboo |
user | user to run Bamboo | String | bamboo |
group | group for user bamboo | String | bamboo |
user_home | home dir for user bamboo | String | /home/bamboo |
ping_timeout | timeout until wrapper restarts unresponsive JVM | Integer | 30 |
disable_agent_auto_capability_detection | sets the flag on the agent | String | true |
additional_path | will be added to the $PATH of the agent process | String |
These attributes are under the node['bamboo']['agent']['monit']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
template_cookbook | cookbook loc of monitrc template | String | bamboo |
template_source | template file name for monitrc | String | procfile.monitrc.erb |
These attributes are under the node['bamboo']['agent']['wrapper']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
java_additionals | additional java args | Array |
Bamboo Apache2 Attributes
Apache2 is used default as reverse proxy
These attributes are under the node['bamboo']['apache']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
access_log | acces log location | String | '' |
error_log | error log location | String | '' |
port | port | Integer | 80 |
template_cookbook | from which cookbook to take the template | String | bamboo |
virtual_host_name | vhost | String | '' |
virtual_host_alias | vhost alias | String | '' |
error_docs | custom error docs | String | '' |
Bamboo Apache2 SSL
These attributes are under the node['bamboo']['apache']['ssl']
namespace.
access_log | ssl access log | String | ''
error_log | ssl access log | String | ''
chain_file | chain file | String | ''
port | port | Integer | 443
certificate_file | cert file to use | String | localhost.crt for rhel, ssl-cert-snakeoil.pem for ubuntu
key_file | key file to use | String | localhost.key for rhel, ssl-cert-snakeoil.key for ubuntu
Bamboo Database Attributes
These attributes are under the node['bamboo']['database']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
type | Bamboo database type | String | mysql (no other database supported atm) |
host | FQDN or "127.0.0.1" (localhost automatically installs ['database']['type'] server) |
String | localhost |
name | Bamboo database name | String | Bamboo |
password | Bamboo database user password | String | changeit |
port | Bamboo database port | Fixnum | 3306 for MySQL, 5432 for PostgreSQL |
type | Bamboo database type eg postgresql or mysql | String | postgresql |
user | Bamboo database user | String | Bamboo |
Bamboo JVM Attributes
These attributes are under the node['bamboo']['jvm']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
minimum_memory | JVM minimum memory | String | 512m |
maximum_memory | JVM maximum memory | String | 2G |
support_args | additional JAVA_OPTS recommended by Atlassian support for Bamboo JVM during startup | String | "" |
Bamboo Crowd Attributes
These attributes are under the node['bamboo']['crowd']
namespace.
For initial setup first run without crowd enabled, run the setup process and activate crowd via the webui
Attribute | Description | Type | Default |
---|---|---|---|
enabled | enables crowd sso | Boolean | false |
Bamboo Error Docs Attributes
Attribute | Description | Type | Default |
---|---|---|---|
error_docs | Provide custom error docs | Array | e503 - empty |
Bamboo Backup Attributes
These attributes are under the node['bamboo']['backup']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
enabled | Enable backup to s3 True/False yes/no | String | false |
ceph | Enable if you use ceph True/False yes/no | String | false |
s3_host | your bucket in S3 | String | s3.amazonaws.com |
s3_scheme | your bucket in S3 | String | http |
s3_port | your bucket in S3 | String | 80 |
s3_access_key_id | Your acces key for S3 | String | changeit |
s3_secret_access_key | Your secret key for S3 | String | changeit |
s3_bucket | your bucket in S3 | String | bamboo |
Code Deployment From Bamboo
Testing and Development
Here's how you can quickly get testing or developing against the cookbook thanks to Test-Kitchen and Berkshelf.
git clone git://github.com/ramonskie/bamboo.git
cd bamboo
see [TESTING.md](TESTING.md)
The running Bamboo server is accessible from the host machine:
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.
Test Kitchen
Please see documentation in: [TESTING.md](TESTING.md)
Contributing
Please use standard Github issues/pull requests and if possible, in combination with testing on the Vagrant boxes.
License and Contributors
Please see license information in: [LICENSE](LICENSE)
- ramonskie (ramonmakkelie@gmail.com)
- soudmaijer (soudmaijer@gmail.com)
- mvdkleijn (martijn.niji@gmail.com)
Dependent cookbooks
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Bamboo Cookbook Changelog
This file is used to list changes made in each version of the bamboo cookbook.
v2.0.6 (January 13, 2017)
Improvements:
- Unlimited wrapper java additionals config via attributes
- Add version 5.14.4.1
v2.0.5 (January 10, 2017)
Fixes:
- Make sure additional_path is in PATH for systemd and initd systems
v2.0.4 (January 10, 2017)
Fixes:
- Make sure additional_path is in PATH via systemd unit file
v2.0.3 (January 4, 2017)
Improvements:
- Make bamboo agent monitrc cookbook loc and template configurable via attributes
v2.0.2 (December 20, 2016)
Fixes:
- Pin apache 3.2.1 due to issue 422 in 3.2.2
v2.0.1 (December 20, 2016)
Fixes:
- Crowd can be configured within the ui, only sso enable disable as was before
- Fix pid file loc
- Update readme
v2.0.0 (December 15, 2016)
BACKWARDS INCOMPATIBILITIES:
- Drop support of ubuntu < 14.04 LTS
- Only support https
- Only support jdk8 (Atlassian Bamboo requirement) removed permgem option
- Drop graylog support (if needed implement it via a wrapper cookbook)
Improvements:
- Support of systemd for Bamboo server and agent
- Update .gitignore
- Rubocop fixes
- Introducing helpers
- Use monit cookbook instead of package
- Full crowd sso configuration
- Fix ssl issue with openjdk on ubuntu 14.04 LTS
- Select mysql 5.6 as minimum (Atlassian Bamboo requirement)
- Introduce this Changelog
- Change attribute style
- Consistancy in templates
Collaborator Number Metric
2.0.6 passed this metric
Contributing File Metric
2.0.6 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 http://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.6 failed this metric
FC066: Ensure chef_version is set in metadata: bamboo/metadata.rb:1
FC069: Ensure standardized license defined in metadata: bamboo/metadata.rb:1
Run with Foodcritic Version 10.3.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
License Metric
2.0.6 passed this metric
No Binaries Metric
2.0.6 passed this metric
Testing File Metric
2.0.6 passed this metric
Version Tag Metric
2.0.6 passed this metric
2.0.6 passed this metric
2.0.6 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 http://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.6 failed this metric
FC066: Ensure chef_version is set in metadata: bamboo/metadata.rb:1
FC069: Ensure standardized license defined in metadata: bamboo/metadata.rb:1
Run with Foodcritic Version 10.3.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
License Metric
2.0.6 passed this metric
No Binaries Metric
2.0.6 passed this metric
Testing File Metric
2.0.6 passed this metric
Version Tag Metric
2.0.6 passed this metric
2.0.6 failed this metric
FC069: Ensure standardized license defined in metadata: bamboo/metadata.rb:1
Run with Foodcritic Version 10.3.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
2.0.6 passed this metric
No Binaries Metric
2.0.6 passed this metric
Testing File Metric
2.0.6 passed this metric
Version Tag Metric
2.0.6 passed this metric
2.0.6 passed this metric
2.0.6 passed this metric
Version Tag Metric
2.0.6 passed this metric
2.0.6 passed this metric