Skip to main content

조직의 리포지토리에 대한 규칙 집합 관리

기존 규칙 집합을 편집, 모니터링 및 삭제하여 사람들이 조직의 리포지토리와 상호 작용하는 방법을 변경할 수 있습니다.

누가 이 기능을 사용할 수 있는 있나요?

Organization owners and users with the "Manage organization ref update rules and rulesets" permission can manage rulesets at the organization level.

조직의 규칙 집합 관리 정보

조직 수준에서 규칙 집합을 만든 후 규칙 집합을 변경하여 사람들이 대상 리포지토리와 상호 작용하는 방법을 변경할 수 있습니다. 예를 들어 해당 리포지토리의 분기 또는 태그를 더 잘 보호하는 규칙을 추가하거나 리포지토리의 기여자 환경에 미치는 영향을 테스트한 후 규칙 집합을 "평가" 모드에서 "활성"으로 전환할 수 있습니다. 리포지토리의 "기본 분기"에 적용되는 조직 규칙 집합은 더 이상 리포지토리 관리자가 대상 리포지토리의 기본 분기 업데이트하도록 허용하지 않습니다.

REST 및 GraphQL API를 사용하여 규칙 집합을 관리할 수 있습니다. 자세한 내용은 "규칙에 대한 REST API 엔드포인트" 및 "변형"을(를) 참조하세요.

참고: 리포지토리에 대한 읽기 권한이 있는 사용자는 해당 리포지토리에 적용되는 활성 규칙 세트를 볼 수 있습니다.

규칙 집합 편집

규칙 집합을 편집하여 이름, 권한 무시 또는 규칙 등을 변경할 수 있습니다. 규칙 집합을 편집하여 규칙 집합을 사용하거나 일시적으로 사용하지 않도록 설정하여 상태를 변경할 수 있습니다.

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 선택한 다음 내 조직을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "조직"이 진한 주황색으로 표시됩니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 왼쪽 사이드바의 "코드, 계획, 자동화" 섹션에서 리포지토리를 선택한 다음 규칙 집합을 클릭합니다.

    조직의 설정 페이지 스크린샷. 사이드바에서 "규칙 집합"이라는 레이블이 지정된 링크가 주황색 윤곽선으로 표시되어 있습니다.

  4. "규칙 세트" 페이지에서 편집할 규칙 세트의 이름을 클릭합니다.

  5. 필요에 따라 규칙 세트를 변경합니다. 사용 가능한 규칙에 대한 정보는 "규칙 세트에 사용 가능한 규칙"을(를) 참조하세요.

  6. 페이지 하단에서 Save changes(변경 내용 저장)를 클릭합니다.

규칙 집합 삭제

팁: 규칙 세트를 일시적으로 사용하지 않도록 설정하고 삭제하지는 않으려는 경우 규칙 세트의 상태를 "사용 안 함"으로 설정할 수 있습니다. 자세한 내용은 “규칙 세트 편집”을 참조하세요.

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 선택한 다음 내 조직을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "조직"이 진한 주황색으로 표시됩니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 왼쪽 사이드바의 "코드, 계획, 자동화" 섹션에서 리포지토리를 선택한 다음 규칙 집합을 클릭합니다.

    조직의 설정 페이지 스크린샷. 사이드바에서 "규칙 집합"이라는 레이블이 지정된 링크가 주황색 윤곽선으로 표시되어 있습니다.

  4. 삭제할 규칙 세트의 이름을 클릭합니다.

  5. 규칙 세트 이름의 오른쪽에서 를 선택하고 규칙 세트 삭제를 클릭합니다.

    규칙 세트를 편집하기 위한 페이지의 스크린샷 세 개의 점으로 레이블이 지정된 단추 아래에 "규칙 세트 삭제"라는 레이블이 지정된 옵션이 주황색 윤곽선으로 표시되어 있습니다.

규칙 집합 기록 사용

