Como gerenciar propriedades personalizadas para repositórios na sua organização

Sobre propriedades personalizadas

As propriedades personalizadas são campos de metadados estruturados que você pode adicionar a repositórios e organizações em GitHub para habilitar uma melhor organização, governança e automação em seu ambiente.

Este artigo refere-se a propriedades personalizadas do repositório.

A visibilidade das propriedades personalizadas corresponde à visibilidade do repositório. As propriedades personalizadas em repositórios públicos podem ser exibidas por qualquer pessoa, enquanto as propriedades personalizadas em repositórios internos ou privados podem ser exibidas por contas com read permissões para o repositório.

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 "

adicionar propriedades personalizadas

Você pode adicionar propriedades personalizadas à sua organização e definir valores para essas propriedades para repositórios em sua organização.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Custom properties.

   

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

6. No campo "Nome", digite o nome que gostaria de usar para sua propriedade personalizada. O nome não pode conter espaços nem pode exceder 75 caracteres de comprimento.

7. Opcionalmente, no campo "Descrição", digite uma descrição da sua propriedade personalizada.

8. Em "Tipo", selecione o tipo de propriedade que você deseja adicionar. Isso pode ser uma cadeia de caracteres de texto, um campo de seleção única, um campo de seleção múltipla, ou um booleano verdadeiro/falso.

9. Opcionalmente, é possível selecionar Permitir que atores do repositório configurem esta propriedade. Quando habilitada, os usuários e os aplicativos do repositório com a permissão refinada de “propriedades personalizadas” no nível do repositório poderão definir e atualizar o valor da propriedade para o repositório.

10. Opcionalmente, você pode selecionar Exigir esta propriedade para todos os repositórios e adicionar um valor padrão. Isso significa que você exige que todos os repositórios em sua organização 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.

11. Clique em Salvar propriedade.

Como definir valores para repositórios em sua organização

Você e todos os usuários com a permissão "Editar valores de propriedades personalizadas no nível da organização", podem definir valores para propriedades personalizadas para repositórios em sua organização.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Custom properties.

   

5. Clique na guia "Definir valores".

6. Selecione um ou mais repositórios na lista e clique em Edit properties.

   

7. Na caixa de diálogo modal exibida, selecione um valor para cada propriedade que você deseja definir para os repositórios selecionados. Esse valor não pode exceder 75 caracteres de comprimento.

8. Selecione Salvar alterações.

Como visualizar valores de repositórios na sua organização

As pessoas com permissões de leitura para um repositório podem visualizar os valores das propriedades personalizadas desse repositório, mas não podem editar esses valores.

1. Em GitHub, acesse a página principal do repositório.

2. No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

3. Na seção "Code and automation" da barra lateral, selecione Custom properties.

Como localizar e filtrar repositórios por valores de propriedades personalizadas

Você pode localizar repositórios em sua organização por valores de propriedades personalizadas.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.
2. Clique no nome da sua organização.
3. Sob o nome da organização, clique em Repositories.
4. Na barra de pesquisa, digite prop para ver uma lista de todas as propriedades personalizadas em sua organização, e selecione a propriedade pela qual você deseja pesquisar.