Chapters ▾ 2nd Edition

6.4 GitHub - Gerenciando uma Organização

Gerenciando uma Organização

Além das contas de usuário único, o GitHub tem o que são chamadas de Organizações (Organizations). Como as contas pessoais, as contas de Organizações têm um namespace onde todos os seus projetos existem, mas muitas outras coisas são diferentes. Essas contas representam um grupo de pessoas com propriedade compartilhada de projetos e existem muitas ferramentas para gerenciar subgrupos dessas pessoas. Normalmente, essas contas são usadas por grupos Open Source (como “perl” ou “rails”) ou empresas (como “google” ou “twitter”).

O Básico de uma Organização

Uma organização é muito fácil de criar; basta clicar no ícone “+” no canto superior direito de qualquer página do GitHub e selecionar “New organization” (Nova organização) no menu.

O item de menu "New organization"
Figure 125. O item de menu “New organization”

Primeiro você precisará nomear a sua organização e fornecer um endereço de e-mail para um ponto de contato principal para o grupo. Em seguida, você pode convidar outros usuários para serem coproprietários da conta, se desejar.

Siga essas etapas e você logo será o proprietário de uma organização novinha em folha. Como as contas pessoais, as organizações são gratuitas se tudo o que você planeja armazenar lá for de código aberto.

Como proprietário de uma organização, ao fazer fork de um repositório, você terá a opção de fazer o fork dele para o namespace da sua organização. Ao criar novos repositórios, você pode criá-los em sua conta pessoal ou em qualquer uma das organizações das quais é proprietário. Você também observa (“watch”) automaticamente qualquer novo repositório criado sob essas organizações.

Assim como em O Seu Avatar, você pode fazer o upload de um avatar para a sua organização para personalizá-la um pouco. Também como as contas pessoais, você tem uma página de destino (landing page) para a organização que lista todos os seus repositórios e pode ser visualizada por outras pessoas.

Agora vamos cobrir algumas das coisas que são um pouco diferentes com uma conta organizacional.

Equipes (Teams)

Organizações são associadas a pessoas individuais por meio de equipes, que são simplesmente um agrupamento de contas de usuários individuais e repositórios dentro da organização, e o tipo de acesso que essas pessoas têm nesses repositórios.

Por exemplo, digamos que a sua empresa tenha três repositórios: frontend, backend e deployscripts. Você gostaria que os seus desenvolvedores de HTML/CSS/JavaScript tivessem acesso ao frontend e talvez ao backend, e que o seu pessoal de Operações tivesse acesso ao backend e deployscripts. As equipes tornam isso fácil, sem ter que gerenciar os colaboradores de cada repositório individual.

A página da Organização mostra um painel simples de todos os repositórios, usuários e equipes que estão sob essa organização.

A página da Organização
Figure 126. A página da Organização

Para gerenciar as suas Equipes (Teams), você pode clicar na barra lateral Equipes (Teams) no lado direito da página em A página da Organização. Isso levará você a uma página que você pode usar para adicionar membros à equipe, adicionar repositórios à equipe ou gerenciar as configurações e níveis de controle de acesso para a equipe. Cada equipe pode ter acesso somente de leitura, leitura/gravação ou administrativo aos repositórios. Você pode alterar esse nível clicando no botão “Settings” (Configurações) em A página da Equipe.

A página da Equipe
Figure 127. A página da Equipe

Quando você convidar alguém para uma equipe, ele receberá um e-mail avisando que foi convidado.

Além disso, as menções à equipe, @mentions (como @acmecorp/frontend), funcionam da mesma forma que com usuários individuais, exceto que todos os membros da equipe são então inscritos na thread. Isso é útil se você quiser a atenção de alguém de uma equipe, mas não sabe exatamente para quem perguntar.

Um usuário pode pertencer a qualquer número de equipes, então não se limite apenas a equipes de controle de acesso. Equipes de interesse especial como ux, css ou refactoring (refatoração) são úteis para certos tipos de perguntas, e outras como legal (jurídico) e colorblind (daltônico) para um tipo totalmente diferente.

Log de Auditoria (Audit Log)

As organizações também dão aos proprietários acesso a todas as informações sobre o que aconteceu sob a organização. Você pode ir até a aba 'Audit Log' (Log de Auditoria) e ver quais eventos aconteceram em um nível de organização, quem os fez e em que lugar do mundo eles foram feitos.

O Log de Auditoria
Figure 128. O Log de Auditoria

Você também pode filtrar por tipos específicos de eventos, locais específicos ou pessoas específicas.