Skip to main content

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

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

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

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.

사용자 지정 속성 정보

사용자 지정 속성은 GitHub의 리포지토리 및 조직에 추가하여 환경 전체에서 더 나은 조직, 거버넌스 및 자동화를 가능하게 하는 구조화된 메타데이터 필드입니다.

이 문서는 리포지토리 사용자 지정 속성과 관련이 있습니다.

사용자 지정 속성의 표시 유형은 리포지토리의 표시 유형과 일치합니다. 공용 리포지토리의 사용자 지정 속성은 누구나 볼 수 있으며, 내부 또는 프라이빗 리포지토리의 사용자 지정 속성은 리포지토리에 대한 권한이 있는 read 계정에서 볼 수 있습니다.

허용되는 문자

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

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

사용자 지정 속성 추가

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

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

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

  3. 왼쪽 사이드바의 "Code, planning, and automation" 섹션에서 Repository를 클릭한 다음 Custom properties를 클릭합니다.

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

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

  5. "Name(이름)" 필드에 사용자 지정 속성에 사용할 이름을 입력하세요. 이름에는 공백을 포함할 수 없으며 길이가 75자를 초과할 수 없습니다.

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

  7. "Type(유형)" 아래에서 추가하려는 속성 유형을 선택하세요. 텍스트 문자열일 수 있습니다.

  8. 필요에 따라 리포지토리 작업자가 이 속성을 설정하도록 허용을 선택할 수 있습니다. 이 옵션이 활성화되면 리포지토리 수준의 "사용자 지정 속성사용자 지정 속성" 세분화된 권한을 가진 리포지토리 사용자와 앱이 자신의 리포지토리에 대한 속성 값을 설정하고 업데이트할 수 있습니다.

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

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

조직의 리포지토리에 대한 값 설정

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

  1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

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

  3. 왼쪽 사이드바의 "Code, planning, and automation" 섹션에서 Repository를 클릭한 다음 Custom properties를 클릭합니다.

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

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

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

    리포지토리에 대한 값을 설정하는 페이지의 스크린샷입니다. 연필 아이콘과 "속성 편집"이라는 레이블이 있는 버튼이 주황색 윤곽선으로 강조 표시되어 있습니다.

  6. 표시되는 모달 대화 상자에서 선택한 리포지토리에 대해 설정하려는 각 속성의 값을 선택하세요. 이 값은 길이가 75자를 초과할 수 없습니다.

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

조직의 리포지토리에 대한 값 보기

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

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

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

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

  3. 사이드바의 "Code and automation(코드 및 자동화)" 섹션에서 사용자 지정 속성을 클릭하세요.

사용자 지정 속성 값으로 리포지토리 검색 및 필터링

조직의 리포지토리를 사용자 지정 속성 값으로 검색할 수 있습니다.

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