Se você for membro de uma organização que migrou de Azure DevOps para GitHub, este guia explicará as alterações em seus fluxos de trabalho para tornar a migração o mais suave possível.
Estrutura
No Azure DevOps, os repositórios são aninhados dentro de projetos de equipe, portanto, a estrutura do seu ambiente tem esta aparência:
- Organization
- Projeto da equipe
- Repositórios
- Projeto da equipe
- Repositórios
- Projeto da equipe
Permissões e visibilidade provêm do projeto de equipe.
GitHub é estruturado de forma diferente. Dentro das organizações, os repositórios são localizados diretamente e também contêm equipes:
- Conta empresarial
- Organization
- Teams
- Repositórios
- Organization
- Teams
- Repositórios
- Organization
As permissões e a visibilidade são determinadas por uma combinação de associação da organização, associação à equipe e permissões individuais.
O conceito de um projeto de equipe, que é usado para agrupar repositórios em Azure DevOps, não existe em GitHub e tratar organizações em GitHub como o equivalente de projetos de equipe não é recomendado.
Embora você possa inicialmente encontrar cada organização GitHub migrada com uma longa lista de repositórios desorganizada, você pode conceder acesso e permissões por meio de equipes de membros da organização, o que facilita muito a navegação nos repositórios da organização.
Autenticação, permissões e equipes
Há dois métodos de autenticação no GitHub. Qual método você usar dependerá de como a conta corporativa está configurada.
Se sua conta corporativa usar Enterprise Managed Users, você entrará no GitHub por meio do provedor de identidade (por exemplo, Entra ID) e usará uma conta provisionada vinculada à conta corporativa.
Caso contrário, você usará uma conta pessoalGitHub. Essa conta será convidada para a conta corporativa e todas as organizações em que você trabalhará. Se a conta corporativa estiver configurada com restrições de acesso SAML adicionais, sua conta pessoal será vinculada ao IdP. Você será solicitado a autenticar com o IdP quando precisar acessar recursos na conta corporativa.
Em uma empresa no GitHub, os repositórios podem ser públicos, privados ou internos. Repositórios privados só são visíveis para pessoas e equipes com acesso explícito, e repositórios internos são visíveis para todos os membros da sua empresa, mas não para pessoas de fora da empresa. Repositórios internos são úteis quando várias organizações na mesma empresa precisam descobrir e reutilizar código. Se sua empresa usar Enterprise Managed Users, as contas de usuário não poderão criar repositórios públicos ou outro conteúdo público.
Utilizando o Git
Para continuar trabalhando em seus repositórios usando o Git, você precisará fazer algumas alterações.
- Atualize URLs remotas para apontar para GitHub. Consulte Gerenciar repositórios remote.
- Atualize como você se autentica.
- Para usar a autenticação HTTPS, você precisará criar uma personal access token. Consulte Gerenciar seus tokens de acesso pessoal.
- Para usar a autenticação SSH, você precisará criar ou adicionar uma chave SSH existente.GitHub Consulte Conectando-se ao GitHub com o SSH.
- Se sua empresa ou organização usar o SSO (Single Sign-On) do SAML, você deverá autorizar sua personal access token chave SSH antes que ela possa acessar recursos.
Fluxo de solicitação de pull
Com a base de código agora hospedada GitHub, você proporá alterações usando solicitações de pull criadas em seus GitHub repositórios.
Se sua empresa integrou o Azure Boards e os Pipelines, ambos funcionarão com GitHub. Você pode continuar a referenciar itens de trabalho em suas mensagens de confirmação e solicitações de pull. Por exemplo: Fix login bug (AB#1234).
Você pode continuar a exibir e gerenciar seus itens de trabalho no Azure Boards. Você também pode vincular branches, commits e pull requests a itens de trabalho diretamente no Azure. Consulte como vincular confirmações do GitHub, pull requests, ramificações e issues a itens de trabalho nos Quadros do Azure no Microsoft Learn.
Proteções de ramificação
Pessoas com acesso administrativo a um repositório podem configurar regras de proteção de branch em GitHub. Elas são semelhantes às políticas de branch no Azure DevOps e definem regras como um número mínimo de revisores de aprovação, verificações de status bem-sucedidas e a necessidade de confirmações assinadas.
GitHub também dá suporte à atribuição automática de revisores com base nos padrões de arquivo, pasta e padrões globais no arquivo CODEOWNERS de um repositório. Consulte Sobre os proprietários de código.
Pacotes e artefatos
No Azure DevOps, você pode ter usado o Azure Artifacts para publicar e consumir pacotes (por exemplo, pacotes NuGet, pacotes npm ou pacotes Maven) e armazenar artefatos de build produzidos pelo Azure Pipelines.
Em GitHub, os pacotes normalmente são publicados no GitHub Packages e associados a um repositório ou organização. Dependendo de como sua empresa concluiu a migração, você pode continuar publicando pacotes para Azure Artifacts, mover pacotes para GitHub Packages ou usar uma combinação de ambos.
Se você não conseguir mais restaurar dependências após a migração, verifique a configuração de origem do pacote. Por exemplo, talvez seja necessário atualizar uma URL do Registro ou credenciais em arquivos como nuget.config, .npmrcou settings.xmlem sua configuração de pipeline.
Para obter mais informações, consulte Introdução ao GitHub Packages.
GitHub Copilot
Hospedar seus repositórios em GitHub desbloqueia todo o poder de Copilot. Sua base de código fornece Copilot todo o contexto de que precisa para responder perguntas em Copilot Chat, examinar e fazer sugestões em seus pull requests e até mesmo fazer alterações em seu lugar com Copilot cloud agent.
Consulte Guia de início rápido para usar o GitHub Copilot no GitHub.com.