@kody start-review とコメントしてください。
手順
- kodus.io でアカウントを作成するか、Kodus をセルフホストします
- Bitbucket に接続 — オンボーディングの Connect your Git tool ステップで Bitbucket タブを開き、Connect via token をクリックして、Bitbucket のユーザー名、メールアドレス、API トークンを入力します(後からサイドバーの Repositories で、Connect a provider の下の Bitbucket をクリックして接続することもできます)。Bitbucket Data Center の場合は、Bitbucket Data Center をオンにして、ベース URL、ユーザー名、Basic auth password を入力します
- リポジトリを選択 — Kodus がレビューする Bitbucket リポジトリを選択するか、Repositories で Review every repository をオンにします
- Webhook — 選択を保存すると、Kodus が Pull Request の Webhook を自動的に作成します。そのためには、リポジトリへの管理者アクセスが必要です。Bitbucket Cloud ではトークンに
read:webhook:bitbucketとwrite:webhook:bitbucketも必要で、Data Center では Repository admin 権限が必要です。作成されなかった場合は、Repositories にそのリポジトリが理由とともに一覧表示されます。Bitbucket の Webhook ガイドに従って手動で Webhook を追加してください - 選択したリポジトリでプルリクエストを開きます。Kody が投稿する内容とステータスの確認方法を参照してください。
カスタム設定
リポジトリごとのレビュー設定は kodus-config.yml でカスタマイズできます。レート制限
Bitbucket Cloud は、1 時間あたりに許可される API リクエスト数を制限しています。Kodus の各プロセス(API、ワーカー、Webhook)は、同じ認証情報で行う Bitbucket Cloud への呼び出しの間に少なくとも 400 ms 待機し(BITBUCKET_RATE_GATE_MIN_INTERVAL_MS)、429 レスポンスを最大 4 回まで再試行します。その際 Retry-After に従います(BITBUCKET_RATE_GATE_429_MAX_RETRIES)。この間隔はプロセスごとのため、ワーカーが複数ある場合は実効レートが増加します。お使いの Bitbucket が厳しくスロットリングする場合は、この値を引き上げてください。
完全なセットアップガイドについては、Bitbucket API トークンと Bitbucket の Webhook を参照してください。