참고:

  • 규칙 집합 기록은 현재 공개 베타 버전이며 변경될 수 있습니다.
  • 2023년 10월 11일 공개 베타 릴리스 이후 규칙 집합에 대한 변경 내용만 규칙 집합 기록에 포함됩니다.

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

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 선택한 다음 내 조직을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "조직"이 진한 주황색으로 표시됩니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 왼쪽 사이드바의 "코드, 계획, 자동화" 섹션에서 리포지토리를 선택한 다음 규칙 집합을 클릭합니다.

    조직의 설정 페이지 스크린샷. 사이드바에서 "규칙 집합"이라는 레이블이 지정된 링크가 주황색 윤곽선으로 표시되어 있습니다.

  4. 규칙 집합 변경 기록을 보려면 규칙 집합 이름 오른쪽에 있는 를 선택한 다음 기록을 클릭하세요.

    리포지토리 규칙 집합에 대한 페이지의 스크린샷. 세 개의 점으로 레이블이 지정된 단추 아래에는 "기록"이라는 레이블이 지정된 옵션이 주황색으로 표시됩니다.

  5. 특정 반복의 오른쪽에서 를 선택한 다음 변경 내용 비교, 복원 또는 다운로드를 클릭하세요.

    리포지토리 규칙 집합 기록에 대한 페이지의 스크린샷. 세 개의 점으로 레이블이 지정된 드롭다운 메뉴가 주황색 윤곽선으로 확장되고 강조 표시됩니다.

규칙 집합 가져오기

이전 섹션에서 내보낸 JSON 파일을 사용하여 다른 리포지토리 또는 조직에서 규칙 집합을 가져올 수 있습니다. 여러 리포지토리 또는 조직에 동일한 규칙 집합을 적용하려는 경우에 유용할 수 있습니다.

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 선택한 다음 내 조직을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "조직"이 진한 주황색으로 표시됩니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 왼쪽 사이드바의 "코드, 계획, 자동화" 섹션에서 리포지토리를 선택한 다음 규칙 집합을 클릭합니다.

    조직의 설정 페이지 스크린샷. 사이드바에서 "규칙 집합"이라는 레이블이 지정된 링크가 주황색 윤곽선으로 표시되어 있습니다.

  4. 새 규칙 집합 드롭다운을 선택한 다음 규칙 집합 가져오기를 클릭하세요.

    리포지토리 규칙 집합에 대한 페이지의 스크린샷. "새 규칙 집합"이라는 레이블이 지정된 드롭다운 메뉴가 확장되고 "규칙 집합 가져오기" 옵션이 주황색 윤곽선으로 강조 표시됩니다.

  5. 내보낸 JSON 파일을 여세요.

  6. 가져온 규칙 집합을 검토하고 만들기를 클릭하세요.

규칙 집합에 대한 인사이트 보기

규칙 집합에 대한 인사이트를 보고 규칙 집합이 조직의 리포지토리에 미치는 영향을 확인할 수 있습니다. "규칙 인사이트" 페이지에 다음 사용자 작업의 타임라인 표시됩니다. 필터를 사용하여 원하는 항목을 찾을 수 있습니다.

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

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

"규칙 인사이트" 페이지의 스크린샷. "평가" 레이블이 있고 각각 "통과", "우회", "실패"가 표시된 세 가지 작업이 있습니다.

  1. GitHub.com의 오른쪽 위에서 프로필 사진을 선택한 다음 내 조직을 클릭합니다.

    @octocat 프로필 사진의 드롭다운 메뉴 스크린샷입니다. "조직"이 진한 주황색으로 표시됩니다.

  2. 조직 옆에 있는 설정을 클릭합니다.

  3. 왼쪽 사이드바의 "코드, 계획 및 자동화" 섹션에서 리포지토리를 클릭한 다음 규칙 인사이트를 클릭하세요.

    조직의 설정 페이지 스크린샷. 사이드바에서 "규칙 인사이트"라는 레이블이 지정된 링크가 주황색으로 표시됩니다.

  4. "규칙 인사이트" 페이지에서 페이지 맨 위에 있는 드롭다운 메뉴를 사용하여 규칙 집합, 리포지토리, 행위자 및 기간을 기준으로 작업을 필터링하세요.

  5. 특정 규칙이 실패했거나 바이패스가 필요한지 확인하려면 를 클릭한 다음 규칙 세트의 이름을 확장합니다.

    “규칙 인사이트트” 페이지의 스크린샷. "생성된 octocat이 허용되지 않음"이라는 레이블이 있는 이벤트의 오른쪽에 세 개의 가로 점 아이콘이 주황색 윤곽선으로 표시되어 있습니다.