cookbook 'dokku', '= 0.0.1'
dokku (5) Versions 0.0.1 Follow3
Manages a dokku install.
cookbook 'dokku', '= 0.0.1', :supermarket
knife supermarket install dokku
knife supermarket download dokku
chef-dokku
Manages a dokku installation, allowing
configuration of application's environment variables
and installation of plugins.
Attributes
These attributes are under the node['dokku']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
stack_url | STACK_URL environment variable passed on to Dokku's bootstrap.sh | String | nil (meaning it will be whatever is configured on Dokku's Makefile) |
domain | Domain name to write to /home/git/VHOST
|
String | nil (meaning it will be auto detected) |
plugins | Plugins to install | Hash with plugin name as key and GitHub repository URL as value | nil |
Applications Attributes
These attributes are under the node['dokku']['apps']['YOUR_APP_NAME']
namespace.
Attribute | Description | Type | Default |
---|---|---|---|
env | Application's environment variables | Hash | nil |
Recipes
-
recipe[dokku]
Installs/Configures Dokku
Usage
Default Installation
- Add
recipe[dokku]
to your node's run list
After Dokku gets configured, you'll need to upload your SSH key with something
like:
$ cat ~/.ssh/id_rsa.pub | ssh your-server.com "sudo gitreceive upload-key some-dokku-user"
Testing and Development
Vagrant
Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant.
vagrant plugin install vagrant-omnibus
git clone git://github.com/fgrehm/chef-dokku.git
cd chef-dokku
vagrant up
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
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write you change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.