Managing code rulesets for repositories in your enterprise

After creating a ruleset at the enterprise level, you can make changes to the ruleset to alter how people can interact with the targeted repositories. For example, you can:

• Add rules to better protect the branches or tags in those repositories
• Switch your ruleset from "Evaluate" mode to "Active" after testing its effects on the contributor experience

About delegated bypass

돌려주기 규칙 세트를 위해 위임된 바이패스를 사용하면 돌려주기 보호를 바이패스할 수 있는 사용자와 허용해야 하는 차단된 돌려주기를 제어할 수 있습니다.

위임된 바이패스를 사용하면 리포지토리에 대한 기여자는 제한된 콘텐츠가 포함된 커밋을 돌려줄 때 "권한 바이패스"를 요청해야 합니다. 요청은 돌려주기 규칙을 바이패스하는 요청을 승인하거나 거부하는 지정된 검토자 그룹으로 전송됩니다.

돌려주기 규칙 바이패스 요청이 승인되는 경우 기여자는 제한된 콘텐츠가 포함된 커밋을 돌려줄 수 있습니다. 요청이 거부되는 경우 기여자는 다시 돌려주기 전에 제한된 콘텐츠가 포함된 하나 이상의 커밋에서 콘텐츠를 제거해야 합니다.

위임된 바이패스를 구성하려면 조직 소유자 또는 리포지토리 관리자가 먼저 "바이패스 목록"을 만듭니다. 바이패스 목록에는 돌려주기 보호 바이패스 요청을 감독하는 팀 또는 리포지토리 관리자와 같은 특정 역할과 팀이 포함됩니다. 자세한 내용은 조직의 리포지토리에 대한 규칙 집합 관리 및 규칙 세트 정보을(를) 참조하세요.

Editing a ruleset

You can edit a ruleset to change parts of the ruleset, such as the name, bypass permissions, or rules. You can also edit a ruleset to change its status, such as if you want to enable or temporarily disable a ruleset.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.

2. 사용자 환경에 따라 사용자 엔터프라이즈를 클릭하거나 사용자 엔터프라이즈를 클릭한 다음, 보고 싶은 엔터프라이즈를 클릭합니다.

3. In the left sidebar, in the "Policies" section, click Code, then click Rulesets.

4. On the "Rulesets" page, click the name of the ruleset you want to edit.

5. Change the ruleset as required.

   For information on the available rules, see "규칙 세트에 사용 가능한 규칙"

6. At the bottom of the page, click Save changes.

Deleting a ruleset

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
2. 사용자 환경에 따라 사용자 엔터프라이즈를 클릭하거나 사용자 엔터프라이즈를 클릭한 다음, 보고 싶은 엔터프라이즈를 클릭합니다.
3. In the left sidebar, in the "Policies" section, click Code, then click Rulesets.
4. To the right of the ruleset's name, select , then click Delete ruleset.

Using ruleset history

규칙 집합의 모든 변경 내용을 보고 특정 반복으로 되돌릴 수 있습니다. 특정 반복에서 규칙 집합의 구성이 포함된 JSON 파일을 다운로드할 수도 있습니다. 규칙 집합의 바이패스 목록은 내보낸 JSON 파일에서 제외됩니다.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
2. 사용자 환경에 따라 사용자 엔터프라이즈를 클릭하거나 사용자 엔터프라이즈를 클릭한 다음, 보고 싶은 엔터프라이즈를 클릭합니다.
3. In the left sidebar, in the "Policies" section, click Code, then click Rulesets.
4. To view the history of changes to the ruleset, select to the right of the ruleset's name, then click History.
5. To the right of the specific iteration, select , then click Compare changes, Restore, or Download.

Importing a ruleset

You can import a ruleset from another repository, organization or enterprise using the exported JSON file from the previous section. This can be useful if you want to apply the same ruleset to multiple repositories, organizations or enterprises.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
2. 사용자 환경에 따라 사용자 엔터프라이즈를 클릭하거나 사용자 엔터프라이즈를 클릭한 다음, 보고 싶은 엔터프라이즈를 클릭합니다.
3. In the left sidebar, in the "Policies" section, click Code, then click Rulesets.
4. Select the New ruleset dropdown, then click Import a ruleset.
5. Open the exported JSON file.
6. Review the imported ruleset and click Create.

Viewing insights for rulesets

You can view insights for rulesets to see how rulesets are affecting the repositories in your enterprise. "규칙 인사이트" 페이지에 다음 사용자 작업의 타임라인 표시됩니다. 필터를 사용하여 원하는 항목을 찾을 수 있습니다.

• 하나 이상의 규칙 집합에 대해 검사하여 통과한 작업입니다.
• 하나 이상의 규칙 집합에 대해 검사하여 실패한 작업입니다.
• 다른 사용자가 하나 이상의 규칙 집합을 우회한 작업입니다.

규칙 집합을 "평가" 모드에서 실행 중일 때는 규칙 집합이 활성화된 경우 통과하거나 실패한 작업을 볼 수 있습니다.

If a ruleset is running in "Evaluate" mode, you can see actions that would have passed or failed if the ruleset had been active.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
2. 사용자 환경에 따라 사용자 엔터프라이즈를 클릭하거나 사용자 엔터프라이즈를 클릭한 다음, 보고 싶은 엔터프라이즈를 클릭합니다.
3. In the left sidebar, in the "Policies" section, click Code, then click Rulesets.
4. On the "Rule insights" page, use the dropdown menus at the top of the page to filter the actions by ruleset, repository, actor, and time period.
5. To see which specific rules failed or required a bypass, click , then expand the name of the ruleset.

돌려주기 규칙을 바이패스하기 위한 요청 관리

리포지토리의 규칙 설정 아래에 있는 "바이패스 요청” 페이지에서 권한 바이패스 에 대한 모든 요청을 보고 관리할 수 있습니다.

1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.

2. 리포지토리 이름 아래에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

3. 바이패스 요청을 클릭합니다.

승인자(바이패스 목록의 구성원), 요청자(요청을 만드는 기여자), 시간 범위 및 상태 따라 요청을 필터링할 수 있습니다. 다음 상태가 요청에 할당됩니다.

Status	설명
Cancelled	기여자가 요청을 취소했습니다.
Completed	요청이 승인되었으며 커밋이 리포지토리로 푸시되었습니다.
Denied	요청이 검토 및 거부되었습니다.
Expired	요청이 만료되었습니다. 요청은 7일간 유효합니다.
Open	요청이 아직 검토되지 않았거나, 승인되었지만 커밋이 리포지토리로 푸시되지 않았습니다.

기여자가 제한된 콘텐츠가 포함된 커밋을 돌려주기 위해 권한 바이패스를 요청하면 바이패스 목록의 모든 구성원은 요청에 대한 링크가 포함된 이메일 알림을 받습니다. 그러면 바이패스 목록의 구성원이 요청이 만료되기 전에 7일간 요청을 검토하고 승인하거나 거부할 수 있습니다.

기여자가 이메일로 결정에 대한 알림을 받게 되며 필요한 조치를 취해야 합니다. 요청이 승인되는 경우 기여자는 리포지토리에 대한 제한된 콘텐츠가 포함된 커밋을 돌려줄 수 있습니다. 요청이 거부되는 경우 기여자가 커밋을 리포지토리에 성공적으로 돌려주려면 커밋에서 제한된 콘텐츠를 제거해야 합니다.