Управление настраиваемыми свойствами для репозиториев в организации

Создайте настраиваемые свойства, чтобы обеспечить организациям согласованный способ классификации репозиториев.

Кто может использовать эту функцию?

Enterprise owners

В этой статье

Пользовательские свойства позволяют декорировать репозитории такими сведениями, как платформы соответствия требованиям, конфиденциальность данных или сведения о проекте. Пользовательские свойства являются частными и могут просматриваться только пользователями с разрешениями на чтение в репозитории. У предприятия может быть до 100 определений свойств. Список разрешенных значений может содержать до 200 элементов.

Определение настраиваемых свойств на корпоративном уровне позволяет создавать согласованные значения, которые пользователи могут применять к репозиториям. Используя настраиваемые свойства, вы можете применить согласованное управление в репозиториях в организации, создав набор правил или политику репозитория, предназначенные для репозиториев с определенными свойствами.

Допустимые символы

Имена и значения настраиваемых свойств могут содержать только определенные символы:

  • Имена: a-z, A-Z, 0-9, _``-``$``#
  • Значения: Все печатные символы ASCII, за исключением "

Кто может задать и просмотреть значения для настраиваемых свойств, которые я определяю?

После определения пользовательского свойства пользователи могут задать значение этого свойства в репозиториях предприятия. См . раздел AUTOTITLE.

  • Как владелец предприятия можно задать значение по умолчанию для обязательных свойств.
  • Владельцы организации могут задавать значения в своей организации в разных репозиториях или на уровне репозитория.
  • Если он включен, пользователи с доступом к репозиторию или custom properties подробным разрешением могут задать и обновить значение свойства для своего репозитория.

Пользователи с разрешениями на чтение в репозитории могут просматривать пользовательские значения свойств для этого репозитория.

Кроме того, владелец организации могут искать репозитории в организации по значениям настраиваемых свойств. См . раздел AUTOTITLE.

Добавление пользовательских свойств

Вы можете добавить настраиваемые свойства в свое предприятие, чтобы сделать эти свойства доступными во всех организациях.

  1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.

  2. В левой боковой панели в разделе "Политики" щелкните "Настраиваемые свойства".

  3. Чтобы добавить новое настраиваемое свойство, в правом верхнем углу нажмите кнопку "Создать свойство".

  4. Введите имя, описание и тип пользовательского свойства. Название должно быть уникальным для всех ваших организаций, не содержать пробелов и не превышать 75 символов в длину.

  5. При необходимости выберите "Разрешить актерам репозитория", чтобы задать это свойство. Если этот параметр включен, пользователи репозитория и приложения с подробным разрешением на уровне custom properties репозитория смогут задать и обновить значение свойства для своего репозитория. Кроме того, любой субъект, создающий репозиторий, может задать свойство в репозитории.

  6. При необходимости выберите " Требовать это свойство" для всех репозиториев и добавьте значение по умолчанию. Это означает, что требуется, чтобы все репозитории в вашей организации имели значение для этого свойства. Репозитории, не имеющие явного значения для этого свойства, наследуют значение по умолчанию.

    • По желанию вы можете выбрать «Требовать явно указанные пользователем значения». Когда эта опция включена, пользователи и приложения с разрешением устанавливать значения свойств должны указывать явное значение при настройке свойств, создании репозиториев или переносе репозиториев. Репозитории, которые ещё не имеют явного значения, всё равно будут наследовать значение по умолчанию.

  7. Нажмите кнопку " Сохранить свойство".

Продвижение свойств организации в корпоративные свойства

Вы можете повысить уровень собственности от организации к вашей корпоративной учетной записи, чтобы гарантировать, что имя и значения свойств доступны для использования во всех организациях в организации.

  1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
  2. В левой боковой панели в разделе "Политики" щелкните "Настраиваемые свойства".
  3. Чтобы просмотреть все свойства, управляемые организациями, выберите фильтр и выберите квалификатор , управляемый и **** организацией в качестве значения, или введите managed-by:organization в строке фильтра.
  4. При необходимости, чтобы просмотреть свойства, управляемые определенной организацией, выберите фильтр и выберите квалификатор организации и имя организации в качестве значения или введите org:<ORGANIZATION-NAME> в строке фильтра.
  5. В списке свойств выберите имя свойства, которое требуется повысить. При этом вы перейдете на страницу сведений о свойстве.
  6. Чтобы повысить выбранное свойство, нажмите кнопку "Продвинуть до предприятия". Имя свойства должно быть уникальным во всех организациях в организации, в противном случае повышение не будет разрешено.
  7. Выберите Повысить уровень.