P2P Bug Tracking with SD

P2P Bug Tracking with SD
http://syncwith.us

curl fsck.com/sd|perl;
~/sd/bin/sd

SD を使った P2P バグトラッキング

I’m Jesse (obra)

Jesse です

I own a small
software company

小さな会社の社長をしています

I’ve been making
issue trackers since
1995

1995 年からバグトラッカーを作ってきました

Our software
has some bugs

うちのソフトにはバグがあります

All software
has some bugs

どんなソフトでもバグはあります

(All software
is made of bugs)

ソフトなんてバグでできているのです

I spend a lot of time
on airplanes...

私はよく飛行機に乗ります

...and at conferences
with bad wifi

ネットにつながりにくい
イベントにもよく行きます

I need to keep track
of our bugs and our
work

でも、バグや仕事から目を
離すわけにはいきません

I’m the boss

社長ですから

I have no excuse for
not doing my work

言い訳は通用しません

I need to keep track
of our bugs and our
work even when I
don’t have net access
ネットがなくてもバグや仕事は
管理しないといけないのです

I’ve tried everything

あらゆる方法を試してみました

Text files

テキストファイル

Text files in
version control

バージョン管理した
テキストファイル

IMAP Servers

IMAP サーバ

Running RT on
my laptop

ラップトップで RT を走らせてみたり

Keeping browsers
open

ブラウザを開きっぱなしにしてみたり

Nothing was quite
right

どれもイマイチでした

So we built SD

そこで作ったのが SD です

SD is a Bug Tracker

SD はバグトラッカーです

SD is a Distributed
Bug Tracker

SD は分散型のバグトラッカーです

SD Features ( の特徴 )
Tracks bugs P2P Sync
CLI Trac Sync
Web UI RT Sync
Scriptable Hiveminder Sync
Works offline
GitHub Sync
Attachments
Comments
Google Code Sync
Customizable workflow Conflict Resolution
Custom properties Git integration
Darcs integration

Principles of
distributed
computing

分散コンピューティングの原理

Bill Joy, Tom Lyon,
Peter Deutsch and
James Gosling
created these
ビル・ジョイらはこんなものを作りました

The network is
reliable

ネットワークが信頼できて

Latency is zero

遅延時間はゼロで

Bandwidth is infinite

帯域幅は無限

The network is
secure

ネットワークは安全で

Transport cost is zero

転送料はゼロ

The network is
homogeneous

ネットワークは均質で

Topology
doesn't change

ネットワークの構成は変化しない

There is one
administrator

管理者はひとり

I didn’t make
those up

私にはそんなもの用意できませんでした

Bill Joy, Tom Lyon,
Peter Deutsch and
James Gosling did

彼らは用意しましたが

s
ie of
lac
Principles
l
a
F distributed
computing

分散コンピューティングの原理

Those are all LIES

そんなものは真っ赤な嘘です

The network is not
reliable

ネットワークなんて信頼できません

SD isn’t network-
dependent

だから SD はネットワークに依存しません

Latency hurts

遅延時間もひどいものです

SD runs at the edge

だから SD は境界上で動作します

Bandwidth is always
a problem

帯域幅はいつでも悩みの種です

SD knows which
changesets you’ve
already seen
だから SD はどのチェンジセット
を見たか覚えています

The network is
insecure

ネットワークは安全ではありません

SD doesn’t depend
on a network security
layer
だから SD はネットワークのセキ
ュリティ層には依存しません

Topology is
unpredictable
and fluid
ネットワークの構成は予測
できませんし流動的です

SD is topology-
agnostic

だから SD は構成不可知
論の立場をとります

There is no
administrator

管理者なんていません

(But there are many
people who think
they’re
administrators)
そのつもりでいる人はたくさんいますが

SD lets you
implement policy in
the centralized
systems it syncs to
だから SD は同期先の中央管理システム側で
ポリシーを実装できるようになっています

Transport
costs money

転送料はタダではありません

