ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2021-03-02. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

Managing a branch protection rule

You can create a branch protection rule to enforce certain workflows for one or more branches, such as requiring an approving review or passing status checks for all pull requests merged into the protected branch.

People with admin permissions to a repository can manage branch protection rules.

Protected branches are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

ここには以下の内容があります:

About branch protection rules

You can create a branch protection rule in a repository for a specific branch, all branches, or any branch that matches a name pattern you specify with fnmatch syntax. For example, to protect any branches containing the word release, you can create a branch rule for *release*.

You can create a rule for all current and future branches in your repository with the wildcard syntax *. GitHubは、File.fnmatch 構文に File::FNM_PATHNAME フラグを使用するので、ワイルドカードはディレクトリの区切り文字 (/) には一致しません。 たとえば、qa/* は、qa/ で始まり、1 つのスラッシュが含まれるすべてのブランチにマッチします。 You can include multiple slashes with qa/**/*, and you can extend the qa string with qa**/**/* to make the rule more inclusive. ブランチのルールに関する構文オプションの詳しい情報については、 fnmatch ドキュメンテーションを参照してください。

リポジトリが同じブランチに影響する複数の保護されたブランチのルールを持っているなら、特定のブランチ名を含むルールがもっとも高い優先順位を持ちます。 同じ特定のブランチ名を参照する保護されたブランチのルールが複数あるなら、最初に作成されたブランチルールが高い優先順位を持ちます。

*?]などの特殊文字を含む保護されたブランチのルールは、作成された順序で適用されるので、これらの文字を持つ古いルールが高い優先順位を持ちます。

既存のブランチのルールに例外を作成するため、特定のブランチ名に対するルールなど、優先度の高いブランチ保護ルールを新しく作成できます。

For more information about each of each of the available branch protection settings, see "About protected branches."

Creating a branch protection rule

When you create a branch rule, the branch you specify doesn't have to exist yet in the repository.

  1. GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下で Settings(設定)をクリックしてください。
    リポジトリの設定ボタン
  3. 左のメニューでBranches(ブランチ)をクリックしてください。
    リポジトリオプションのサブメニュー
  4. "Branch protection rules(ブランチ保護のルール)"の隣のAdd rule.(ルールの追加)をクリックしてください。
    ブランチ保護のルールの追加ボタン
  5. "Branch name pattern(ブランチ名のパターン)"の下で、保護したいブランチの名前もしくはパターンを入力してください。
    ブランチルールのフィールド
  6. Optionally, enable required pull request reviews.
    • Under "Protect matching branches", select Require pull request reviews before merging.
      プルリクエストレビューの制限チェックボックス
    • Click the Required approving reviews drop-down menu, then select the number of approving reviews you'd like to require on the branch.
      必須とするレビュー承認の数を選択するドロップダウンメニュー
    • Optionally, to dismiss a pull request approval review when a code-modifying commit is pushed to the branch, select Dismiss stale pull request approvals when new commits are pushed.
      新たなコミットがチェックボックスにプッシュされた際に古いプルリクエストの承認を却下するチェックボックス
    • Optionally, to require review from a code owner when the pull request affects code that has a designated owner, select Require review from Code Owners. 詳細は「コードオーナーについて」を参照してください。
      コードオーナーのレビューを必要とする
    • Optionally, if the repository is part of an organization, select Restrict who can dismiss pull request reviews. Then, search for and select the people or teams who are allowed to dismiss pull request reviews. 詳しい情報についてはプルリクエストレビューの却下を参照してください。
      [Restrict who can dismiss pull request reviews] チェックボックス
  7. Optionally, enable required status checks.
    • [Require status checks to pass before merging] を選択します。
      必須ステータスチェックのオプション
    • Optionally, to ensure that pull requests are tested with the latest code on the protected branch, select Require branches to be up to date before merging.
      必須ステータスのチェックボックス、ゆるい、または厳格な
    • 使用可能なステータスチェックのリストから、必須とするものを選択します。
      利用可能なステータスチェックの一覧
  8. Optionally, select Require signed commits.
    [Require signed commits] オプション
  9. Optionally, select Require linear history.
    必須の直線状の履歴オプション
  10. オプションとして、[Include administrators] を選択します。
    [Include administrators] チェックボックス
  11. Optionally, enable branch restrictions.
    • Select Restrict who can push to matching branches.
      ブランチ制限のチェックボックス
    • Search for and select the people, teams, or apps who will have permission to push to the protected branch.
      ブランチ制限の検索
  12. Optionally, under "Rules applied to everyone including administrators", select Allow force pushes.
    フォースプッシュオプションを許可する
  13. Optionally, select Allow deletions.
    ブランチ削除オプションを許可する
  14. Create(作成)をクリックしてください。

Editing a branch protection rule

  1. GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下で Settings(設定)をクリックしてください。
    リポジトリの設定ボタン
  3. 左のメニューでBranches(ブランチ)をクリックしてください。
    リポジトリオプションのサブメニュー
  4. To the right of the branch protection rule you want to edit, click Edit.
    編集ボタン
  5. Make your desired changes to the branch protection rule.
  6. [Save changes] をクリックします。
    [Edit message] ボタン

Deleting a branch protection rule

  1. GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。
  2. リポジトリ名の下で Settings(設定)をクリックしてください。
    リポジトリの設定ボタン
  3. 左のメニューでBranches(ブランチ)をクリックしてください。
    リポジトリオプションのサブメニュー
  4. To the right of the branch protection rule you want to delete, click Delete.
    削除ボタン