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 governança consistente entre repositórios em sua empresa criando um conjunto de regras ou política de repositório direcionando 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. Consulte 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. Consulte Como gerenciar propriedades personalizadas para repositórios na sua organização.

Sobre sugestões de propriedades personalizadas

Quando você cria uma propriedade de seleção única ou de seleção múltipla, Copilot pode sugerir valores permitidos para a definição de propriedade. Selecione uma sugestão para adicioná-la à lista de valores permitidos.

Esse recurso está disponível com Copilot Business ou Copilot Enterprise. Por padrão, as sugestões são habilitadas para propriedades de nível empresarial e cada organização pode decidir se deseja habilitar sugestões. Em vez disso, os proprietários da empresa podem habilitar ou desabilitar sugestões globalmente com a política Sugestões de propriedades personalizadas do repositório. Consulte Gerenciando políticas e recursos para GitHub Copilot em sua empresa.

Sincronizando propriedades personalizadas com um sistema externo

Você pode gravar automaticamente metadados de um sistema externo, como um catálogo de software ou um portal interno para desenvolvedores, nas propriedades personalizadas do repositório no GitHub. Isso torna o sistema externo a fonte da verdade para essas propriedades e ajuda você a manter o contexto de negócios, como propriedade, camada de serviço ou status de conformidade atualizado em seus repositórios. As propriedades externas podem ser usadas nos mesmos locais que as propriedades personalizadas gerenciadas em GitHub.

As propriedades personalizadas externas são configuradas separadamente para cada organização. Para obter instruções de configuração, confira Integrando propriedades personalizadas a um sistema externo.

Adicionando propriedades personalizadas em GitHub

Você pode adicionar propriedades personalizadas à sua empresa para disponibilizar essas propriedades em todas as suas organizações.

1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.

2. Na barra lateral esquerda, em "Policies", clique em Custom properties.

3. Para adicionar uma nova propriedade personalizada, no canto superior direito, clique em Nova propriedade.

4. 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.

   Se você selecionou um único tipo de seleção ou de várias seleções, Copilot pode sugerir valores permitidos para a definição de propriedade. Selecione Aceitar sugestão para adicioná-la à lista de valores permitidos.

5. 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 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.

6. 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.

7. 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. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
2. Na barra lateral esquerda, em "Policies", clique em Custom properties.
3. 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.
4. 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.
5. Na lista de propriedades, selecione o nome da propriedade que deseja promover. Isso leva você à página de detalhes da propriedade.
6. Para promover a propriedade selecionada, clique em Promover para empresa. O nome da propriedade deve ser exclusivo em todas as organizações da empresa; caso contrário, não será possível realizar a promoção.
7. Clique em Promover.