SD doesn’t use much
bandwidth & can use
non-network
substrates
だから SD はあまり帯域幅を使いません。
ネットワーク以外の下位層にも対応しています

The network is
heterogeneous

ネットワークは均質ではありません

SD is designed to
sync to foreign
systems
だから SD は外部のシステムと同期
できるようになっています

SD runs locally

SD はローカルで実行できます

SD plays well
with others

ほかのソフトともうまくつきあえます

It syncs
the way you do

同期の取り方は人間と同じ

Clone a project’s bug
database (over HTTP)

(HTTP 経由で ) プロジェクトの
バグデータベースのクローンを作って

Work offline

オフラインで作業して

Pull changesets from
anyone you work
with

仕事仲間からチェンジセットを取ってきて

Publish your
database replica with
rsync

データベースの複製を rsync で公開

Topology doesn’t matter...

ネットワークの構成なんて関係ありません

Don’t worry

ご心配なく

It won’t break

それでも壊れませんから

SD learns how to
resolve each
conflict...
SD は衝突の解決策をひとつ
ひとつ学んでいきます

...based on how
everyone else
resolves it
ベースとなるのは、ほか
の人がどう解決したかです

Using SD (CLI)

SD の使い方 (CLI)

Getting Started

使ってみましょう

Getting help

$ sd help
ヘルプ

Creating a new
project

$ sd init
新規プロジェクトの作成

Project settings

$ sd settings
プロジェクトの設定

Config file

$ sd config
設定ファイル

Create a bug

$ sd ticket create

バグ情報を登録する

Listing bugs

$ sd ticket list
バグ情報の一覧表示

Show a bug

$ sd ticket show
バグ情報を表示する

Update a bug

$ sd ticket update

バグ情報を更新する

Git Integration

$ git sd
Git に統合

Using SD (Web)

SD の使い方 (Web)

Web? Isn’t SD an
offline tool?

あれ、 SD ってオフラインツー
ルじゃなかったの？

Local microserver

ローカルのマイクロサーバ

Create a ticket

チケットを登録する

Show a bug

バグ情報を表示する

Update a bug

バグ情報を更新する

Working with others

ほかの人と一緒に作業する場合

Working with others
(Using SD)

(SD を利用 )

Any topology

ネットワークの構成は任意

It doesn’t matter who
you sync with

同期する相手は誰でもかまいません

You get all the
updates
eventually

そのうちすべての更新情報が届きます

Cloning

$ sd clone
クローン

clone makes a replica
of someone else’s
database
クローンするとほかの人のデー
タベースの複製を作ります

pull imports unseen
changes from
another database
replica
ほかのデータベースの複製から未見
の変更をインポートします

Publishing

$ sd publish
公開

publish writes out a
copy of your
database replica for
sharing
データベースの複製のコピーをほかの人と共
有できるように書き出します

(As SD changesets
and static HTML)

SD のチェンジセットと静的な HTML の形で

Hackathon mode
(using Bonjour)

ハッカソンモード (Bonjour を使って )

Publish your replica

$ sd server

Pull updates

$ sd pull --local
更新を取得

Working with others
(Using other systems)

( ほかのシステムを使う )

But you already have
a bug tracker?

もうバグトラッカーを使っていますって？

I use at least
two others.

私も少なくともあと 2 つ使っています

I wrote at least
two others.

少なくともあと 2 つ書きました

We designed SD talk
to foreign bug
trackers
Sd は外部のバグトラッカーともや
りとりできるように設計しました

RT::Client::REST
(By DMITRI, DAMS & AMS)

Net::Trac
(by JESSE & TSIBLEY)

Net::Google::Code
(by SUNNAVY and FAYLAND)

Net::Lighthouse
(by SUNNAVY)

Want to help with
Bugzilla, Jira, FogBugz
or something else?

Bugzilla とかも使いたい？

Work with
foreign
replicas in
a Star
Topology
スター構成にすれば外部の複製も使えます

X
An SD
node can
act as a
gateway
SD のノードはゲートウェイにもなります

Clone

$ sd clone

クローン

