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

Assim como você precisa o espaço de trabalho no seu computador de dev de desenvolver seu aplicativo, você deve especificar o espaço de trabalho do agente de compilação usa para criar 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 os espaços de trabalho

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

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

Quando você defina o processo de compilação, você deve seguir algumas práticas recomendadas quando você especifique o espaço de trabalho.

Inclua todas as pastas necessárias.

Certifique-se de que você inclua todas as pastas que contêm os arquivos que o processo de compilação requer.Por exemplo, se você adiciona outra solução ao campo de Itens para Compilar na guia de Processo , você talvez precise adicionar um outro mapeamento para o espaço de trabalho.

Inclua somente pastas requeridas.

Mapa com um valor de Status de Ativo apenas das pastas que o processo de compilação requer.Se uma subpasta da pasta mapeada contém os arquivos que o processo de compilação não requer, mapear-lo com um valor de Status de encoberto.Em muitas situações, quando você cria uma definição de compilação, a pasta raiz do projeto de equipe é mapeada no espaço de trabalho.Essa configuração resulta em agente de compilação que baixa todos os arquivos na pasta de controle de versão do seu projeto de equipe.Se esta pasta contém muitos dos dados, a compilação pode desperdiçar recursos do sistema de compilação e diminuir o processo de compilação baixando grandes quantidades de dados que não requer.

Quando você remove itens do campo Itens para compilar na guia Processo, procure pelos mapeamentos que você pode remover do espaço de trabalho.

Dica
Para obter mais informações sobre otimizar de um espaço de trabalho, consulte otimize Otimizar seus espaços de trabalho.

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

Na maioria dos casos, o melhor lugar para os arquivos de origem no agente de compilação é no subdiretório ..\Sources no diretório de trabalho.Você pode especificar esse local usando o símbolo $(SourceDir) na caixa da pasta do agente de compilação.

Esteja ciente de como o espaço de trabalho afeta uma definição de compilação que é acionada por registros.

Se você tiver definido o Trigger da definição de compilação como Integração contínua, Compilações de rolamento ou Check-in com barreira, as pastas do servidor que você mapeia estão associadas ao processo de compilação.Aqui está um exemplo.Um desenvolvedor fizer o check-in das alterações em uma pasta.A pasta é mapeada no espaço de trabalho de uma definição de compilação e aquela definição de compilação tem um disparador de Check-in Restringido .As alterações serão bloqueadas até que o processo de compilação seja concluída.

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

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

Essa definição de compilação cria duas soluções: $/Core/Controllers/Controllers.sln e $/Core/Viewers/Viewers.sln.Como resultado, deve mapear as duas pastas que contêm essas soluções, os projetos que elas contenham e todos os outros arquivos que são exigidos.

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

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

Copiar dados entre os espaços de trabalho

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

Para copiar mapeamentos de um dos seus espaços de trabalho

1. Escolha Copiar espaço de trabalho existente.

2. Na caixa de diálogo Selecione 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 de espaço de trabalho de outro membro da equipe

1. Execute uma das seguintes etapas:

   • Para copiar mapeamentos de outro espaço de trabalho da definição de compilação, abre a definição de compilação, e clique na guia Espaço de trabalho.

   • Para copiar mapeamentos de espaço de trabalho de outro membro da equipe, solicite ao membro da equipe, e barra de menu, escolher Arquivo, Controle de Código-fonte, Espaços de Trabalho.Selecione o espaço de trabalho e escolha Editar.

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

3. Abra o menu de atalho para uma linha na tabela Pastas de trabalho e então escolha Copiar.

4. Crie um arquivo de texto, cole o conteúdo da área de transferência no arquivo de texto e, em seguida, salve o.

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

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

6. Na guia Espaço de trabalho, abra o menu de atalho para uma linha na tabela Pastas de trabalho e, então, escolha Colar.

7. Conforme necessário, adapte os mapeamentos para o uso do agente de compilação.Em particular, certifique-se de que o valor na caixa Compile a pasta do agente está correto e inclua o símbolo $(SourceDir) como apropriado.

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

Durante o processo de compilação, o agente de compilação compila e faz outro trabalho com os arquivos de origem.Antes que o agente de compilação possa fazer o trabalho, baixe os arquivos de pastas do seu servidor de controle de versão em um diretório do 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 pastas locais no diretório de trabalho para o agente de compilação.

Antes de iniciar o processo de compilação

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, na guia Espaço de trabalho, especifique as pastas que contêm os arquivos que você deseja baixar e como essas pastas devem ser mapeadas em pastas locais no agente de compilação.

Durante o processo de compilação

O processo de compilação passa as suas especificações de espaço de trabalho para a atividade do fluxo de trabalho Atividade CreateWorkspace a fim de criar um espaço de trabalho no diretório de trabalho.

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