As propriedades personalizadas permitem decorar seus repositórios com informações como estruturas de conformidade, confidencialidade de dados ou detalhes do projeto. As propriedades personalizadas são particulares e só podem ser visualizadas por pessoas com permissões de leitura para o repositório. Uma empresa pode ter até 100 definições de propriedade. Uma lista de valores permitidos pode ter até 200 itens.
Definir propriedades personalizadas no nível da empresa permite que você crie valores consistentes que os usuários podem aplicar a repositórios. Com propriedades personalizadas em vigor, você pode aplicar uma governança consistente entre os repositórios em sua empresa criando um conjunto de regras ou uma política de repositório direcionada a repositórios com determinadas propriedades.
Caracteres permitidos
Nomes e valores de propriedades personalizadas apenas podem conter determinados caracteres:
- Nomes:
a-z,A-Z,0-9,_,-,$,# - Valores: todos os caracteres ASCII imprimíveis, exceto
"
Quem pode definir e exibir valores para as propriedades personalizadas definidas por mim?
Após você definir uma propriedade personalizada, os usuários podem definir um valor para essa propriedade nos repositórios da empresa. Confira Como gerenciar propriedades personalizadas para repositórios na sua organização.
- Como proprietário da empresa, você pode definir um valor padrão para as propriedades necessárias.
- Os proprietários da organização podem definir valores nas respectivas organizações, seja entre repositórios ou no nível do repositório.
- Se habilitados, pessoas com acesso ao repositório ou com a permissão
custom propertiesrefinada podem definir e atualizar o valor da propriedade para o repositório.
Pessoas com permissões de leitura para um repositório podem exibir os valores da propriedade personalizada desse repositório.
Além disso, proprietários de organizações podem procurar repositórios em suas organizações segundo os valores das propriedades personalizadas. Confira Como gerenciar propriedades personalizadas para repositórios na sua organização.
adicionar propriedades personalizadas
Você pode adicionar propriedades personalizadas à sua empresa para disponibilizar essas propriedades em todas as suas organizações.
-
Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
-
Na barra lateral esquerda, em "Policies", clique em Custom properties.
-
Para adicionar uma nova propriedade personalizada, no canto superior direito, clique em Nova propriedade.
-
Insira um nome, uma descrição e um tipo para a propriedade personalizada. O nome deve ser exclusivo em todas as suas organizações, não pode conter espaços e não pode exceder 75 caracteres de comprimento.
-
Opcionalmente, selecione Permitir que os atores do repositório definam esta propriedade. Quando essa opção está habilitada, os usuários e os aplicativos do repositório com a permissão refinada
custom propertiesno nível do repositório poderão definir e atualizar o valor da propriedade para o repositório. Além disso, qualquer ator que cria um repositório pode definir a propriedade nele. -
Opcionalmente, selecione Exigir essa propriedade para todos os repositórios e adicione um valor padrão. Isso significa que você exige que todos os repositórios em sua empresa tenham um valor para essa propriedade. Os repositórios que não tiverem um valor explícito para essa propriedade herdarão o valor padrão.
- Opcionalmente, você pode selecionar Exigir valores explícitos especificados pelo usuário. Quando essa opção está habilitada, usuários e aplicativos com permissão para definir valores de propriedade devem fornecer um valor explícito ao definir propriedades, criar repositórios ou transferir repositórios. Repositórios que ainda não têm um valor explícito ainda herdarão o valor padrão.
-
Clique em Salvar propriedade.
Próximas etapas
Aplique políticas a repositórios com base em suas propriedades personalizadas. Confira Definindo políticas para repositórios em sua empresa.