조직의 리포지토리에 대한 사용자 지정 속성 관리

사용자 지정 속성을 사용하면 조직의 리포지토리에 메타데이터를 추가할 수 있습니다. 이러한 속성을 사용하여 규칙 집합이 있는 리포지토리를 대상으로 지정할 수 있습니다.

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

Organization owners and users with the "Manage the organization's custom properties definitions" permission can add and set a custom property schema at the organization level.

이 문서의 내용

사용자 지정 속성 정보

사용자 지정 속성을 사용하면 규정 준수 프레임워크, 데이터 민감도 또는 프로젝트 세부 정보와 같은 정보를 사용하여 리포지토리를 데코레이트할 수 있습니다. 사용자 지정 속성은 프라이빗이며 리포지토리에 대한 읽기 권한이 있는 사용자만 볼 수 있습니다.

리포지토리 속성을 사용하여 규칙 집합을 통해 대상으로 지정할 리포지토리를 결정할 수 있습니다. 자세한 정보는 "조직에서 리포지토리에 대한 규칙 집합 만들기" 항목을 참조하세요.

허용되는 문자

사용자 지정 속성 이름 및 값은 특정 문자만 포함할 수 있습니다.

  • 이름: a-z, A-Z, 0-9, _, -, $, #.
  • 값: "를 제외한 인쇄 가능한 모든 ASCII 문자.

사용자 지정 속성 추가

조직에 사용자 지정 속성을 추가하고 조직의 리포지토리에 대한 해당 속성에 대한 값을 설정할 수 있습니다.

REST API를 사용하여 조직에 대한 사용자 지정 속성을 만들고 관리할 수도 있습니다. 자세한 정보는 "사용자 지정 속성에 대한 REST API 엔드포인트" 항목을 참조하세요.

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.

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

  3. 왼쪽 사이드바의 "코드, 계획 및 자동화" 섹션에서 리포지토리를 클릭한 다음 사용자 지정 속성을 클릭하세요.

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

  4. 새 사용자 지정 속성을 추가하려면 오른쪽 위 모서리에 있는 새 속성을 클릭하세요.

  5. 사용자 지정 속성에 사용할 이름을 "이름" 필드에 입력하세요. 이름은 공백을 포함할 수 없습니다.

  6. 필요에 따라 "설명" 필드에서 사용자 지정 속성에 대한 설명을 입력하세요.

  7. "형식"에서 추가할 속성의 유형을 선택하세요. 텍스트 문자열, 단일 선택 필드, 다중 선택 필드 또는 true/false 부울일 수 있습니다.

  8. 필요에 따라 리포지토리 행위자가 이 속성을 설정하도록 허용을 선택할 수 있습니다. 사용하도록 설정하면 리포지토리 수준 "사용자 지정 속성" 세분화된 사용 권한이 있는 리포지토리 사용자 및 앱이 해당 리포지토리의 속성 값을 설정하고 업데이트할 수 있습니다.

  9. 필요에 따라 모든 리포지토리에 대해 이 속성 필요를 선택하고 기본값을 추가할 수 있습니다. 즉, 조직의 모든 리포지토리에 이 속성의 값이 있어야 합니다. 이 속성에 대한 명시적 값이 없는 리포지토리는 기본값을 상속합니다.

  10. 속성 저장을 클릭하세요.

조직의 리포지토리 값 설정

사용자 및 "조직 수준에서 사용자 지정 속성 값 편집" 권한이 있는 모든 사용자는 조직의 리포지토리에 대한 사용자 지정 속성에 대한 값을 설정할 수 있습니다.

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.

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

  3. 왼쪽 사이드바의 "코드, 계획 및 자동화" 섹션에서 리포지토리를 클릭한 다음 사용자 지정 속성을 클릭하세요.

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

  4. "값 설정" 탭을 클릭하세요.

  5. 목록에서 하나 이상의 리포지토리를 선택하고 속성 편집을 클릭하세요.

    리포지토리의 값을 설정하는 페이지를 스크린샷으로 표시합니다. 연필 아이콘과 "속성 편집"이라는 레이블이 지정된 버튼이 주황색 윤곽선으로 강조 표시됩니다.

  6. 표시되는 모달 대화 상자에서 선택한 리포지토리에 대해 설정할 각 속성의 값을 선택하세요.

  7. 변경 내용 저장을 클릭합니다.

조직의 리포지토리 값 보기

리포지토리에 대한 읽기 권한이 있는 사람 해당 리포지토리의 사용자 지정 속성 값을 볼 수 있지만 해당 값을 편집할 수는 없습니다.

REST API를 사용하여 조직에서 리포지토리에 할당된 사용자 지정 속성을 나열할 수도 있습니다. 자세한 정보는 "사용자 지정 속성에 대한 REST API 엔드포인트" 항목을 참조하세요.

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

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

    탭을 보여 주는 리포지토리 헤더의 스크린샷. "설정" 탭이 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 사이드바의 "Code and automation" 섹션에서 Custom properties을 클릭하세요.

사용자 지정 속성 값을 사용하여 리포지토리 검색 및 필터링

사용자 지정 속성 값을 사용하여 조직에서 리포지토리를 검색할 수 있습니다.

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.
  2. 조직 이름을 클릭합니다.
  3. 조직 이름 아래에서 리포지토리를 클릭하세요.
  4. 검색 창에 prop을(를) 입력하여 조직의 모든 사용자 지정 속성 목록을 표시하고 검색할 속성을 선택하세요.