사용자 지정 속성 정보
사용자 지정 속성을 사용하면 규정 준수 프레임워크, 데이터 민감도 또는 프로젝트 세부 정보와 같은 정보를 사용하여 리포지토리를 데코레이트할 수 있습니다. 사용자 지정 속성은 프라이빗이며 리포지토리에 대한 읽기 권한이 있는 사용자만 볼 수 있습니다.
조직에는 최대 100개의 속성 정의가 있을 수 있습니다. 허용되는 값 목록에는 최대 200개 항목이 포함될 수 있습니다.
리포지토리 속성을 사용하여 규칙 집합을 통해 대상으로 지정할 리포지토리를 결정할 수 있습니다. 자세한 정보는 "조직에서 리포지토리에 대한 규칙 집합 만들기" 항목을 참조하세요.
허용되는 문자
사용자 지정 속성 이름 및 값은 특정 문자만 포함할 수 있습니다.
- 이름:
a-z
,A-Z
,0-9
,_
,-
,$
,#
. - 값:
"
를 제외한 인쇄 가능한 모든 ASCII 문자.
사용자 지정 속성 추가
조직에 사용자 지정 속성을 추가하고 조직의 리포지토리에 대한 해당 속성에 대한 값을 설정할 수 있습니다.
-
GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.
-
조직 옆에 있는 설정을 클릭합니다.
-
왼쪽 사이드바의 "코드, 계획 및 자동화" 섹션에서 리포지토리를 클릭한 다음 사용자 지정 속성을 클릭하세요.
-
새 사용자 지정 속성을 추가하려면 오른쪽 위 모서리에 있는 새 속성을 클릭하세요.
-
사용자 지정 속성에 사용할 이름을 "이름" 필드에 입력하세요. 이름은 공백을 포함할 수 없습니다.
-
필요에 따라 "설명" 필드에서 사용자 지정 속성에 대한 설명을 입력하세요.
-
"형식"에서 추가할 속성의 유형을 선택하세요. 텍스트 문자열, 단일 선택 필드일 수 있습니다.
-
필요에 따라 리포지토리 행위자가 이 속성을 설정하도록 허용을 선택할 수 있습니다. 사용하도록 설정하면 리포지토리 수준 "사용자 지정 속성" 세분화된 사용 권한이 있는 리포지토리 사용자 및 앱이 해당 리포지토리의 속성 값을 설정하고 업데이트할 수 있습니다.
-
필요에 따라 모든 리포지토리에 대해 이 속성 필요를 선택하고 기본값을 추가할 수 있습니다. 즉, 조직의 모든 리포지토리에 이 속성의 값이 있어야 합니다. 이 속성에 대한 명시적 값이 없는 리포지토리는 기본값을 상속합니다.
-
속성 저장을 클릭하세요.
조직의 리포지토리 값 설정
사용자 및 "조직 수준에서 사용자 지정 속성 값 편집" 권한이 있는 모든 사용자는 조직의 리포지토리에 대한 사용자 지정 속성에 대한 값을 설정할 수 있습니다.
-
GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.
-
조직 옆에 있는 설정을 클릭합니다.
-
왼쪽 사이드바의 "코드, 계획 및 자동화" 섹션에서 리포지토리를 클릭한 다음 사용자 지정 속성을 클릭하세요.
-
"값 설정" 탭을 클릭하세요.
-
목록에서 하나 이상의 리포지토리를 선택하고 속성 편집을 클릭하세요.
-
표시되는 모달 대화 상자에서 선택한 리포지토리에 대해 설정할 각 속성의 값을 선택하세요.
-
변경 내용 저장을 클릭합니다.
조직의 리포지토리 값 보기
리포지토리에 대한 읽기 권한이 있는 사람 해당 리포지토리의 사용자 지정 속성 값을 볼 수 있지만 해당 값을 편집할 수는 없습니다.
-
GitHub에서 리포지토리의 기본 페이지로 이동합니다.
-
리포지토리 이름 아래에서 Settings(설정)를 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.
-
사이드바의 "Code and automation" 섹션에서 Custom properties을 클릭하세요.
사용자 지정 속성 값을 사용하여 리포지토리 검색 및 필터링
사용자 지정 속성 값을 사용하여 조직에서 리포지토리를 검색할 수 있습니다.
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.
- 조직 이름을 클릭합니다.
- 조직 이름 아래에서 리포지토리를 클릭하세요.
- 검색 창에
prop
을(를) 입력하여 조직의 모든 사용자 지정 속성 목록을 표시하고 검색할 속성을 선택하세요.