Taskdのソースを表示

[[Category:ネットワーク]]
[[en:Taskd]]
[https://tasktools.org/projects/taskd.html taskd] はタスクデータへのマルチユーザー・マルチクライアントによるアクセスを提供する軽量・セキュアなサーバーです。デスクトップと携帯端末の同期を可能にします。

== サーバー ==
=== インストール ===
taskd は {{AUR|taskd}} または {{AUR|taskd-git}} パッケージでインストールできます。

=== 設定 ===
taskd をインストールしたら設定が必要です。最初に {{ic|export TASKDDATA<nowiki>=</nowiki>/var/lib/taskd}} を実行してください (このコマンドを実行しない場合、taskd コマンドを実行するたびに {{ic|--data /var/lib/taskd}} を付ける必要があります)。

次に {{ic|/usr/share/doc/taskd/pki/vars}} ファイルを編集してください。{{ic|CN<nowiki>=</nowiki>}} 行にサーバーのホストネームあるいは IP アドレスを指定してください (接続方法によってどちらか選んでください)。ファイルが編集できたら、{{ic|/usr/share/doc/taskd/pki/generate}} を実行してください。サーバーの自己署名証明書が作成されます。生成された *.pem ファイルを全て {{ic|/var/lib/taskd}} にコピーしてください。最低でも、後でユーザー証明書を作成するために {{ic|ca.cert.pem}} は pki フォルダに必須になります。

それから taskd を設定してください。{{ic|taskd config}} を実行するか {{ic|/var/lib/taskd/config}} を直接編集することで設定できます。
{{bc|taskd config --force client.cert $TASKDDATA/client.cert.pem
taskd config --force client.key $TASKDDATA/client.key.pem
taskd config --force server.cert $TASKDDATA/server.cert.pem
taskd config --force server.key $TASKDDATA/server.key.pem
taskd config --force server.crl $TASKDDATA/server.crl.pem
taskd config --force ca.cert $TASKDDATA/ca.cert.pem}}

さらに以下のコマンドを実行して taskd がログを出力する場所を変更してください (デフォルトは {{ic|/tmp/log}} となっています):
{{bc|touch /var/log/taskd.log
chown taskd:taskd /var/log/taskd.log
taskd config --force log /var/log/taskd.log}}

最後に taskd のサーバー名を設定します。証明書の名前と同じ名前を設定してください: {{ic|taskd config --force server servername:port}}。taskd のポートはデフォルトでは設定されていないため、手動で設定する必要があります。

=== taskd にユーザーを追加 ===
taskd はグループやユーザーを認識します。グループやユーザーの名前は自由に付けることができます:
{{bc|taskd add org group
taskd add user group username}}
ユーザーが同期するには最後のコマンドで返ってきたキーが必要になります。

taskd ユーザーで新しいグループとユーザーが読み込めるように設定してください:
{{bc|chown -R taskd:taskd /var/lib/taskd/orgs}}

{{ic|/usr/share/doc/taskd/pki/}} に戻って {{bc|./generate.client username}} を実行してください。{{ic|username.cert.pem}} と {{ic|username.key.pem}} が作られるので、{{ic|ca.cert.pem}} とあわせてユーザーの {{ic|~/.task}} ディレクトリに追加してください。

== クライアント ==
=== ユーザーの設定 ===
{{ic|*.pem}} ファイルを {{ic|~/.task}} に追加したら、サーバー名とユニーク ID とあわせて task の設定に追加してください:

{{bc|task config taskd.certificate ~/.task/username.cert.pem
task config taskd.key ~/.task/username.key.pem
task config taskd.ca ~/.task/ca.cert.pem
task config taskd.server servername:port
task config taskd.credentials group/username/key}}

設定を追加したら、設定ファイルを確認してください。

{{ic|task sync init}} の実行後、ユーザーは taskwarrior をいつでも同期できるようになります。

=== Android の Taskwarrior アプリを使う ===
Android アプリをダウンロードする前に、フォルダを作成する必要があります。外部ストレージに (内部ストレージしかない場合は内部ストレージでかまいません)、{{ic|Android/data/kvj.taskw/files/key}} というフォルダを作成してください ("key" は taskd でユーザーを作成したときに表示されたキーに置き換えてください)。そしてフォルダに {{ic|username.key.pem}}, {{ic|username.cert.pem}}, {{ic|ca.cert.pem}} ファイルを追加してください。{{ic|.taskrc.android}} という名前のフォルダに以下のような新しいファイルを作成します:
{{bc|taskd.server<nowiki>=</nowiki>servername:port
taskd.credentials<nowiki>=</nowiki>group/username/key
taskd.certificate<nowiki>=</nowiki>username.cert.pem
taskd.key<nowiki>=</nowiki>username.key.pem
taskd.ca<nowiki>=</nowiki>ca.cert.pem}}
設定できたらアプリをダウンロードして起動してください。プロファイルを追加するときに、作成したデータフォルダを選択してください。これで Taskwarrior が同期されます。

== トラブルシューティング ==
=== Unreachable Server ===
サーバーが実行されているのに接続できない場合、IPv6 が原因かもしれません。{{ic|family<nowiki>=</nowiki>IPv4}} を {{ic|/var/lib/taskd/config}} に追加して taskd を再起動することで強制的に IPv4 を使うことができます。

=== "Bad Key" ===
サーバーが "Bad Key" エラーを返してくる場合、作成したフォルダのパーティションを確認してください ({{ic|/var/lib/taskd/}} やサブフォルダ)。taskd は自動的に uid/gid を設定しないため、手動で taskd に所有者・所有グループを変更する必要があります。