cookbook 'boxbilling', '= 0.8.0'
boxbilling (13) Versions 0.8.0 Follow0
Installs and configures BoxBilling, invoice and client management software
cookbook 'boxbilling', '= 0.8.0', :supermarket
knife supermarket install boxbilling
knife supermarket download boxbilling
Description
Chef cookbook to install and configure BoxBilling, invoice and client management software.
Requirements
Supported Platforms
This cookbook has been tested on the following platforms:
- Amazon Linux
- CentOS
>= 6.0
- Debian
- Fedora
- RedHat
- Ubuntu
Please, let us know if you use it successfully on any other platform.
Required Cookbooks
Required Applications
- Ruby
1.9.3
or higher.
Attributes
<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><code>node['boxbilling']['download_url']</code></td>
<td>BoxBilling download URL.</td>
<td><code>'http://www.boxbilling.com/version/latest.zip'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['required_packages']</code></td>
<td>BoxBilling required packages.</td>
<td><code>%w(unzip)</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['php_packages']</code></td>
<td>BoxBilling required PHP packages.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['dir']</code></td>
<td>BoxBilling installation directory.</td>
<td><code>'/srv/www/boxbilling'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['server_name']</code></td>
<td>BoxBilling server name.</td>
<td><code>node['fqdn']</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['cron_enabled']</code></td>
<td>Whether to enable BoxBilling cron job.</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['headers']</code></td>
<td>BoxBilling HTTP headers to set as hash.</td>
<td><code>{}</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['ssl']</code></td>
<td>Whether to enable SSL in BoxBilling.</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['encrypt_attributes']</code></td>
<td>Whether to encrypt BoxBilling attributes containing credential secrets.</td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['web_server']</code></td>
<td>Web server to use: <code>'apache'</code> or <code>'nginx'</code></td>
<td><code>'apache'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['admin']['email']</code></td>
<td>BoxBilling admin email.</td>
<td><code>"admin@#{node['boxbilling']['server_name']}"</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['admin']['pass']</code></td>
<td>BoxBilling admin password.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['timezone']</code></td>
<td>BoxBilling timezone. See <a href="http://php.net/manual/en/timezones.php">PHP supported timezones</a>.</td>
<td><code>'America/New_York'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['db_host']</code></td>
<td>BoxBilling database host.</td>
<td><code>'localhost'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['db_name']</code></td>
<td>BoxBilling database name.</td>
<td><code>'boxbilling'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['db_user']</code></td>
<td>BoxBilling database user.</td>
<td><code>'boxbilling'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['db_password']</code></td>
<td>BoxBilling database user password.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['url']</code></td>
<td>BoxBilling URL.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['license']</code></td>
<td>BoxBilling license key (<strong>required</strong>). Go to <a href="http://www.boxbilling.com/order">BoxBilling order page</a> to get a new license.</td>
<td><code>nil</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['locale']</code></td>
<td>BoxBilling locale.</td>
<td><code>'en_US'</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['sef_urls']</code></td>
<td>Whether to enable BoxBilling <em>search engine friendly</em> URLs.</td>
<td><code>false</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['config']['debug']</code></td>
<td>Whether to enable BoxBilling debug mode.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['api_config']['require_referer_header']</code></td>
<td>Whether to enable <em>require referer header</em> in the API.</td>
<td><code>true</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['api_config']['allowed_ips']</code></td>
<td>BoxBilling allowed IP addresses to access the API. Empty array will allow all IPs to access the API.</td>
<td><code>[]</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['api_config']['rate_span']</code></td>
<td>BoxBilling API time span for limit in seconds.</td>
<td><code>3600</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['api_config']['rate_limit']</code></td>
<td>BoxBilling API requests allowed per time span.</td>
<td><code>1000</code></td>
</tr>
<tr>
<td><code>node['boxbilling']['mysql']['server_root_password']</code></td>
<td>BoxBilling MySQL <em>root</em> password.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['mysql']['server_debian_password']</code></td>
<td>BoxBilling MySQL <em>debian</em> user password.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td><code>node['boxbilling']['mysql']['server_repl_password']</code></td>
<td>BoxBilling MySQL <em>repl</em> user password.</td>
<td><em>calculated</em></td>
</tr>
</table>
The HTTPS Certificate
This cookbook uses the ssl_certificate
cookbook to create the HTTPS certificate. The namespace used is node['boxbilling']
. For example:
node.default['boxbilling']['common_name'] = 'boxbilling.example.com' node.default['boxbilling']['config']['license'] = '...' # BB_LICENSE key include_recipe 'boxbilling'
See the ssl_certificate
namespace documentation for more information.
Encrypted Attributes
This cookbook can use the encrypted_attributes cookbook to encrypt the secrets generated during the Chef Run. This feature is disabled by default, but can be enabled setting the node['boxbilling']['encrypt_attributes']
attribute to true
. For example:
include_recipe 'encrypted_attributes::users_data_bag' node.default['boxbilling']['encrypt_attributes'] = true node.default['boxbilling']['config']['license'] = '...' # BB_LICENSE key inclure_recipe 'boxbilling'
This will create the following encrypted attributes:
-
node['boxbilling']['admin']['pass']
: BoxBilling admin password. -
node['boxbilling']['mysql']['root']
: MySQL root user password. -
node['boxbilling']['mysql']['debian']
: MySQL debian user password. -
node['boxbilling']['mysql']['repl']
: MySQL repl user password. -
node['boxbilling']['config']['db_password']
: MySQL BoxBilling user password.
Read the chef-encrypted-attributes
gem documentation to learn how to read them.
Recipes
boxbilling::default
Installs and configures BoxBilling. Including the MySQL server if set to localhost.
boxbilling::api
Installs the requirementes to use the boxbilling_api
resource.
boxbilling::mysql
Installs MySQL server for BoxBilling.
Resources
boxbilling_api[path]
This resource uses the BoxBilling v2 Admin API with some modifications:
- Some paths has been normalized, the action has been removed from the path and the resource action is issued instead.
- The update action is simulated for some objects that do not support it, using delete and create.
- All the action names has been simplified to create, update and delete.
Note: Keep in mind that some API calls require self-generated/auto-incremented MySQL identifiers. So their use can become difficult sometimes.
boxbilling_api Actions
-
request
(default): Sends a HTTP raw API request. -
create
: Sends a create action to the API object. -
update
: Sends an update action to the API object. -
delete
: Send a delete action to the API object.
boxbilling_api Parameters
<table>
<tr>
<th>Parameter</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>path</td>
<td>BoxBilling API relative path. For example: <code>'admin/product'</code>.</td>
<td><em>name</em></td>
</tr>
<tr>
<td>data</td>
<td>Data to send as hash.</td>
<td><code>{}</code></td>
</tr>
<tr>
<td>debug</td>
<td>Whether to enable debug mode.</td>
<td><em>calculated</em></td>
</tr>
<tr>
<td>ignore_failure</td>
<td>Ignore API HTTP errors.</td>
<td><code>false</code></td>
</tr>
</table>
Usage
You need a valid BoxBilling license key to use this cookbook. You can get a new license in the BoxBilling order page.
Including in a Cookbook Recipe
You can simply include it in a recipe:
# in your recipe node.default['boxbilling']['config']['license'] = '...' # BB_LICENSE key include_recipe 'boxbilling'
Don't forget to include the boxbilling
cookbook as a dependency in the metadata:
# metadata.rb depends 'boxbilling'
Including in the Run List
Another alternative is to include it in your Run List:
{ "name": "bb.onddo.com", [...] "normal": { "boxbilling": { "config": { "license": "BB_LICENSE" } } }, "run_list": [ [...] "recipe[boxbilling]" ] }
Installing BoxBilling 4
To install BoxBilling version 4, you must change the node['boxbilling']['download_url']
attribute.
You can use GitHub to download the release. For example:
node.default['boxbilling']['config']['license'] = '...' # BB_LICENSE key node.default['boxbilling']['download_url'] = 'https://github.com/boxbilling/boxbilling/releases/download/4.14.2/BoxBilling.zip' include_recipe 'boxbilling::default'
boxbilling::default Recipe Usage Example
node.default['boxbilling']['config']['license'] = '...' # BB_LICENSE key include_recipe 'boxbilling::default'
boxbilling::api Recipe Usage Example
include_recipe 'boxbilling::api'
boxbilling::mysql Recipe Usage Example
include_recipe 'boxbilling::mysql'
boxbilling_api Resource Usage Example
Below is a fairly complete real example:
# ============================================================================= # Products # ============================================================================= # Disable "Domains registration and transfer" product boxbilling_api 'admin/product Domains registration and transfer' do path 'admin/product' data( id: 1, status: 'disabled' ) action :update end # ============================================================================= # News # ============================================================================= # Delete some default blog news (1..3).each do |id| boxbilling_api "admin/news delete #{id}" do path 'admin/news' data id: id action :delete end end # New blog post # boxbilling_api 'admin/news' do # data( # id: 4, # content: 'Blog post content...', # title: 'My first blog post', # # image: 'http://www.yourdomain.com/image.jpg', # status: 'active' # # created_at: '2012-01-01', # # updated_at: '2012-01-01' # ) # action :create # end # ============================================================================= # Knowledge Base # ============================================================================= # Disable some default articles (1..3).each do |id| boxbilling_api 'admin/kb/article #{id}' do path 'admin/kb/article' data( id: id, status: 'draft' ) action :update end end # Create some categories # boxbilling_api 'admin/kb/category 3' do # path 'admin/kb/category' # data( # id: 3, # title: 'New KB category', # description: 'New KB category content description' # ) # action :create # end # Add some articles # boxbilling_api 'admin/kb/article 4' do # path 'admin/kb/article' # data( # id: 4, # kb_article_category_id: 3, # title: 'My New Article', # status: 'active', # content: 'My article content...' # ) # action :create # end # ============================================================================= # Configuration > Settings > Client # ============================================================================= boxbilling_api 'admin/extension/config' do data( ext: 'mod_client', allow_signup: 1, require_email_confirmation: 1, allow_change_email: 1, required: %w(last_name country city state address_1 postcode phone) ) action :update end # ============================================================================= # Configuration > Settings > Currency settings # ============================================================================= boxbilling_api 'admin/currency EUR' do path 'admin/currency' data( code: 'EUR', title: 'Euro', format: "{{price}} \u20AC" ) action :create end boxbilling_api 'admin/currency GBP' do path 'admin/currency' data( code: 'GBP', title: 'Pound Sterling', format: "\u00A3{{price}}" ) action :create end boxbilling_api 'admin/currency/set_default' do data code: 'EUR' end # ============================================================================= # Configuration > Settings > Email # ============================================================================= boxbilling_api 'admin/email/batch_template_generate' # Reset a template # boxbilling_api 'admin/email/template_reset client_password_reset_approve' do # path 'admin/email/template_reset' # data code: 'mod_client_password_reset_approve' # end # Create a new template # boxbilling_api 'admin/email/template 1' do # path 'admin/email/template' # data( # id: 1, # enabled: 1, # category: 'client', # action_code: 'mod_client_password_reset_approve', # subject: '[{{ guest.system_company.name }}] Password Changed', # content: '...' # ) # action :create # end # Update an existing template # boxbilling_api 'admin/email/template 1' do # path 'admin/email/template' # data( # id: 1, # enabled: 1, # subject: '[{{ guest.system_company.name }}] Password Changed', # content: <<-EOF # {% filter markdown %} # # Dear {{ c.first_name }} {{ c.last_name }}, # # As you requested, your password for our client area has now been reset. # Your new login details are as follows: # # Login at: {{"login"|link}}?email={{ c.email }} # Email: {{ c.email }} # Password: {{ password }} # # To change your password to something more memorable, after logging in go to # Profile > Change Password. # # Edit your profile at {{ "me"|link }} # # {{ guest.system_company.signature }} # # {% endfilter %} # EOF # ) # action :update # end # Email settings # boxbilling_api 'admin/extension/config mod_email' do # path 'admin/extension/config' # data( # ext: 'mod_email', # log_enabled: 1, # mailer: 'smtp', # sendmail | smtp # smtp_host: smtp_host, # smtp_port: 587, # smtp_username: smtp_username, # smtp_password: smtp_password, # smtp_security: 'tls', # ) # action :update # end # ============================================================================= # Configuration > Settings > Invoice settings # ============================================================================= # Set next invoice number # IMPORTANT: this must be run only once, will cause duplicated invoice numbers boxbilling_api 'admin/system/params invoice starting_number' do path 'admin/system/params' data invoice_starting_number: '1' action :nothing end boxbilling_api 'admin/system/params invoice settings' do path 'admin/system/params' data( invoice_issue_days_before_expire: 14, invoice_due_days: 5, invoice_auto_approval: 1, remove_after_days: 0, invoice_series: 'PRO-N', invoice_series_paid: 'N', # negative_invoice | credit_note | manual invoice_refund_logic: 'credit_note', funds_min_amount: 10, funds_max_amount: 200 ) action :update notifies :update, 'boxbilling_api[admin/system/params invoice starting_number]' end # ============================================================================= # Configuration > Settings > Orders settings # ============================================================================= boxbilling_api 'admin/extension/config mod_order' do path 'admin/extension/config' data( ext: 'mod_order', # from_expiration_date | from_today | from_greater order_renewal_logic: 'from_expiration_date', batch_suspend_reason: '' ) action :update end # ============================================================================= # Configuration > Settings > System settings # ============================================================================= boxbilling_api 'admin/system/params system settings' do path 'admin/system/params' data( company_name: 'Testing Labs, Ltd', company_logo: '', company_email: 'testing@testing.com', company_tel: '1234567890', company_address_1: 'Somewhere', company_number: 'B12345678', company_vat_number: 'EU12345678', company_account_number: 'BANK-1234', company_signature: 'Testing signature' ) action :update end # ============================================================================= # Configuration > Domain registration/management # ============================================================================= # Delete default domain TLD boxbilling_api 'admin/servicedomain/tld' do data tld: '.com' action :delete end # ============================================================================= # Configuration > Payment gateways # ============================================================================= boxbilling_api 'admin/invoice/gateway Custom' do path 'admin/invoice/gateway' data( id: 1, enabled: 0, test_mode: 0 ) action :update end # boxbilling_api 'admin/invoice/gateway PayPal' do # path 'admin/invoice/gateway' # data( # id: 2, # enabled: 1, # config: { # email: paypal_email # }, # accepted_currencies: %w(EUR USD GBP), # test_mode: 0 # ) # action :update # end boxbilling_api 'admin/invoice/gateway AlertPay' do path 'admin/invoice/gateway' data( id: 3, enabled: 0, test_mode: test_mode ) action :update end # ============================================================================= # Configuration > Tax # ============================================================================= # Enable taxes boxbilling_api 'admin/system/params taxes' do path 'admin/system/params' data tax_enabled: 1 action :update end # It deletes all the taxes and regenerate them instead of checking if they # previously exists. Notified by boxbilling_api[admin/invoice/tax] boxbilling_api 'admin/invoice/tax_setup_eu' do data( name: 'VAT EU12345678', taxrate: 21 ) action :nothing end boxbilling_api 'admin/invoice/tax' do data( id: 9, # important, must match tax id when usign auto generated/increment name: 'EU12345678', taxrate: 21, country: 'ES' ) action :create notifies :request, 'boxbilling_api[admin/invoice/tax_setup_eu]' end
Testing
See TESTING.md.
ChefSpec Matchers
boxbilling_api(path)
Helper method for locating a boxbilling_api
resource in the collection.
resource = chef_run.boxbilling_api('admin/system/params') expect(resource) .to notify('boxbilling_api[admin/system/params invoice starting_number]') .to(:update).delayed
request_boxbilling_api(path)
Assert that the Chef Run makes a boxbilling_api
request.
expect(chef_run).to request_boxbilling_api(path)
create_boxbilling_api(path)
Assert that the Chef Run makes a boxbilling_api
create request.
expect(chef_run).to create_boxbilling_api(path)
update_boxbilling_api(path)
Assert that the Chef Run makes a boxbilling_api
update request.
expect(chef_run).to update_boxbilling_api(path)
delete_boxbilling_api(path)
Assert that the Chef Run makes a boxbilling_api
delete request.
expect(chef_run).to delete_boxbilling_api(path)
Contributing
Please do not hesitate to open an issue with any questions or problems.
See CONTRIBUTING.md.
TODO
See TODO.md.
License and Author
Author: | Raul Rodriguez (raul@onddo.com) |
Author: | Xabier de Zuazo (xabier@onddo.com) |
Copyright: | Copyright (c) 2013-2015, Onddo Labs, SL. (www.onddo.com) |
License: | Apache License, Version 2.0 |
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 ~> 3.0 |
database = 2.3.1 |
encrypted_attributes ~> 0.2 |
mysql ~> 5.0 |
nginx ~> 2.7 |
openssl ~> 2.0 |
php ~> 1.5 |
php-fpm >= 0.7 |
ssl_certificate ~> 1.2 |
yum-epel ~> 0.5 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
boxbilling CHANGELOG
This file is used to list changes made in each version of the boxbilling
cookbook.
v0.8.0 (2015-03-13)
-
RecipeHelpers#boxbilling_upload_cookbook_file
: Upload files to the root directory instead of bb-uploads (disallowed in robots.txt).
v0.7.0 (2015-02-23)
- Fix
boxbilling_api[admin/system/params]
notifications. - Disable PHP inside bb-uploads and bb-data directories.
v0.6.0 (2015-02-13)
-
boxbilling_api
:- Use returned id when updating after a create.
- Fix method name typo.
- Use passed args when reading list.
- Improved handling of borderline cases.
- Fix condition on same_item?.
- Handle paths that have slug field.
v0.5.0 (2015-02-08)
- Update boxbilling when
'download_url'
points to a new version. -
boxbilling_api
: Addsame_item?
to compare primary keys, support for'admin/email/template'
. - Calculate debug mode.
- Fix all RuboCop offenses (big code refactor).
- README: Add codeclimate badge.
v0.4.1 (2015-01-21)
- Fix disabling nginx default site.
v0.4.0 (2015-01-20)
- Add nginx support.
- Small improvements.
- Unit tests against Chef 11 and 12.
v0.3.0 (2015-01-03)
- htaccess: Fix Apache
2.4
support. - Fix Ubuntu
14
support. - Add Fedora and RedHat support.
- Add integration tests.
- Update to use
ssl_certificate
cookbook version1.1.0
. - metadata: Use pessimistic operator for cookbook versions.
- Enable ChefSpec coverage.
- Gemfile: Use foodcritic fixed version.
- Update license year.
v0.2.1 (2014-12-25)
-
boxbilling_api
: fix encrypted attributes decryption outside chef solo.
v0.2.0 (2014-12-18)
- Add BoxBilling
4
support. - Remove
node['boxbilling']['api_config']['enabled']
attribute from documentation. - Create writable directory recursively.
- metadata:
- Fix attribute types.
- Lock
database
cookbook version.
- Fix version regular expression.
- Refactor ignore failure exception logic.
- Homogenize license headers.
- Add Vagrantfile.
- ChefSpec matchers: Add
boxbilling_api
locator. - Unit tests integrated with
should_not
gem. - ChefSpec unit tests clean up.
- Update ChefSpec tests to
4.1
. - Gemfile: Update
vagrant-wrapper
gem to2
. - Berksfile: Document
local_cookbook
method. - Move test/kitchen/cookbooks/boxbilling_test to test/cookbooks/boxbilling_test.
- TESTING.md: Some small improvements.
- README:
- Clean up examples.
- Small improvements.
v0.1.1 (2014-11-13)
- Attributes: disable
['encrypt_attributes']
by default. - Remove
node['boxbilling']['api_config']['enabled']
attribute (not needed). - Rakefile: include kitchen only in integration tests.
- Gemfile:
- Update to Berksfile 3.
- Use
vagrant-wrapper
gem. - Add integration groups and disable them in travis-ci.
v0.1.0 (2014-08-28)
- Initial release of
boxbilling
Foodcritic Metric
0.8.0 passed this metric
0.8.0 passed this metric