Clone from Google
Code
$ sd clone --from gcode:k9mail

Google Code から

Clone from RT
$ sd clone --from "rt:https://rt.cpan.org|DBI|"

RT から

Clone from Trac

$ sd clone --from trac:https://trac.parrot.org/parrot

Trac から

Clone from GitHub

$ git sd clone --from github:miyagawa/remedie

Github から

SD reverse engineers
a database history

SD はデータベースの履歴を逆解析します

SD reverse engineers
a partial database
history
SD は部分的なデータベースの
履歴も逆解析します

SD figures out local
updates and sends
them upstream
SD はローカルの更新を見
つけて上流に送ります

(Then it does a bunch
of book-keeping)

それからさまざまな記録をつけます

So what’s that all
look like in the real
world?

実際の例を見てみましょう

Google Code Alice’s SD Bob’s SD

Create some bugs

clone --from gcode:k9mail Alice’s SD makes a full copy of the k9mail from google
code

Someone updates ticket
12

ticket update 13

ticket create

pull --from k9mail SD integrates upstream changes from Google Code since
Alice ran the ‘clone’ command.

push --to k9mail SD figures out what’s changed locally since the original
‘clone’ command. SD then sends any changes that
Google Code hasn’t seen upstream as ticket updates.
Alice’s new ticket and her updates to ticket 13 are now
part of the upstream bug database in Google Code

publish --to SD exports a full copy of Alice’s bug database and rsyncs
alice.com:public_html/k9 it up to alice.com/k9. Anyone browsing alice.com/k9 can
clone her SD replica. (Or see it in static HTML)

clone --from http://alice.com/k9 Bob makes a full copy of Alice’s SD replica of the k9mail
database. He’s now free to make changes to his local
database replica.

ticket update 45

ticket create

ticket create

ticket update 45

publish --to bob.com:public_html/k9 Bob publishes his full K9 bug database. Anyone browsing
bob.com/k9 can clone Bob’s K9 replica. Anyone who
already has a copy of Alice or Bob’s database can
incorporate Bob’s new ticket and his changes to ticket
45.

pull --from http://bob.com/k9 Alice’s SD pulls all previously unseen updates from Bob’s
published database replica and incorporates them. If
Bob's edits to ticket 45 didn't conflict, Alice's SD
incorporate them. If they did conflict, Alice will be
prompted to resolve the conflict.

Installing SD

SD のインストール

It’s time to get SD
up and running

いよいよ SD を走らせてみましょう

SD is in Perl

SD は Perl で書かれています

SD uses 45-90
CPAN modules

45 ～ 90 個の CPAN
モジュールを使っています

Are you afraid?

大変そう？

I have a novel idea
for
a Perl application
これまでの Perl アプリとは違う
新しいやり方を思いついたんです

One-tweet install.

インストールはつぶやき 1 回分

I’m installing #SD (http://syncwith.us)
after seeing @obra’s talk at #YAPCASIA!

