cookbook 'bamboo', '= 2.0.0'
bamboo
(33) Versions
2.0.0
-
Follow11
Installs and configures Bamboo
cookbook 'bamboo', '= 2.0.0', :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 |
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 |
type | Bamboo database type - "mysql" | String | mysql |
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 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.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.0 passed this metric
Foodcritic Metric
2.0.0 passed this metric
License Metric
2.0.0 passed this metric
2.0.0 passed this metric
2.0.0 passed this metric
License Metric
2.0.0 passed this metric
2.0.0 passed this metric