cookbook 'taskwarrior', '= 1.1.1'
taskwarrior (3) Versions 1.1.1 Follow0
Installs/Configures taskwarrior
cookbook 'taskwarrior', '= 1.1.1', :supermarket
knife supermarket install taskwarrior
knife supermarket download taskwarrior
taskwarrior Cookbook
Installs and configures taskwarrior client and server software.
Requirements
All the requirements are installed for you if you use Berkshelf. Altough it is
good practice to add the following to the role run list.
cookbooks
-
apt
- To install the lastest packages. -
git
- To clone the code both for client and server source installs. -
cmake
- Build dependency for task and taskserver. -
build-essential
- Build dependency for task and taskserver. -
perl
- Build dependency for taskserver. -
python
- Build dependency for taskserver. -
runit
- To manage the taskserver daemon.
Plaforms
- Ubuntu
- Debian
Attributes
taskwarrior::default
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['taskwarrior']['method']</tt></td>
<td>String</td>
<td>Choose to install from the repository of from the lastest on the git repository</td>
<td><tt>package</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["source"]["git_repository"]</tt></td>
<td>String</td>
<td>The git repository to clone taskwarrior from.</td>
<td><tt>git://tasktools.org/task.git</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["source"]["git_revision"]</tt></td>
<td>String</td>
<td>The git revision to build from, HEAD is lastest</td>
<td><tt>HEAD</tt></td>
</tr>
</table>
taskwarrior::server
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["git_repository"]</tt></td>
<td>String</td>
<td>The git repository to clone taskserver from.</td>
<td><tt>git://tasktools.org/taskd.git</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["git_revision"]</tt></td>
<td>String</td>
<td>The git revision to build from, HEAD is lastest</td>
<td><tt>HEAD</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["home"]</tt></td>
<td>String</td>
<td>The main directory for taskd</td>
<td><tt>/var/lib/taskd</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["data_dir"]</tt></td>
<td>String</td>
<td>Taskd data directory</td>
<td><tt>default["taskwarrior"]["server"]["home"]}/data</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["keys_dir"]</tt></td>
<td>String</td>
<td>Fully qualified path for the keys</td>
<td><tt>default["taskwarrior"]["server"]["home"]}/keys</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["confirmation"]</tt></td>
<td>String</td>
<td>Determines whether certain commands are confirmed</td>
<td><tt>on</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["extensions"]</tt></td>
<td>String</td>
<td>Fully qualified path of the taskd extension scripts. Currently there are none.</td>
<td><tt></tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["ip_log"]</tt></td>
<td>String</td>
<td>Logs the IP addresses of incoming requests.</td>
<td><tt>on</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["log"]</tt></td>
<td>String</td>
<td>Logs the IP addresses of incoming requests.</td>
<td><tt>/var/log/taskd.log</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["queue_size"]</tt></td>
<td>Integer</td>
<td>Size of the connection backlog.</td>
<td><tt>10</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["request_limit"]</tt></td>
<td>Integer</td>
<td>Size limit of incoming requests, in bytes.</td>
<td><tt>1048576</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["link"]</tt></td>
<td>String</td>
<td>The address of the taskd server followed by a colon and the por number.</td>
<td><tt>localhost:6544</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["initialized"]</tt></td>
<td>Boolean</td>
<td>Used by the recipe to run the database creation only at first run. Do not override</td>
<td><tt>false</tt></td>
</tr>
<tr>
<td><tt>["taskwarrior"]["server"]["organization"]</tt></td>
<td>String</td>
<td>The name of your organization to generate the certificates.</td>
<td><tt>Empty</tt></td>
</tr>
</table>
Usage
taskwarrior::default
Installs the taskwarrior client that can work standalone, just add it to your run_list. You can choose to install from the repositories,
or to build from source. Just set the ["taskwarrior"]["install_method"] to "source", like so.
{ "name":"my_node", "run_list": [ "recipe[taskwarrior]" ] "override_attrubutes": { "taskwarrior": { "install_method": "source" } } }
taskwarrior::server
Builds and installs the taskwarrior service daemon (taskd) and sets up supervising with runit.
Check the taskwarrior wiki pages for operation, setup amd ciphers
Add the following to you users data bag.
json
{
"id": "bob",
"taskwarrior": {
"organization": "Public",
"groups": ["groupA", "groupB"]
}
}
This will generate client keys and the taskd user and its Uuid for bob. The key distrubution at the moment is done by hand so you
need to get them from the key directory.
Contributing
The testing is done mostly with test-kitchen before everything, set it up. Also foodcritic is used for linting.
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write your change
- Make it pass foodcritic.
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
Authors:
- Alfredo Palhares (masterkorp@masterkorp.net) and masterkorp on irc.freenode.org
Dependent cookbooks
apt >= 0.0.0 |
git >= 0.0.0 |
cmake >= 0.0.0 |
build-essential >= 0.0.0 |
perl >= 0.0.0 |
python >= 0.0.0 |
runit >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.