YAPCASIA で @obra の話を見て #SD
(http://syncwith.us) をインストールしてる

80 bytes! I still have
60 to work with!

80 バイト ! 　まだ 60 バイトもありますよ !

I’m installing #SD (http://syncwith.us)
after seeing @obra’s talk at #YAPCASIA!
export PATH=~/sd/bin:$PATH; sd

export PATH=~/sd/bin:$PATH; sd

You’ll need:

curl, perl 5.8,
C compiler

必要なのは curl, perl 5.8, C コンパイラ

You won’t need:

CPAN

CPAN 不要

You won’t need:

to answer prompts

質問に答えたりする必要もなし

You won’t need:

to fix dependencies

依存モジュールの修正も不要

SD uses CPAN
modules.

CPAN モジュールも使っています

This is a blessing.

ありがたいことです

This is a curse.

呪いでもありますが

CPAN
=
Dependency Hell

CPAN は依存地獄です

When we first built
SD, we used anything
we thought was
useful
SD を最初に作ったときは便利
そうなものを使いまくりました

(The first version of
SD used a SVN
backend)
最初のバージョンはバックエンドに
SVN を使っていました

The first ~useful
version of SD:

最初のバージョンがほぼ使えるように
なったときはこんな感じでした

123 Dependencies

123 個の依存モジュール

...a couple hours
later

… 数時間後には

54 Dependencies

54 個の依存モジュール

Only one needs a
compiler.

コンパイラが必要なのは 1 つだけ

Shipwright gives us
one-command install

Shipwright のおかげでコマンド 1 つでイン
ストールできるようになりました

curl fsck.com/sd|perl
export PATH=$PATH:~/sd/bin

What’s that do?

どうなってるのか

$ head /Library/WebServer/Documents/sd

open (my $tar,'|tar xz 2>/dev/null');
while (<DATA>) {
print $tar $_;
}
close $tar;
exec("cd sd-build; bin/shipwright-builder
--install-base=$ENV{HOME}/sd");
__DATA__
?I?Isd-build.tar?<is?F???_1? 䀌 yH?"#‫{$ٲ‬U???H?eH
...

Shipwright installs a
few Perl modules...

Shipwright は Perl モジュールをいくつかイ
ンストールします…

...in order

順にあげると…

Scalar-List-Utils String-BufferStack Class-Accessor Class-Data-Inheritable
Tree-DAG_Node Test-Simple Sub-Uplevel Test-Exception Array-Compare Test-
Warn Template-Declare URI HTTP-Server-Simple Params-Util Class-Inspector
File-ShareDir DBI DBD-SQLite HTML-Tagset HTML-Parser HTML-Tree Crypt-
SSLeay JSON YAML-Syck JSON-XS JSON-DWIW JSON-Any Mouse Any-Moose
Compress-Raw-Zlib Compress-Raw-Bzip2 IO-Compress libwww-perl HTTP-
Response-Encoding WWW-Mechanize WWW-Mechanize-GZip File-Slurp Test-
MockModule Net-GitHub MIME-Types Class-Singleton Params-Validate
version ExtUtils-CBuilder ExtUtils-ParseXS Test-Harness File-Temp Module-
Build DateTime-TimeZone List-MoreUtils DateTime-Locale DateTime File-
MMagic Net-Google-Code Term-ReadLine-Perl Digest-SHA1 Digest-HMAC Net-
IP Net-DNS Net-Bonjour TermReadKey UUID-Tiny XML-Atom-SimpleFeed
Digest-SHA Exporter-Lite IPC-Run3 MIME-Base64-URLSafe Sub-Install Data-
OptList Sub-Exporter Path-Dispatcher Module-Pluggable Time-Progress Carp-
Assert Proc-InvokeEditor Test-HTTP-Server-Simple Module-Refresh Carp-
Assert-More Test-LongString Test-WWW-Mechanize Test-Script-Run
prophet.git Devel-StackTrace Exception-Class Error RT-Client-REST Email-
Address YAML Path-Class Clone Hash-Merge UNIVERSAL-isa UNIVERSAL-can
Test-MockObject Net-Jifty Lingua-EN-Inflect Text-CSV Net-Trac boolean Time-
Piece Test-MockTime DateTime-Format-Natural sd.git

(104 dists with our
sync plugins)

sync プラグイン経由で 104 個

What’s wrong
with SD?

SD にバグがあったら？

$ sd clone --from http://fsck.com/~jesse/sd-bugs

Don’t want to
install SD?

インストールはしたくない？

Point your browser at
http://fsck.com/~jesse/sd-bugs/html

ブラウザからでも大丈夫

What’s next?

SD のこれから？

GPG-signed
changesets

GPG 署名付きのチェンジセット

Actually releasing 1.0

本当に 1.0 をリリースすること

Thanks!

Questions?

curl fsck.com/sd | perl

http://syncwith.us
jesse@bestpractical.com

P2P Bug Tracking with SD

More Related Content

Similar to P2P Bug Tracking with SD (20)

More from Jesse Vincent (20)

Recently uploaded (20)

P2P Bug Tracking with SD