Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O espaço de trabalho ramificado é um espaço de trabalho ligado a um espaço de trabalho de origem. Permite que os programadores trabalhem em alterações num ambiente isolado, compreendam como o seu trabalho se relaciona com outros espaços de trabalho e promovam alterações de volta ao espaço principal com confiança.
A relação (ligação) entre um espaço de trabalho de ramificação e o respetivo espaço de trabalho de origem é estabelecida quando o utilizador efetua o branch-out. Para os programadores do Fabric, o branch-out cria um novo ramo Git a partir do ramo ligado ao espaço de trabalho de origem. O utilizador pode escolher criar um novo espaço de trabalho ligado a um novo ramo criado, ou usar um espaço de trabalho existente mudando o seu ramo Git para o novo ramo criado.
Note
Se configurar um fluxo de automação que execute as mesmas ações que o branch-out, use a API de pré-visualização Create Workspace Relation para criar a relação branch workspace. Invoque esta API depois de o fluxo ter preparado o espaço de trabalho da ramificação, criado a ramificação Git e configurado a ligação Git do espaço de trabalho.
Espaço de trabalho de filial
A relação entre a ramificação e o espaço de trabalho tem várias representações visuais na interface do Fabric:
Árvore do espaço de trabalho: representa o espaço de trabalho de origem como o espaço de trabalho principal da ramificação
Navegação estrutural do espaço de trabalho: Opção de navegação entre o espaço de trabalho da ramificação e o espaço de trabalho de origem
Separador de controlo do código fonte - ramos relacionados
Operação de ramificação
Por padrão, quando uma operação de bifurcação é concluída, todos os itens do ramo de origem estão incluídos no espaço de trabalho alvo. Este comportamento pode ser alterado ao selecionar Selecionar itens individualmente durante a configuração da ramificação, permitindo que apenas os itens escolhidos sejam incluídos na área de trabalho de destino, proporcionando uma experiência mais rápida até começar a programar.
Como desenvolvedor de Fabric, o fluxo de ramificação seria o seguinte:
No painel de controlo de versão, selecione Criar ramificação.
Especifique se quer criar um novo espaço de trabalho ou expandir para um já existente. Insira os nomes do novo ramo e espaço de trabalho, ou selecione o espaço de trabalho existente na lista suspensa. Se optares por expandir para um novo espaço de trabalho, poderás conseguir ativar/desativar o perfil de administrador Usar o espaço de trabalho da ramificação (Pré-visualização)
Note
A opção de perfil de administrador do espaço de trabalho de filial (Pré-visualização) está disponível apenas quando um administrador de espaço de trabalho configurou um perfil. Quando se ramifica a partir de um espaço de trabalho de filial existente, esta opção só está disponível se o espaço de trabalho pai tiver um perfil de administrador de sucursal configurado. Para mais informações, consulte Configurar perfis de administrador da área de trabalho de ramificação (Pré-visualização).
Antes de iniciar a ramificação, o Fabric valida se a sua identidade pode completar a operação. Se a validação falhar, o Fabric apresenta um erro e impede o início da operação. Pode ser necessário usar o perfil de administrador configurado para continuar, ou expandir para um espaço de trabalho já existente. Esta validação precoce impede uma operação que, de outra forma, falharia.
- Selecione Selecionar itens individualmente caso pretenda trabalhar apenas num subconjunto dos itens na área de trabalho do ramo. Verás a seguinte captura de ecrã ao criar um novo espaço de trabalho com ramificações seletivas.
Importante
Quando se expande para um espaço de trabalho existente, os itens que não estão guardados no Git podem ser eliminados. Compromete os itens que quiseres manter antes de continuar. Deve confirmar que compreende este risco antes de iniciar a operação de diversificação.
Clique no botão Expandir (os passos 5–9 só se aplicam se Selecionar itens individualmente estiver selecionado)
Esta ação abre um diálogo para Selecionar itens para o seu espaço de trabalho.
Seleciona os itens que queres para este espaço de trabalho.
Clique em Criar ramo.
Quando realizas ramificações seletivas, todas as dependências do item são necessárias. Podes usar o botão de selecionar itens relacionados para esse propósito. Se não selecionares uma das dependências, vês o seguinte:
Note
Podes selecionar itens e começar a ramificar enquanto o Fabric calcula as suas dependências em segundo plano. No entanto, avançar antes de todos os itens relacionados estarem carregados pode causar a falha da operação.
Depois de criada a ramificação, pode verificar que está numa ramificação seletiva pelo ícone na barra de estado inferior (canto inferior esquerdo). Diz ramificação seletiva.
A Fabric cria o novo espaço de trabalho da filial. Você é automaticamente levado para o novo espaço de trabalho. Contém todos os itens ou apenas os itens que selecionaste em caso de ramificação seletiva.
O espaço de trabalho sincroniza-se com o ramo de funcionalidades e torna-se um ambiente isolado para trabalhar, como ilustrado abaixo. Agora pode trabalhar neste novo espaço de trabalho da filial. A sincronização pode levar alguns minutos. Para obter mais informações sobre ramificação, consulte dicas de solução de problemas.
- Salve as suas alterações e cometa-as no ramo de funcionalidades.
- Quando estiver pronto, crie um PR para a filial principal . Os processos de revisão e fusão são feitos através do fornecedor Git relacionado, com base na configuração que a sua equipa definiu para esse repositório.
Quando a revisão e a mesclagem estiverem concluídas, um novo commit será criado na ramificação principal. Essa confirmação solicita que o usuário atualize o conteúdo no espaço de trabalho da equipe de desenvolvimento com as alterações mescladas.
Para obter mais informações, consulte Limitações de ramificação.
Como adicionar itens adicionais a um espaço de trabalho com ramificação seletiva
Quando um programador Fabric precisa de adicionar itens que não foram selecionados durante a operação de ramificação, os passos abaixo descrevem como adicionar itens adicionais ao espaço de trabalho:
- Vai ao espaço de trabalho obrigatório do Fabric e seleciona Controlo de Versão no topo.
- À direita, selecione o símbolo dos três pontos .
- Utilize o menu suspenso e selecione Adicionar mais itens.
- Esta ação abre um diálogo para Selecionar itens para o seu espaço de trabalho. A janela de diálogo de selecionar itens mostra apenas os itens do branch git que não foram previamente selecionados.
- Selecione os itens adicionais que quer adicionar ao espaço de trabalho.
- Clique em Adicionar. Os itens selecionados são adicionados às atualizações pendentes no painel de controlo de origem.
- Clique em Atualizar tudo. Esta operação realiza uma atualização a partir do git e cria os itens no espaço de trabalho.
Mudar de ramo
Se seu espaço de trabalho estiver conectado a uma ramificação do Git e você quiser alternar para outra ramificação, poderá fazê-lo rapidamente a partir do painel Controle do código-fonte sem desconectar e reconectar.
Quando você alterna ramificações, o espaço de trabalho é sincronizado com o novo ramo e todos os itens no espaço de trabalho são substituídos. Se houver versões diferentes do mesmo item em cada ramo, o item será substituído.
Efetuar a mudança de ramo não afeta a ligação entre o espaço de trabalho de um ramo e o respetivo espaço de trabalho de origem. A comutação de branch é uma alteração de estado do Git. Assim, alternar entre ramificações não cria nem modifica relações de espaço de trabalho. Se um espaço de trabalho já tem uma relação, então ela é preservada.
Por predefinição, a alteração da ramificação do Git de uma área de trabalho conectada (ou a mudança para uma nova ramificação) está restrita aos Administradores da área de trabalho. No entanto, um Administrador do espaço de trabalho pode ativar a definição por espaço de trabalho Permitir que utilizadores com, pelo menos, a função de Contribuidor alterem a ramificação do Git para permitir a alternância de ramificação a Membros e Contribuidores. Esta configuração é configurada por cada espaço de trabalho e requer uma ligação ativa ao Git. Para a matriz completa de permissões, veja Permissões.
Note
Ao alternar ramificações, se o espaço de trabalho contiver um item na ramificação antiga, mas não na nova, o item será excluído. Adicionalmente, num espaço de trabalho com ramificação seletiva, realizar uma operação de comutação reinicia a seleção de itens, e todos os itens do ramo comutado são sincronizados com o espaço de trabalho.
Para alternar entre ramificações, siga estas etapas:
No painel Controlo de código-fonte, selecione Mais opções (...), e depois selecione Mudar de ramificação.
Especifique a ramificação à qual você deseja se conectar ou crie uma nova ramificação. Esta ramificação deve conter o mesmo diretório que a ramificação atual.
Assinalar Entendo que os itens do espaço de trabalho podem ser excluídos e não podem ser restaurados. e selecione Mudar de branch.
Não é possível alternar ramificações se tiver alterações não confirmadas no espaço de trabalho. Selecione Cancelar para voltar e confirmar as alterações antes de mudar de filial.
Para ligar o espaço de trabalho atual a uma nova ramificação, mantendo o estado do espaço de trabalho existente, selecione Mudar para nova ramificação. Saiba mais sobre como fazer check-out de uma nova ramificação em Resolver conflitos no Git.
Diversifice com um plano de implantação
Anexe um plano de implementação quando os itens tiverem de ser implementados numa ordem específica ou quando notebooks, pipelines de dados ou outras ações suportadas tiverem de ser executadas durante a ramificação. O plano de implementação controla a forma como o Fabric preenche o espaço de trabalho ramificado; não altera a forma como o ramo do Git ou o espaço de trabalho são criados.
Antes de começares, guarda o plano de implementação e compromete-o no branch Git atual com os itens que refere. Apenas os planos de implementação disponíveis no Git podem ser selecionados durante a criação de ramificações.
Para diversificar com um plano de implantação:
No separador Ramificações do painel Controlo de versões, selecione Criar ramificação com plano de implementação.
Configura o novo ramo e o espaço de trabalho de destino. Selecione Seguinte.
Selecione um plano de implementação no assistente Branch-Out. Para usar o comportamento padrão de ramificação, selecione Sem plano de implantação.
Se selecionou Selecionar itens individualmente (Pré-visualização), selecione os itens a incluir no espaço de trabalho ramificado, incluindo os itens necessários pelas ações do plano. Anexar o plano não seleciona estes itens por si.
Selecione Criar ramo.
O Fabric cria o ramo e o espaço de trabalho, e depois utiliza o plano de implementação enquanto preenche o espaço de trabalho alvo. Para saber como os itens selecionados, as relações do plano, a linhagem do Fabric e as ações determinam a implementação, veja Como funciona um plano de implementação.
Ramificar sem um plano de implementação funciona como antes: o Fabric implementa os itens selecionados usando o seu tratamento padrão de dependências e não executa ações pré ou pós-implantação.
Ramificando limitações
- O perfil de administrador da área de trabalho da filial está em versão preliminar.
- A ramificação requer permissões listadas na tabela de permissões.
- Tem de haver uma capacidade disponível para esta ação.
- Todas as limitações de nomenclatura de espaço de trabalho e limitações de nomenclatura de ramificação se aplicam quando se ramifica para um novo espaço de trabalho.
- Apenas os itens suportados pelo Git estão disponíveis no novo espaço de trabalho.
- A lista de ramificações relacionadas mostra apenas ramificações e espaços de trabalho que você tem permissão para exibir.
- A integração com o Git deve ser habilitada.
- Ao ramificar, uma nova ramificação é criada e as configurações da ramificação original não são copiadas. Ajuste quaisquer configurações ou definições para garantir que o novo espaço de trabalho cumpre as políticas da sua organização.
- Ao desassociar do Git uma ramificação do espaço de trabalho, a sua relação com o espaço de trabalho de origem também é removida.
- Ao desassociar uma área de trabalho associada ao Git que tenha áreas de trabalho associadas a ramos relacionadas, todas as associações entre áreas de trabalho associadas a ramos também são removidas.
- Ao eliminar um espaço de trabalho que tem espaços de trabalho de ramo relacionados, todas as relações de espaço de trabalho de ramo são removidas, e os espaços de trabalho de ramo tornam-se espaços de trabalho regulares.
- Ao criar uma ramificação num espaço de trabalho existente:
- O espaço de trabalho de destino deve suportar uma conexão Git.
- O utilizador tem de ser administrador do espaço de trabalho de destino ou Member/Contributor no espaço de trabalho de destino, com a definição Permitir que utilizadores com, pelo menos, a função Contributor alterem a ramificação Git ativada.
- O espaço de trabalho de destino deve ter capacidade.
- O espaço de trabalho não pode ter aplicações modelo.
- A área de trabalho de destino não pode ter quaisquer áreas de trabalho de ramificação relacionadas.
- Quando cria uma ramificação num espaço de trabalho existente, quaisquer itens que não estejam guardados no Git podem perder-se. Recomendamos que registe os itens que deseja manter antes de se ramificar.