Introdução ao GitHub Enterprise
Aqui, você encontrará tudo o que precisa saber sobre o uso do GitHub Enterprise, desde melhorar as práticas de desenvolvimento de software até garantir uma implementação tranquila para todos em sua organização. Vamos começar.
Neste guia
Instale e comece a usar o GitHub Enterprise — Enterprise Server local, Enterprise Cloud ou ambos
Defina e atinja objetivos de integração para os primeiros trinta dias a três meses da sua equipe
Contorne (e prepare-se para) desafios comuns de usuários iniciantes
Dicas de profissional
Para ajudar todos a adotarem rapidamente o GitHub Enterprise, identifique um grupo de “campeões do GitHub” em sua organização que incentivarão outros membros da equipe a começar imediatamente. Quanto mais rapidamente sua equipe usar o GitHub, mais rapidamente você poderá entregar.
Consulte o Glossário do GitHub para saber mais sobre Git e termos específicos do GitHub que nós usamos em nossos sites e em nossa documentação.
Parte um: Instalação do GitHub
A instalação e configuração corretas são os primeiros passos para garantir que sua organização possa usar o GitHub de maneira eficaz. Nós o guiaremos pelos os conceitos básicos da instalação, além de como verificar sua(s) conta(s), definir suas configurações de segurança e preparar suas equipes para construir.
Configurando o GitHub Enterprise
Para começar a usar o GitHub Enterprise Server, você precisará instalar a instância da sua organização em uma plataforma de virtualização de sua escolha. Usando o Enterprise Cloud? Faça login em sua organização Enterprise Cloud em GitHub.com e vá para a etapa sete.
Leia mais sobre provisionamento e instalação.
Usando o console de gerenciamento
O console de gerenciamento ajudará você nas tarefas administrativas diárias. Use o console de gerenciamento para orientá-lo na configuração inicial, definir configurações para sua instância, agendar manutenção e muito mais.
Leia mais sobre o console de gerenciamento baseado na Web..
Autenticando usuários para sua instância do GitHub Enterprise
Escolha seu método de autenticação: autenticação integrada do Enterprise Server ou LDAP, SAML ou CAS pré-existente. Não tem certeza de qual método é adequado para sua equipe? Você poderá alternar a qualquer momento.
Leia mais sobre autenticando usuários para sua instância do GitHub Enterprise.
Configurando para alta disponibilidade
Tenha o máximo possível de tempo de atividade. Configurar sua instância do Enterprise Server para alta disponibilidade garante que quaisquer falhas de hardware ou grandes interrupções na rede não interrompam o serviço.
Leia mais sobre a configuração de alta disponibilidade.
Designando backups e recuperação de desastre
Como uma camada extra de proteção, configure o GitHub Enterprise Server Backup Utilities. Você poderá fazer backup da sua instância do Enterprise Server em um sistema de host Linux ou Unix, idealmente em uma localização geográfica diferente.
Leia mais sobre backups e recuperação de desastre.
Usando georreplicação
Se sua organização tem escritórios em vários locais, a georreplicação no GitHub Enterprise Server pode ajudar a reduzir a latência entre diferentes hosts e locais, para que suas equipes obtenham os dados de que precisam com rapidez. Para usar a georreplicação, você também precisará usar um DNS voltado para geolocalização.
Leia mais sobre georreplicação.
Confirmando suas contas do Git e do GitHub
Dependendo se você está usando o Enterprise Server ou o Enterprise Cloud, você pode se registrar e verificar seu endereço principal de email ou configurar sua instância para enviar uma notificação por email sobre problemas, pull request ou commits.
Leia mais sobre a configuração do Git e do GitHub.
Conexão ao GitHub com SSH
Você pode usar o GitHub sem ter que fornecer seu nome de usuário e senha toda vez. Use o protocolo SSH para adicionar uma nova chave SSH à sua conta do GitHub e configurar um agente de autenticação.
Leia mais sobre conectar-se ao GitHub com SSH.
Parte dois: Gerenciamento da sua equipe
O trabalho em conjunto ajuda as equipes a construir e entregar softwares melhores, mais rapidamente. Mas a colaboração bem-sucedida depende de alguns fatores importantes: comunicação, contribuição e administração. O GitHub Enterprise oferece as ferramentas para gerenciar todos eles da maneira que funcione melhor para a sua organização.
Organizando pessoas para uma colaboração bem-sucedida
Sua hierarquia GitHub é composta por usuários individuais, organizações e equipes. Cada um desempenha um papel na forma como seus desenvolvedores colaboram e se comunicam no GitHub.
Comece agrupando usuários individuais da sua organização em equipes do GitHub. Não sabe por onde começar? Crie equipes que reflitam sua estrutura organizacional ou grupos de trabalho atuais. Em seguida, decida a quais repositórios do GitHub suas equipes terão acesso. Os repositórios são onde suas equipes realizarão revisões de código, darão feedback sobre o progresso umas das outras e discutirão o trabalho em andamento.
Sabemos que as equipes mudam de função e assumem novos projetos o tempo todo. Você pode criar novas equipes e gerenciar permissões de repositório sempre que precisar.
Leia mais sobre equipes e repositórios.
Obtendo insights da equipe
Os insights da equipe ajudam você a entender o que está acontecendo em sua organização e por quê. No Enterprise Server ou Enterprise Cloud, você pode ver um resumo de todas as atividades do repositório por meio do Pulse usando a guia Insights. O Pulse mostra com que frequência suas equipes estão encerrando problemas, fazendo o merge de pull request e concluindo trabalhos, facilitando a identificação de padrões (ou possíveis problemas) em seu fluxo de trabalho.
Se estiver usando o Enterprise Server, você também pode verificar seu painel Activity para ver gráficos semanais, mensais e anuais sobre o número de novas pull request, merge de pull request, novos problemas, problemas encerrados e muito mais.
Leia mais sobre o painel Activity.
Conhecendo as ferramentas administrativas
Usando vários produtos GitHub? Supervisione todas as suas contas do GitHub com a identidade de negócios unificada, um recurso do GitHub Connect. Em uma única interface, os administradores podem gerenciar o faturamento geral, o licenciamento, as permissões e aplicar políticas de negócios, independentemente de sua organização implantar em seu próprio servidor ou na nuvem.
Você encontrará uma identidade de negócios unificada nas configurações da organização da sua conta. Aqui, você também pode gerenciar o acesso do usuário, a autenticação e outros detalhes da organização.
Leia mais sobre aplicação de políticas de negócios e permissões baseadas em funções.
Encontrando suporte e ajuda para treinamento
Integrando uma nova plataforma de software é empolgante e queremos que vocês possam começar a construir juntos desde o primeiro dia. Tem alguma dúvida que não foi respondida aqui? Entre em contato com a GitHub Support Team. Dependendo do seu plano do GitHub, você também pode entrar em contato com o Suporte Premium para obter ajuda sob demanda fora do horário comercial normal.
Leia mais sobre o Enterprise Support e Premium Support.
Procurando mais treinamento? A GitHub Professional Services Team pode conectar você com as habilidades que sua organização precisa para trabalhar de maneira mais inteligente. E se você está procurando treinamento para funcionários em grande escala, nosso simpático bot do GitHub Learning Lab ajuda os desenvolvedores a aprender e aplicar novas habilidades por meio de projetos práticos e curtos.
Leia mais sobre Serviços profissionais e Learning Lab para organizações.
Parte três: Construindo com segurança
A segurança é um esforço de equipe, da primeira linha de código até o lançamento de um novo aplicativo. Você pode personalizar com facilidade a sua instância do GitHub Enterprise para se adequar aos padrões de conformidade da sua organização, sem comprometer a inovação. Prepare sua equipe para desenvolver a segurança em primeiro lugar com níveis de permissão exclusivos, logs de auditoria, recursos integrados e muito mais.
Configurando fluxos de trabalho seguros
Depois de convidar sua equipe para colaborar como uma organização, é hora de decidir quem será o proprietário e ajudará a gerenciar a conta da sua organização. Defina níveis de permissão para sua organização com base no acesso administrativo, necessidades de cobrança e diferentes aplicações do GitHubs que você planeja usar. Você também pode adicionar funcionários temporários como colabores externos.
Leia mais sobre níveis de permissão para sua organização e repositórios de propriedade de contas de usuário.
Em seguida, proteja seu trabalho. Use branches protegidas para garantir que ninguém, possa fazer alterações irrevogáveis em um repositório, ou seja, ninguém poderá fazer o merge de branches ou efetuar pull sem passar por determinadas verificações de segurança. Essas verificações incluem verificação de status obrigatória, pela qual todo o código deve passar antes de ser feito o merge dele em uma branch protegida. Você pode estabelecer proteções de branch, verificações de status obrigatórias e restrições de branch nas configurações de sua organização.
Leia mais sobre branches protegidas, verificações de status obrigatórias e restrições de branch.
Mantendo-se em conformidade
As verificações de status obrigatórias também podem ajudar sua equipe a manter e aplicar os padrões de conformidade da organização. Use essas verificações e outras para automatizar seus fluxos de trabalho de conformidade, verificar commits antes que eles sejam aceitos e garantir que sua equipe crie usando processos repetíveis e rastreáveis. O log de auditoria da sua organização também facilita a revisão do trabalho da sua equipe. Descubra quem realizou uma ação, qual ação foi e quando foi realizada.
Leia mais sobre revisão do log de auditoria da sua organização, verificações de commit e hooks de pré-recebimento.
Usando o Enterprise Cloud? O GitHub tem um controle de organização de serviço, ou SOC, para relatórios de organizações de serviço, e o Enterprise Cloud está em conformidade com SOCs 2 tipo e e SOC 1 tipo 1 do AICPA. O Enterprise Cloud também tem autorização da linha de base FedRAMP Tailored dos controles de segurança.
Leia mais sobre relatórios de SOC e autorização do FedRAMP.
Usando recursos de desenvolvimento seguro
Desenvolva código com segurança com recursos de desenvolvimento seguro integrados do GitHub, como alertas de segurança de vulnerabilidades, verificação de segredo e a API GitHub Security Advisory. Seja notificado se algum de seus projetos tiver uma dependência com alguma vulnerabilidade conhecida, incluindo correções sugeridas pela comunidade do GitHub. A verificação de segredo também garante que nunca seja feito commit acidental de tokens e chaves e que não sejam expostos em um repositório público, enquanto a API GitHub Security Advisory integra as atualizações mais recentes de segurança do GitHub em seus próprios projetos.
Leia mais sobre alertas de segurança de vulnerabilidades, verificação de segredo e a API Security Advisory.
Parte quatro: Trabalhando juntos
Com o GitHub Enterprise, sua equipe pode trabalhar em conjunto em projetos de qualquer lugar. Recursos como issues, branches, commits e pull requests possibilitam discutir e revisar código, não importa onde você esteja. Além disso, você pode gerenciar projetos e versões diretamente no GitHub, sem usar ferramentas externas de gerenciamento de projetos.
Noções básicas do GitHub Flow
O GitHub Flow é um fluxo de trabalho leve baseado em branches que ajuda você a fazer alterações e implementar código rapidamente. Usando branches, commits e pull requests, você pode sugerir alterações ao seu código, pedir feedback, deixar comentários e revisar alterações antes que elas sejam aceitas. Quer a ajuda de alguém? Marque a conta da sua equipe ou usuários individuais a qualquer momento, e eles receberão uma notificação imediatamente.
Leia mais sobre o GitHub Flow, mencionando usuários e equipes e revisão de código.
Revisando e discutindo trabalho
Além de branches, commits e pull requests, os problemas ajudam a acompanhar e gerenciar trabalho no GitHub. Criar um novo problema, destacar problemas importantes de seus projetos ou colabore usando problema previamente abertos pela sua equipe. Os problemas (e pull requests) acumulam-se rapidamente. Por isso, use rótulos exclusivos para categorizar e priorizar seu trabalho.
Leia mais sobre problemas e adição de rótulos a problemas e pull requests.
Trabalho de planejamento e monitoramento
Gerentes de projetos e desenvolvedores podem coordenar, monitorar e atualizar seu trabalho, tudo no mesmo lugar. Crie quadros de projetos no GitHub com problemas associados, pull request e notas e, em seguida, use marcos para monitorar seu progresso em direção às metas da equipe. Quando seu projeto estiver pronto para ser visto pelo mundo, empacote seu software, as notas de versão e os links para arquivos binários em uma única versão.
Leia mais sobre quadros de projetos, marcos e versões.
Parte cinco: Integração com o GitHub
É provável que a sua equipe já conheça e adore o GitHub, mas também existem outras ferramentas nas quais sabemos que você confia para construir todos os dias. Quer você esteja integrando soluções legadas ou descobrindo novos aplicativos no GitHub Marketplace, é fácil encontrar e conectar-se às ferramentas que suas equipes precisam para desenvolver o melhor.
Automatização com o GitHub Actions
Não consegue encontrar a ferramenta de que sua equipe precisa para uma tarefa? Você não precisa desenvolver sua própria aplicação. Em vez disso, use o GitHub Actions: fluxos de trabalho de automação que rodam na plataforma do GitHub. As ações são acionadas por eventos específicos, como um push, problema ou versão. Após criar uma ação, você pode até disponibilizá-la no GitHub Marketplace para que outras pessoas possam usá-la.
Leia mais sobre o GitHub Actions e comece a criar sua primeira ação.
Integrando aplicações ao GitHub
O GitHub se integra a mais de 1.000 aplicações de terceiros, incluindo as principais ferramentas do setor, como CircleCI, Jenkins, Jira e ZenHub. Desenvolva software com as ferramentas que sua equipe já utiliza ou descubra algo novo sem precisar configurar várias contas ou métodos de pagamento. Instale aplicações em segundos em uma organização ou conta de usuário e conceda acesso aos repositórios de sua escolha.
Leia mais sobre ferramentas que se integram ao GitHub e integrações predefinidas.
Usando a API GitHub
Crie suas próprias ferramentas usando a mesma API que usamos para construir o GitHub. Configure sua Aplicação GitHub individual com webhooks integrados, execute verificações de alterações de código e desenvolva todos os tipos de integrações usando o conjunto completo de APIs GitHub.
Leia mais sobre as Aplicações do GitHub, a API GraphQL, as Checks API, as Deployments API e os webhooks.
Parte seis: Contribuindo para o código aberto
O software de código aberto está em todos os lugares. Ele capacita mais de 50 por cento de todo o software atualmente. incluindo os aplicativos e linguagens que as suas equipes já usam. E envolver-se com código aberto é mais fácil do que nunca: sua instância do GitHub Enterprise conecta automaticamente sua equipe a projetos inovadores de código aberto e aos melhores talentos em GitHub.com. Aprenda como encontrar e usar código aberto, compartilhar projetos com o mundo e aproveitar ao máximo o que a comunidade de código aberto do GitHub tem a oferecer, tudo isso protegido pela segurança do seu firewall.
Contribuições para código aberto
Organizações de todos os tamanhos podem fazer contribuições para código aberto. Não importa se você está utilizando o Enterprise Server ou o Enterprise Cloud, você pode pesquisar por código, problemas e mais entre milhões de projetos de código aberto, juntamente com seus projetos privados usando o GitHub Connect e a pesquisa unificada.
Leia mais sobre a pesquisa unificada, guias de código aberto e organizações de código aberto.
Conectando-se à comunidade GitHub
Mais de 30 milhões de desenvolvedores usam o GitHub, mas é fácil encontrar seu lugar e ficar conectado. Use o GitHub Explore como seu guia para encontrar seu próximo projeto, acompanhar as tendências e conferir o que há de novo na comunidade GitHub.
Saiba mais sobre o GitHub Explore.
Gerenciamento de usuários
Sua experiência do GitHub deve ter a sua cara. Adicione um avatar e compartilhe seus interesses pessoais em seu perfil de usuário para se conectar com outras pessoas parecidas no GitHub. Suas equipes no trabalho também podem compartilhar projetos com o restante da comunidade do GitHub. Contribuições unificadas, outro recurso do GitHub Connect, permite que desenvolvedores conectem seu código aberto e perfis do Enterprise. Com as contribuições unificadas, sua equipe pode compartilhar projetos públicos e privados nos quais trabalhou e obter o merecido reconhecimento.
Leia mais sobre perfis de usuário, contribuições unificadas e gráficos de contribuição.
Parte sete: Obtenção de suporte
Parabéns, você está oficialmente pronto para começar a construir no GitHub! 🎉 Antes de iniciar seu primeiro projeto, confira nossas principais ferramentas e recursos para atualizações, suporte e inspiração extra. Tem dúvidas ou precisa de ajuda? Aqui estão os locais onde você pode nos encontrar.
Para ficar por dentro de tudo do GitHub
Quer saber dos lançamentos mais recentes do GitHub ou o que está acontecendo no nosso universo? Descubra as novidades no nosso blog geral do GitHub ou no blog do GitHub Engineering, bem como nossos canais de mídia social. Para obter ferramentas úteis e dicas sobre como usar o GitHub no trabalho, elaboramos vários e-Books gratuitos, webinars, listas de verificação e mais no hub Recursos do GitHub - GitHub Resources.
Confira o blog do GitHub, o GitHub Changelog, o blog de GitHub Engineering, os Recursos do GitHub - GitHub Resources e acompanhe o GitHub no Twitter e no YouTube.
Treinamento para sua equipe com o GitHub Learning Lab
Ensine à sua equipe como usar o GitHub, sem sair da plataforma. O GitHub Learning Lab ajuda seus desenvolvedores a aprimorarem suas habilidades com a ajuda do nosso simpático bot do Learning Lab. Desenvolva cursos personalizados e privados, aumente a produtividade e disponibilize as ferramentas que todos em sua equipe precisam para desenvolver software com mais qualidade.
Leia mais sobre o Learning Lab.
Ajuda e treinamento técnico com especialistas do GitHub
Precisa de treinamento prático? Nossa equipe de serviços profissionais oferece consultorias de engenharia e treinamentos pessoalmente, ministrados por especialistas do GitHub. Daremos orientações em cada fase da jornada do GitHub da sua organização, desde a configuração inicial até o uso da API do GitHub.
Saiba mais sobre Serviços profissionais.
Usando o Portal de suporte do GitHub Enterprise
Pesquise pela documentação ou abra um tíquete de suporte com nossos engenheiros técnicos a qualquer momento. Dependendo se você usa o Enterprise Server ou o Enterprise Cloud, você pode abrir um tíquete de suporte por meio do console de gerenciamento do GitHub Enterprise Server ou do Portal de suporte Enterprise.
Leia mais sobre o Suporte do GitHub Enterprise.