Gerenciando propriedades personalizadas para repositórios em sua empresa

Crie propriedades personalizadas para proporcionar às organizações uma maneira consistente de categorizar repositórios.

Quem pode usar esse recurso?

Enterprise owners

Neste artigo

Note

As propriedades personalizadas para sua empresa estão em versão prévia pública e estão sujeitas a alterações.

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.

Promovendo propriedades de organização para propriedades empresariais

Você pode promover uma propriedade de uma organização para sua conta corporativa, a fim de garantir que o nome e os valores da propriedade estejam disponíveis para uso em todas as organizações da empresa.

  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 ver todas as propriedades gerenciadas pelas organizações, selecione Filter e escolha o qualificador Managed by e organization como valor, ou insira managed-by:organization na barra de filtros.
  5. Opcionalmente, para ver as propriedades gerenciadas por uma organização específica, selecione Filter, escolha o qualificador Organization e um nome de organização como valor, ou insira org:<ORGANIZATION-NAME> na barra de filtros.
  6. Na lista de propriedades, selecione o nome da propriedade que deseja promover. Isso leva você à página de detalhes da propriedade.
  7. Para promover a propriedade selecionada, clique em Promote to enterprise. O nome da propriedade deve ser exclusivo em todas as organizações da empresa, caso contrário, a promoção não será permitida.
  8. Clique em Promover.