Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Espaço de trabalho de ramificação é um espaço de trabalho vinculado a um espaço de trabalho de origem. Ele permite que os desenvolvedores trabalhem em alterações em um ambiente isolado, entendam como seu trabalho se relaciona com outros workspaces e promovam alterações de volta ao workspace principal com confiança.
A relação (link) entre um workspace de ramificação e seu workspace de origem é estabelecida quando o usuário executa o branch-out. Para desenvolvedores do Fabric, o branch-out cria uma nova ramificação do Git a partir da ramificação conectada ao workspace de origem. O usuário pode escolher criar um novo espaço de trabalho conectado ao novo branch criado ou usar um workspace existente trocando seu branch Git para o recém-criado.
Note
Se você configurar um fluxo de automação que execute as mesmas ações que o branch-out, use a versão prévia da Create Workspace Relation API para criar o relacionamento do espaço de trabalho de ramificação. Chame esta API depois de o fluxo preparar o espaço de trabalho da ramificação, criar a ramificação do Git e configurar a conexã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 pai do espaço de trabalho da ramificação
Trilha de navegação do espaço de trabalho: opção de navegação do espaço de trabalho derivado para o espaço de trabalho de origem
Controle do código-fonte - guia branches relacionados
Operação de ramificação
Por padrão, quando uma operação de divisão de ramo é concluída, todos os itens do ramo de origem são incluídos no workspace de destino. Esse comportamento pode ser alterado selecionando Selecionar itens individualmente durante a configuração da ramificação, permitindo que apenas os itens escolhidos sejam incluídos no espaço de trabalho de destino, proporcionando uma experiência mais rápida para começar a programar.
Como desenvolvedor do Fabric, o fluxo de ramificação seria o seguinte:
No painel Controle do Código-Fonte, selecione Criar branch.
Especifique se deseja criar um novo espaço de trabalho ou iniciar uma ramificação a partir de um existente. Insira os nomes do novo ramo e do novo espaço de trabalho, ou selecione o espaço de trabalho existente na lista suspensa. Se você optar por expandir para um novo workspace, talvez consiga ativar/desativar o perfil de administrador Use branch workspace (Preview)
Note
A opção de perfil de administrador de espaço de trabalho de filial (Prévia) está disponível apenas quando um administrador de workspace configurou um perfil. Ao criar uma ramificação a partir de um workspace de ramificação existente, esta opção estará disponível somente se o workspace pai tiver um perfil de administrador de workspace de ramificação configurado. Para mais informações, consulte Configurar perfis de administrador do espaço de trabalho de branch (Versão prévia).
Antes do início da ramificação, o Fabric valida se sua identidade pode completar a operação. Se a validação falhar, o Fabric exibe um erro e impede que a operação comece. Talvez você precise usar o perfil de administrador configurado para continuar, ou então expandir para um espaço de trabalho já existente. Essa validação antecipada impede uma operação que, de outra forma, falharia.
- Marque Selecionar itens individualmente caso queira trabalhar apenas em um subconjunto dos itens no espaço de trabalho da branch. Você verá a captura de tela a seguir ao criar um novo workspace com ramificação seletiva.
Importante
Quando você se expande para um espaço de trabalho existente, itens que não são salvos no Git podem ser deletados. Comprometa todos os itens que quiser manter antes de continuar. Você deve confirmar que entende esse risco antes de iniciar a operação de ramificação.
Clique no botão Ramificar (as etapas 5 a 9 se aplicam apenas quando Selecionar itens individualmente estiver selecionado)
Essa ação abre uma caixa de diálogo para Selecionar itens para seu workspace.
Selecione os itens que você deseja para este workspace.
Clique em Criar branch.
Quando você executa a ramificação seletiva, todas as dependências do item são necessárias. Você pode usar o botão selecionar itens relacionados para essa finalidade. Se você não selecionar uma das dependências, verá o seguinte:
Note
Você pode selecionar itens e começar a ramificar enquanto o Fabric calcula suas dependências em segundo plano. No entanto, avançar antes que todos os itens relacionados sejam carregados pode causar a falha da operação.
Depois que o branch for criado, você poderá verificar se está em um branch seletivo pelo ícone na barra de status inferior (canto inferior esquerdo). Diz ramificação seletiva.
Fabric cria o novo espaço de trabalho da filial (branch). O sistema automaticamente leva você ao novo espaço de trabalho. Ele contém todos os itens ou apenas os itens que você selecionou no caso de ramificação seletiva.
O workspace sincroniza com seu ramo de recursos e se torna um ambiente isolado para trabalhar, como ilustrado abaixo. Agora você pode trabalhar nesse 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 suas alterações e confirme elas na ramificação do recurso.
- Quando estiver pronto, crie um PR para a ramificação principal. Os processos de revisão e mesclagem são feitos por meio do provedor Git relacionado com base na configuração definida por sua equipe para esse repositório.
Quando a revisão e a mesclagem forem concluídas, um novo commit será criado na ramificação principal. Este commit solicita que o usuário atualize o conteúdo no espaço de trabalho da equipe de desenvolvimento para refletir as alterações mescladas.
Para obter mais informações, consulte limitações de ramificação.
Como adicionar itens adicionais a um workspace com ramificação seletiva
Quando um desenvolvedor do Fabric precisa adicionar itens que não foram selecionados durante a operação de ramificação, as etapas abaixo descrevem como adicionar itens adicionais ao workspace:
- Vá para o workspace necessário do Fabric e selecione o controle de origem na parte superior.
- À direita, selecione o símbolo dos três pontos .
- Use o menu suspenso e selecione Adicionar mais itens.
- Essa ação abre uma caixa de diálogo para Selecionar itens para seu workspace. A caixa de diálogo selecionar itens mostra apenas os itens do branch git que não foram selecionados anteriormente.
- Selecione os itens adicionais que você deseja adicionar ao workspace.
- Clique em Adicionar. Os itens selecionados são adicionados às atualizações pendentes no painel de controle do código-fonte.
- Clique em Atualizar tudo. Essa operação executa uma atualização do git e cria os itens no workspace.
Alternar ramificações
Se o workspace estiver conectado a um branch do Git e você quiser alternar para outro branch, poderá fazer isso rapidamente no painel Controle do código-fonte sem precisar desconectar e reconectar.
Quando você alterna as ramificações, o espaço de trabalho é sincronizado com a nova ramificação e todos os itens no espaço de trabalho são substituídos. Se existirem versões diferentes do mesmo item em cada ramificação, o item será substituído.
Executar o branch do switch não afeta o relacionamento (link) entre um workspace de branch e seu workspace de origem. A mudança de branch é uma alteração de estado do Git. Portanto, a troca de branches não cria ou modifica relações de espaço de trabalho. Se um espaço de trabalho já tiver uma relação, esta será mantida.
Por padrão, mudar o branch do Git de um workspace conectado (ou fazer checkout de um novo branch) é restrito aos administradores do workspace. No entanto, um Administrador do workspace pode ativar a configuração do workspace Permitir que usuários com pelo menos a função de Contribuidor alterem a ramificação do Git para permitir que Membros/Contribuidores alternem entre ramificações. Essa configuração é configurada por workspace e requer uma conexão Git ativa. Para obter a matriz de permissões completa, consulte Permissões.
Note
Ao mudar de branch, se a área de trabalho contiver um item no branch antigo, mas não no novo, o item será excluído. Além disso, em um espaço de trabalho com ramificação seletiva, a execução de uma operação de troca redefine a seleção de itens, e todos os itens da ramificação trocada são sincronizados com o espaço de trabalho.
Para alternar entre as ramificações, siga estas etapas:
No painel de controle de versão , selecione Mais opções (...) e depois selecione Switch branch.
Especifique o branch ao qual você deseja se conectar ou criar uma nova ramificação. Essa ramificação deve conter o mesmo diretório que a ramificação atual.
Marque a opção Entendo que os itens da área de trabalho podem ser excluídos e não podem ser restaurados. E selecione Alternar branch.
Você não poderá alternar branches se tiver alterações não confirmadas no workspace. Selecione Cancelar para retornar e confirmar suas alterações antes de trocar de branches.
Para conectar o workspace atual a um novo branch, mantendo o status do workspace existente, selecione Fazer checkout de um novo branch. Saiba mais sobre como fazer check-out de um novo branch em Resolver conflitos no Git.
Expanda-se com um plano de implantação
Anexe um plano de implantação quando os itens precisarem ser implantados em uma ordem específica ou quando notebooks, pipelines de dados ou outras ações compatíveis precisarem ser executadas durante a ramificação. O plano de implantação controla como o Fabric preenche o espaço de trabalho ramificado; ele não altera a forma como a ramificação ou o espaço de trabalho do Git são criados.
Antes de começar, salve o plano de implantação e comprometa-o no branch Git atual com os itens que ele referencia. Apenas os planos de implantação disponíveis no Git podem ser selecionados durante a criação da ramificação.
Para se expandir com um plano de implantação:
Na aba Ramificações do painel Controle de código-fonte, selecione Criar ramificação com plano de implantação.
Configure o novo ramo e o espaço de trabalho de destino. Selecione Próximo.
Selecione um plano de implantação no assistente de expansão. Para usar o comportamento padrão de ramificação, selecione Sem plano de implantação.
Se você selecionou Selecionar itens individualmente (Prévia), selecione os itens para incluir no espaço de trabalho ramificado, incluindo os itens necessários pelas ações do plano. Anexar o plano não faz com que esses itens sejam selecionados automaticamente.
Selecione Criar ramo.
O Fabric cria a ramificação e o espaço de trabalho e, em seguida, usa o plano de implantação ao preencher o espaço de trabalho de destino. Para saber como os itens selecionados, as relações do plano, a linhagem do Fabric e as ações determinam a implantação, veja Como funciona um plano de implantação.
Expandir sem um plano de implantação funciona como antes: o Fabric implanta os itens selecionados usando seu tratamento padrão de dependências e não executa ações pré ou pós-implantação.
Limitações de expansão
- O perfil de administrador do workspace da filial está no Preview.
- A ramificação requer permissões listadas na tabela de permissões.
- É necessário haver uma capacidade disponível para essa ação.
- Todas as limitações de nomenclatura de workspace e branch se aplicam ao criar um novo workspace.
- Somente os itens com suporte do Git estão disponíveis no novo espaço de trabalho.
- A lista de filiais relacionadas mostra apenas filiais e espaços de trabalho que você tem permissão para exibir.
- A integração do Git deve estar habilitada.
- Ao ramificar para fora, um novo branch é criado e as configurações do branch original não são copiadas. Ajuste quaisquer configurações ou definições para garantir que o novo espaço de trabalho atenda às políticas da sua organização.
- Ao desconectar um workspace de ramificação do Git, seu relacionamento com o workspace de origem também é removido.
- Ao desconectar um workspace conectado ao Git que possui workspaces de branch relacionados, todos os relacionamentos entre workspaces de branch também são removidos.
- Ao excluir um espaço de trabalho que possui áreas de trabalho de ramo relacionadas, todas as relações de áreas de trabalho de ramo são removidas, e as áreas de trabalho de ramo tornam-se áreas de trabalho regulares.
- Ao fazer o branch para um workspace existente:
- O workspace de destino deve dar suporte a uma conexão Git.
- O usuário deve ser administrador do espaço de trabalho de destino ou Membro/Colaborador no espaço de trabalho de destino, com a configuração Permitir que usuários com, no mínimo, a função de Colaborador alterem a branch do Git habilitada.
- O espaço de trabalho de destino deve ter capacidade suficiente.
- O espaço de trabalho não pode ter aplicativos modelo.
- O espaço de trabalho de destino não pode ter espaços de trabalho de ramificação relacionados.
- Quando você expande para um espaço de trabalho existente, quaisquer itens que não estejam salvos no Git podem se perder. Recomendamos que você faça o commit todos os itens que deseja manter antes de fazer o branch.