Go Wiki: Gerrit アクセス

ここには、異なる権限と責任を持つ2種類のGerritアクセスが記述されています。コミュニティの活動的なメンバーである場合にのみアクセスを要求してください。新しい貢献者は、アクセスを要求する前に、しばらくの間Gerritコードレビュープロセスに参加する必要があります。

(GitHubアクセスについては、GitHubAccessを参照してください)

TryBotの実行(「may-start-trybots」)

TryBotアクセスを使用すると、提出前にGerritでCLのテスト実行を開始できます(提出前テスト)。TryBotは、ある程度安全で隔離された環境で実行されますが、セキュリティが完全に強化されているわけではありません。TryBotを開始する前に、悪意のあるものがないかCLをざっと確認する必要があります。

TryBotのトリガーに関する詳細は、LUCIを参照してください。

すべての承認者(次のセクションを参照)は自動的にTryBotアクセス権を持ちます。それ以外の人はTryBotアクセスを要求できます。以下のアクセス要求を参照してください。

CLの承認(「approvers」)

承認者は、以下に記述されているレビュー規則に従って、コード変更(CL)をレビューおよび提出できます。承認者であることには責任が伴います。承認者はGoに関心があり、その成功を助けたいと願う人々です。承認者は単に変更を加えることができるだけでなく、チームと協力し、最も知識のある人々にコードをレビューしてもらい、高品質のコードを貢献し、問題(コードまたはテストの)を解決するために最後までやり遂げる能力を実証した人です。

コードレビュー要件

すべてのCLには、承認者からのコードレビュー(Code-Review+2)と、コードアップローダーまたはCode-Review+1以上を投票するレビューアーとして、Googleがセキュリティ保護したコンピューターを使用する2人のGoogle従業員の関与の両方が必要です。複数人の要件は、単一の侵害されたアカウントからコードが一方的に提出されることを防ぎます。Google従業員とハードウェアの要件はさらにハードルを上げます。多くのリポジトリのCLは、コミット時にGoogleによってユーザーがダウンロードできるように実質的に公開されるため、Googleの関与はこの公開を承認することです。レビューがCode-Review+2と必要なGoogleの関与を得ると、どの承認者でも提出できます。これらの規則はすべてGerritサーバーによって強制されます。

Code-Review+2の投票は、変更を読み、それが正しく、提出に適していると確信していることを意味します。通常、あなたが「所有する」ディレクトリまたはパッケージのコードのみにCode-Review+2を投票するべきです。例外は、些細で明らかに正しい変更です。ユーザーに表示されるすべての新機能または変更(新しいAPI、新しいコマンドラインフラグなど)は、提案プロセスを経る必要があることに注意してください。CLは、コミットメッセージに特定の承認された提案(「For #NNN.」)を参照する必要があります。

Code-Review+2の投票を追加する際には、Commit-Queue+1とAuto-Submit+1も追加することをお勧めします。詳細については、以下の自動提出セクションを参照してください。

Code-Review+1の投票は、変更を読み、妥当であると思われるが、Code-Review+2が示すような最終的な判断を下しているわけではないことを意味します。また、変更がセキュリティ脆弱性やその他の明らかに不適切なコード変更を導入しないことを確信していることも意味します。

変更が提出に適したレビューを完了すると、Gerritに提出ボタンが表示されます(承認者向け)。その領域の所有者(おそらくあなた!)からのCode-Review+2が付いた変更のみを提出してください。

承認者は、CLにHold+1を投票して、提出不可能としてマークすることもできます(その投票が削除されるまで)。一般的な理由としては、提案レビューのためにCLを待つ必要がある場合や、CLを特定の時間に提出する必要がある場合などがあります。Hold+1を投票することで、レビューは引き続き可能ですが、誤って早く提出されることはありません。

承認者アクセスを要求するには、以下のアクセス要求を参照してください。

自動提出

CLをレビューしていて、さらなる変更なしに承認および提出できると判断した場合、自動提出機能を使用してテストを実行し、テストがパスした場合にCLを提出できます。これを行うには、Code-Review+2、Auto-Submit+1、およびCommit-Queue+1を投票します。テストがパスすると、Gopherbotがそれを提出します。

より正確には、Gopherbotは次の条件を満たすCLを監視し、自動的に提出します。

  • Auto-Submit+1が投票されている
  • TryBots-Passの提出要件が満たされている
  • 必要なコードレビューがある
  • 未解決のコメントがない
  • #wait-releaseとマークされていない
  • そして、現在のブランチヘッドにきれいにマージされる。

すべての承認者はAuto-Submit+1を投票できます。パッチが再アップロードされた場合、Auto-Submit+1の投票は引き継がれません。

Wiki CLの承認(「wiki-approvers」)

主にwiki(https://go.googlesource.com/wiki)で作業する人は、wiki-approversの権限を要求できます。これにより、彼らは自分のCLを含め、wiki CLに+2を投票し、提出することができます。Wiki CLは、2人(または任意の)Google従業員の関与を必要とせず、TryBotがなく、自己レビューが可能です。

アクセス要求

上記のいずれかのアクセスタイプを要求するには、新しいIssueを提出し(https://go.dokyumento.jp/issue/new?title=access:+&body=See+https://go.dokyumento.jp/wiki/GerritAccess)、希望するアクセスと、Gerritへのログインに使用するGoogleアカウントを明記してください。

アクセスの付与に関する決定は、GoogleのGoリリースチームによって行われます。要求が却下されるのは、ほとんどの場合、あなたの作業、プロジェクトの慣習の理解などについて、彼らが十分に明確な情報を得るのに十分な活動をしていないためです。落胆しないでください。そのレベルの精通度に達するには時間がかかる場合があります。

アクセスを取得したら

Goのガーデニングを手伝ってください!Gardeningを参照してください。


このコンテンツはGo Wikiの一部です。