Gerenciando propriedades personalizadas para repositórios em sua empresa

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. Confira Controlando como as pessoas usam repositórios em sua empresa.

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 properties refinada 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.

1. No canto superior direito do GitHub, selecione sua foto de perfil.
2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
3. Na barra lateral esquerda, em "Policies", clique em Custom properties.
4. Para adicionar uma nova propriedade personalizada, no cando superior direito, clique em New property.
5. Insira um nome, uma descrição e um tipo para a propriedade personalizada. O nome deve ser exclusivo em todas as suas organizações e não pode conter espaços.
6. Opcionalmente, selecione Allow repository actors to set this property. Quando essa opção está habilitada, os usuários e os aplicativos do repositório com a permissão refinada custom properties no 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.
7. Opcionalmente, selecione Require this property for all repositories 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.
8. Clique em Salvar propriedade.