이 버전의 GitHub Enterprise Server는 다음 날짜에 중단됩니다. 2026-10-14. 지원되지 않는 릴리스는 지원되지 않습니다. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. GitHub Enterprise Server의 향상된 성능, 향상된 보안 및 새로운 기능은 업그레이드 프로세스의 오버뷰 참조하세요. 업그레이드에 대한 도움이 필요하면 GitHub Enterprise 지원에 문의하세요.

엔터프라이즈의 리포지토리에 대한 사용자 지정 속성 관리

사용자 지정 속성을 만들어 조직에 리포지토리를 일관되게 분류할 수 있는 방법을 제공합니다.

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

Enterprise owners

이 기사에서

사용자 지정 속성을 사용하면 규정 준수 프레임워크, 데이터 민감도 또는 프로젝트 세부 정보와 같은 정보를 사용하여 리포지토리를 데코레이트할 수 있습니다. 사용자 지정 속성은 프라이빗이며 리포지토리에 대한 읽기 권한이 있는 사용자만 볼 수 있습니다. 엔터프라이즈에는 최대 100개의 속성 정의가 있을 수 있습니다. 허용되는 값 목록에는 최대 200개 항목이 포함될 수 있습니다.

엔터프라이즈 수준에서 사용자 지정 속성을 정의하면 사용자가 리포지토리에 적용할 수 있는 일관된 값을 만들 수 있습니다. 사용자 지정 속성을 사용하면 특정 속성이 있는 리포지토리를 대상으로 하는 규칙 집합 만들어 엔터프라이즈의 리포지토리에 일관된 거버넌스를 적용할 수 있습니다.

허용되는 문자

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

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

사용자 자신이 정의한 사용자 지정 속성의 값을 설정하고 볼 수 있는 권한은 누구에게 있나요?

사용자 지정 속성을 정의한 후, 사용자는 엔터프라이즈의 리포지토리에서 해당 속성의 값을 설정할 수 있습니다. 조직의 리포지토리에 대한 사용자 지정 속성 관리을(를) 참조하세요.

  • 엔터프라이즈 소유자는 필수 속성의 기본값을 설정할 수 있습니다.
  • 조직 소유자는 리포지토리 전체 또는 개별 리포지토리 수준에서 조직의 설정 값을 설정할 수 있습니다.
  • 사용하도록 설정된 경우, 리포지토리 액세스 권한이 있는 사용자 또는 custom properties 세분화된 권한이 있는 사용자는 사용자의 리포지토리 속성 값을 설정하고 업데이트할 수 있습니다.

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

또한 조직 소유자는 사용자 지정 속성 값으로 조직의 리포지토리를 검색할 수도 있습니다. 조직의 리포지토리에 대한 사용자 지정 속성 관리을(를) 참조하세요.

에 사용자 지정 속성 추가 GitHub

엔터프라이즈에 사용자 지정 속성을 추가하여 모든 조직에서 해당 속성을 사용할 수 있도록 할 수 있습니다.

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 Enterprise settings를 차례로 클릭합니다.

  2. 왼쪽 사이드바의 "Policies"에서 Custom properties를 클릭합니다.

  3. 새 사용자 지정 속성을 추가하려면 오른쪽 위 모서리에 있는 New property를 클릭합니다.

  4. 사용자 지정 속성의 이름, 설명, 유형을 입력합니다. 이름은 모든 조직에서 고유해야 하며 공백을 포함할 수 없으며 길이가 75자를 초과할 수 없습니다.

  5. 필요에 따라 저장소 액터가 이 속성을 설정하도록 허용를 선택할 수 있습니다. 사용하도록 설정하면 리포지토리 수준 custom properties 세분화된 사용 권한이 있는 리포지토리 사용자 및 앱이 해당 리포지토리의 속성 값을 설정하고 업데이트할 수 있습니다. 또한 리포지토리를 만드는 모든 행위자는 리포지토리에서 속성을 설정할 수 있습니다.

  6. 필요에 따라 Require this property for all repositories를 선택하고 기본값을 추가할 수 있습니다. 즉, 엔터프라이즈의 모든 리포지토리에 이 속성의 값이 있어야 합니다. 이 속성에 대한 명시적 값이 없는 리포지토리는 기본값을 상속합니다.

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

조직 속성을 엔터프라이즈 속성으로 승격

조직의 속성을 enterprise 계정으로 통합하면, 해당 속성 이름과 값을 전체 조직에서 일관되게 공유하고 활용할 수 있습니다.

  1. GitHub Enterprise Server의 오른쪽 위 모서리에서 프로필 사진과 Enterprise settings를 차례로 클릭합니다.
  2. 왼쪽 사이드바의 "Policies"에서 Custom properties를 클릭합니다.
  3. 조직에서 관리하는 모든 속성을 보려면 Filter를 선택한 다음, Managed by 및 organization 한정자를 값으로 선택하거나 또는 필터 표시줄에 managed-by:organization을 입력합니다.
  4. 선택적으로 특정 조직에서 관리하는 속성을 보려면 Filter를 선택한 다음, Organization 및 Organization 이름 한정자를 값으로 선택하거나 또는 필터 표시줄에 org:<ORGANIZATION-NAME>을 입력합니다.
  5. 속성 목록에서 승격하려는 속성 이름을 선택합니다. 그러면 속성 세부 정보 페이지로 이동하게 됩니다.
  6. 선택한 속성을 승격하려면 Promote to enterprise를 클릭합니다. enterprise 내 모든 조직에서 속성 이름의 중복을 허용하지 않으며, 고유성이 보장되지 않을 경우 프로모션 진행이 제한됩니다.
  7. 승격을 클릭합니다.