Trabalhar com espaços de trabalho de compilação

Assim como precisa de um espaço de trabalho no seu computador de desenvolvimento para desenvolver seu aplicativo, você deve especificar o espaço de trabalho usado pelo agente de compilação para compilar e testar seu aplicativo.

O que você deseja fazer?

• Especificar um espaço de trabalho para sua definição de compilação

• Ver um exemplo de uma definição de espaço de trabalho de compilação

• Copiar dados entre espaços de trabalho

• Compreender como funciona um espaço de trabalho de compilação

Especificar um espaço de trabalho para sua definição de compilação

Ao definir seu processo de compilação, você deve seguir algumas práticas recomendadas na especificação do espaço de trabalho.

Inclua todas as pastas obrigatórias.

Não se esqueça de incluir todas as pastas que contenham arquivos exigidos pelo processo de compilação. Por exemplo, se você adicionar outra solução para a projetos campo o processo guia, você talvez precise adicionar outro mapeamento para o espaço de trabalho.

Inclua somente pastas obrigatórias.

Mapeie com um valor Status de Ativo somente as pastas exigidas pelo processo de compilação. Se uma subpasta de uma pasta mapeada contiver arquivos não exigidos pelo processo de compilação, mapeie-a com um valor Status de Encoberto. Em muitas situações, quando você cria uma definição de compilação, a pasta raiz do projeto da equipe é mapeada no espaço de trabalho. Essa configuração resulta no download pelo agente de compilação de todos os arquivos na pasta de controle de versão do seu projeto da equipe. Se essa pasta contivesse muitos dados, a compilação poderia desperdiçar recursos do sistema de compilação e atrasar o processo de compilação baixando grandes volumes de dados desnecessários.

Quando você remove itens do projetos campo o processo guia, procure mapeamentos que você pode remover do espaço de trabalho.

Dica

Para obter mais informações sobre como otimizar um espaço de trabalho, consulte Otimizar seu espaço de trabalho.

Use o símbolo $ (SourceDir) para mapear uma pasta do servidor para uma pasta local na... \Sources subdiretório.

Na maioria dos casos, o melhor local para os arquivos de origem no agente de compilação está sob o ..\Sources subdiretório no diretório de trabalho. É possível especificar esse local usando-se o símbolo $(SourceDir) na caixa Pasta do Agente de Compilação.

Saiba como o espaço de trabalho afeta uma definição de compilação disparada por check-ins.

Se você tiver definido o Gatilho da definição de compilação como Integração Contínua, Sem Interrupção de Compilações ou Check-in Restringido, as pastas do servidor mapeadas estarão associadas ao processo de compilação. Aqui está um exemplo. Um desenvolvedor faz check-in das alterações feitas em uma pasta. A pasta é mapeada no espaço de trabalho de uma definição de compilação e essa definição de compilação tem um gatilho Check-in Restringido. As alterações serão bloqueadas até o processo de compilação ser concluído.

Exemplo do espaço de trabalho da definição de compilação

Roberto, o engenheiro de compilação, criou a definição de compilação Storefront Nightly.

Essa definição de compilação compila duas soluções: $/Core/Controllers/Controllers.sln e $/Core/Viewers/Viewers.sln. Assim, ele deve mapear as duas pastas que contenham essas soluções, os projetos contidos nelas e todos os outros arquivos exigidos.

Para melhorar a eficiência do processo de compilação, Roberto exclui uma pasta que contém arquivos de documentação que não exige que o processo de compilação: $/Core/Viewers/Docs.

As soluções dependem de alguns binários em uma biblioteca de componentes de outra empresa. Esses binários são protegidos por um mecanismo de propriedade que exige que eles estejam em uma pasta física específica: c:\adatum\widgets.

Copiar dados entre espaços de trabalho

Você pode economizar tempo copiando mapeamentos de um espaço de trabalho para outro.

Para copiar mapeamentos de um dos espaços de trabalho

1. Escolha Copiar Espaço de Trabalho Existente.

2. Na caixa de diálogo Selecionar um Espaço de Trabalho para Copiar, copie os mapeamentos do espaço de trabalho.

Para copiar mapeamentos de outro espaço de trabalho da definição de compilação ou do espaço de trabalho de outro membro da equipe

1. Execute uma das seguintes etapas:

   • Para copiar mapeamentos de outro espaço de trabalho de definição de compilação, abra a definição de compilação e escolha o configurações de origem guia.

   • Para copiar mapeamentos de espaço de trabalho de outro membro da equipe, peça o membro da equipe, na barra de menus, escolha arquivo, Source Control, Avançado, espaços de trabalho. Selecione o espaço de trabalho e escolha Editar.

2. Abra o menu de atalho de uma linha na tabela Pastas de trabalho e escolha Selecionar Tudo.

3. Abra o menu de atalho para uma linha de pastas de trabalho da tabela e, em seguida, escolha cópia.

4. Crie um arquivo de texto, cole o conteúdo da Área de Transferência no arquivo de texto e salve-o.

5. Criar uma definição de compilação ou modificar uma definição de compilação existente que é o destino dos mapeamentos que você está copiando.

   Para obter mais informações, consulte Criar ou editar uma definição de compilação.

6. No configurações de origem guia, abra o menu de atalho para uma linha no pastas de trabalho da tabela e, em seguida, escolha Colar.

7. Conforme necessário, adapte os mapeamentos para o uso do agente de compilação. Em especial, certifique-se de que o valor na caixa Pasta do Agente de Compilação esteja correto e inclua o token $(SourceDir) conforme apropriado.

Compreender como funciona um espaço de trabalho de compilação

Durante o processo de compilação, o agente de compilação compila e faz outro trabalho com os arquivos de origem. Para o agente de compilação fazer esse trabalho, ele baixa os arquivos de pastas no seu servidor de controle de versão para um diretório de trabalho local. Para facilitar o download desses arquivos, o agente de compilação cria um espaço de trabalho de controle de versão, que mapeia as pastas no servidor para as pastas locais no diretório de trabalho do agente de compilação.

Antes do processo de compilação começar

Você define o diretório de trabalho para cada agente de compilação no sistema de compilação. Para obter mais informações, consulte Implantar e configurar agentes de compilação.

Quando você cria sua definição de compilação no espaço guia, especifique as pastas que contêm os arquivos que você deseja baixar e como essas pastas devem ser mapeadas para pastas locais no agente de compilação.

Durante o processo de compilação

O processo de compilação passa as especificações de espaço de trabalho para o CreateWorkspace atividade de fluxo de trabalho para criar um espaço de trabalho em seu diretório de trabalho.

O processo de compilação usa a atividade DownloadFiles para baixar os arquivos no espaço de trabalho. Após essa etapa, o agente de compilação poderá iniciar o trabalho (como a compilação) nesses arquivos.