Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird beschrieben, wie Sie den Schutz von Zweigen für Secure Source Manager-Repositories konfigurieren.
Mit dem Schutz von Branches können Repository-Administratoren Regeln festlegen, um zu steuern, wer Änderungen an Branches vornehmen kann, wer Änderungen genehmigen oder überprüfen muss und welche Bedingungen erfüllt sein müssen, bevor eine genehmigte Änderung in einen Branch zusammengeführt werden kann.
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren von Branch-Schutzregeln für ein Secure Source Manager-Repository benötigen:
So erstellen Sie eine neue Regel zum Schutz von Branches:
Wählen Sie in der Secure Source Manager-Weboberfläche das Repository aus, das Sie mit einer Branch-Schutzregel schützen möchten.
Klicken Sie auf der Repository-Seite auf Einstellungen.
Klicken Sie auf den Tab Branch-Regel.
Klicken Sie auf Add branch rule (Branch-Regel hinzufügen).
Geben Sie im Feld ID der Verzweigungsregel einen Namen für die Verzweigungsregel ein.
Die IDs von Branch-Regeln dürfen nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Ziffer sein. Die IDs von Branch-Regeln dürfen maximal 63 Zeichen lang sein.
Geben Sie im Feld Zweigfilter den Namen des Zweigs ein, auf den die Regel angewendet werden soll. Wenn die Regel auf alle Zweige angewendet werden soll, geben Sie .* ein. Der vollständige Abgleich regulärer Ausdrücke wird nicht unterstützt.
Aktivierte Filter für Zweigregeln müssen für das jeweilige Repository eindeutig sein. Nutzer können mehrere deaktivierte Filter für Zweigregeln haben. Sie können beispielsweise nicht zwei aktivierte Branchregeln in einem einzelnen Repository mit dem Branchfilter main haben.
Wenn mehrere Regeln für einen Zweig gelten, hat die Zweigregel mit einem bestimmten Zweignamen als Zweigfilter Vorrang vor der Platzhalterregel.
Beispiel: Eine Verzweigungsregel mit dem Verzweigungsfilter main überschreibt eine Verzweigungsregel mit dem Verzweigungsfilter .*. Regeln werden nicht kombiniert.
Geben Sie im Abschnitt Details zur Branch-Schutzregel die Anforderungen für Ihre Branch-Regel aus den folgenden Optionen an:
Pull-Anfrage vor dem Zusammenführen erforderlich: Wenn diese Option aktiviert ist, werden direkte Commits für den Branch blockiert. Eine Pull-Anfrage muss geöffnet werden, bevor sie in den geschützten Zweig zusammengeführt wird.
Erforderliche Anzahl von Prüfern: Geben Sie die Anzahl der Prüfer an, die zum Genehmigen erforderlich sind, damit der Pull-Request zusammengeführt werden kann.
Erforderliche Anzahl von Genehmigern: Geben Sie die Anzahl der Genehmiger an, die zum Genehmigen erforderlich sind, um den Pull-Request zusammenzuführen.
Prüfer und Genehmiger sind Nutzer mit bestimmten IAM-Rollen. Informationen zu den Rollen, die für Prüfer und Genehmiger erforderlich sind, finden Sie unter Übersicht zum Schutz von Branches.
Block merge on stale reviews and approvals (Zusammenführen bei veralteten Überprüfungen und Genehmigungen blockieren): Wenn diese Option aktiviert ist, wird eine Überprüfung oder Genehmigung entfernt, wenn neue Commits in die Pull-Anfrage übertragen werden, nachdem die Überprüfung oder Genehmigung erteilt wurde.
Konversationsauflösung vor dem Zusammenführen erforderlich: Wenn diese Option aktiviert ist, müssen alle Codekommentare und Änderungsanfragen überprüft werden, bevor zusammengeführt werden kann.
Linearen Verlauf erforderlich: Wenn diese Option aktiviert ist, können Pull-Anfragen, die einen nicht linearen Git-Verlauf erstellen würden, nicht zusammengeführt werden.
Statusprüfungen erforderlich: Wenn diese Option aktiviert ist, müssen die ausgewählten Build-Statusprüfungen erfolgreich sein, bevor ein Pull-Request zusammengeführt werden kann. Sie müssen Trigger in Ihrer Triggerdatei konfigurieren, bevor Sie sie als Statusprüfungen für den Branch-Schutz auswählen können.
Klicken Sie auf Senden, um die Branch-Regel zu speichern.
Der Tab „Branch-Regeln“ wird angezeigt und Ihre neue Branch-Regel ist aufgeführt.
Regel für den Schutz von Branches ändern
So ändern Sie eine Branch-Schutzregel:
Wählen Sie in der Secure Source Manager-Weboberfläche das Repository mit der Branch-Schutzregel aus, die Sie ändern möchten.
Klicken Sie auf der Repository-Seite auf Einstellungen.
Klicken Sie auf den Tab Branch-Regeln.
Klicken Sie auf den Namen der Branch-Regel, die Sie ändern möchten.
Bearbeiten Sie die Branch-Schutzregel.
Klicken Sie auf Aktualisieren.
Die Regel für den Zweigschutz wird aktualisiert.
Regel für den Schutz von Branches löschen
So löschen Sie eine Regel zum Schutz von Branches:
Wählen Sie in der Secure Source Manager-Weboberfläche das Repository aus, aus dem Sie die Branch-Regel entfernen möchten.
Klicken Sie auf der Repository-Seite auf Einstellungen.
Klicken Sie auf den Tab Branch-Regel.
Klicken Sie in der Zeile der Regel, die Sie löschen möchten, auf das Symbol Löschen.
Klicken Sie auf dem Bestätigungsbildschirm Zweigregel entfernen auf Ja.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[],[],null,["# Configure branch protection\n\nThis page explains how to configure branch protection for\nSecure Source Manager repositories.\n\nBranch protection lets repository administrators set rules to control who can\nmake changes to branches, who needs to approve or review changes, and what\nconditions must be met before an approved change can be merged into a branch.\n\nFor more information about branch protection rules, see [Branch protection\noverview](/secure-source-manager/docs/branch-protection-overview).\n\nBefore you begin\n----------------\n\n1. [Create a Secure Source Manager instance](/secure-source-manager/docs/create-instance).\n2. [Create a Secure Source Manager repository](/secure-source-manager/docs/create-repository).\n\n### Required roles\n\n\nTo get the permissions that\nyou need to configure branch protection rules for a Secure Source Manager repository,\n\nask your administrator to grant you the\nfollowing IAM roles:\n\n- [Secure Source Manager Instance Accessor](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.instanceAccessor) (`roles/securesourcemanager.instanceAccessor`) on the Secure Source Manager instance\n- [Secure Source Manager Repository Admin](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.repoAdmin) (`roles/securesourcemanager.repoAdmin`) on the Secure Source Manager repository\n- To approve pull requests on protected branches in any repository in a Secure Source Manager instance:\n - [Secure Source Manager Repository Pull Request Approver](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.repoPullRequestApprover) (`roles/securesourcemanager.repoPullRequestApprover`) on the Google Cloud project for the instance\n - [Secure Source Manager Repository Writer](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.repoWriter) (`roles/securesourcemanager.repoWriter`) on the Google Cloud project for the instance\n- To approve pull requests on protected branches in a single repository:\n - [Secure Source Manager Repository Pull Request Approver](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.repoPullRequestApprover) (`roles/securesourcemanager.repoPullRequestApprover`) on the repository\n - [Secure Source Manager Repository Writer](/iam/docs/roles-permissions/securesourcemanager#securesourcemanager.repoWriter) (`roles/securesourcemanager.repoWriter`) on the repository\n\n \u003cbr /\u003e\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nFor information on granting Secure Source Manager roles,\nsee [Access control with IAM](/secure-source-manager/docs/access-control) and\n[Grant users instance access](/secure-source-manager/docs/grant-users-instance-access).\n\nCreate a branch protection rule\n-------------------------------\n\nTo create a new branch protection rule, do the following:\n\n1. In the Secure Source Manager web interface, select the repository you want to protect with a branch protection rule.\n2. From the repository page, click **Settings**.\n3. Click the **Branch rule** tab.\n4. Click **Add branch rule**.\n5. In the **Branch rule ID** field, enter a name for the branch rule.\n\n Branch rule IDs are restricted to lower-case letters, numbers,\n and hyphens. The first character must be a letter, and the last character\n must be a letter or a number. Branch rule IDs have a 63 character\n maximum.\n6. In the **Branch filter** field, enter the name of the branch you want\n the rule to apply to, or if you want the rule to apply to all branches,\n enter `.*`. Full regular expression matching is not supported.\n\n Enabled branch rule filters must be unique to their repository. Users can\n have multiple disabled branch rule filters. For example, you can't have two\n enabled branch rules in a single repository with the branch filter `main`.\n\n When multiple rules are applicable for a branch, the branch rule with a\n specific branch name as the branch filter will override the wildcard rule.\n For example, a branch rule with branch filter `main` will override a\n branch rule with the branch filter `.*`. Rules are not combined.\n7. In the **Branch protection rule details** section, specify the\n requirements for your branch rule from the following options:\n\n - **Require a pull request before merging**: if enabled, direct\n commits to the branch will be blocked. A pull request must be opened\n before merging into the protected branch.\n\n | **Note:** You can't apply this rule to all branches using `.*`, because that would prevent pushing directly to all branches, even new branches.\n - **Required number of reviewers**: specify the number of\n reviewers required to approve in order to merge the pull request.\n\n - **Required number of approvers**: specify the number of\n approvers required to approve in order to merge the pull request.\n\n Reviewers and approvers are users with specific IAM\n roles. To learn which roles are required for reviewers and approvers,\n see [Branch protection overview](/secure-source-manager/docs/branch-protection-overview).\n - **Block merge on stale reviews and approvals**: if enabled, a review\n or approval is removed if new commits are pushed to the pull request\n after the review or approval is granted.\n\n - **Require conversation resolution before merging**: if enabled,\n all code comments and request change reviews must be resolved before\n merging.\n\n - **Require linear history**: if enabled, pull requests that would create\n a non-linear Git history can't be merged.\n\n - **Require status checks** : if enabled, the selected build status checks\n must be successful before a pull request can be merged. You must\n configure triggers in your [triggers file](/secure-source-manager/docs/triggers-file-schema) before\n you can select them as status checks for branch protection.\n\n8. To save the branch rule, click **Submit**.\n\nThe Branch rules tab is displayed, with your new branch rule listed.\n\nModify a branch protection rule\n-------------------------------\n\nTo modify a branch protection rule, do the following:\n\n1. In the Secure Source Manager web interface, select the repository with the branch protection rule you want to modify.\n2. From the repository page, click **Settings**.\n3. Click the **Branch rules** tab.\n4. Click the name of the branch rule you want to modify.\n5. Edit the branch protection rule.\n6. Click **Update**.\n\nThe branch protection rule is updated.\n\nDelete a branch protection rule\n-------------------------------\n\nTo delete a branch protection rule, do the following:\n\n1. In the Secure Source Manager web interface, select the repository that you want to remove the branch rule from.\n2. From the repository page, click **Settings.**\n3. Click the **Branch rule** tab.\n4. In the row of the rule you want to delete, click the **Delete** icon.\n5. In the **Remove branch rule** confirmation screen, click **Yes**.\n\nThe branch protection rule is deleted.\n\nWhat's next\n-----------\n\n- Read the [Branch protection overview](/secure-source-manager/docs/branch-protection-overview).\n- Learn how to automate builds by following the steps in [Connect to Cloud Build](/secure-source-manager/docs/connect-cloud-build).\n- Learn how to [check the status of automated builds](/secure-source-manager/docs/create-triggers-file#build-status)."]]
.