Disparar uma versão de uma compilação

Inicie uma versão automaticamente quando você compila seu aplicativo usando o Team Foundation Build. Você pode escolher por qual estágio de seu processo de criação de versão iniciar. Para disparar uma versão de uma compilação, você deve configurar o processo de compilação e o caminho da versão.

Se você ainda não criou o caminho da versão, clique aqui para fazê-lo.

Além disso, se você ainda não configurou seu sistema de compilação, faça isso agora.

Configurar o processo de compilação

1. Se você não tem permissão para editar definições de compilação, obtenha-a agora.

2. No Visual Studio, Team Explorer, conecte-se ao projeto de equipe no qual você deseja trabalhar (Teclado: Ctrl + 0, C).

3. Na página Compilações (Teclado: Ctrl + 0, B), crie ou edite uma definição de compilação.

4. Na guia processo da definição de compilação, escolha a configuração que você deseja usar para esta liberação (por exemplo: depurar ou liberação). Defina a Compilação de Versão para True. Escolha o estágio específico que você deseja disparar a liberação ou deixe esse campo em branco, se quiser iniciar com a primeira etapa.

   

   Se a seção Versão não aparecer:

   • P: Posso usar o modelo padrão. Que modelo de processo de compilação devo usar no Release Management e como o adiciono ao TFS?

   • P: Eu uso o modelo de atualização. Que modelo de processo de compilação devo usar no Release Management?

   • P: Eu uso um modelo de processo de compilação personalizado. Como faço para adicionar a lógica de fluxo de trabalho para disparar uma versão?

   Se houver componentes com arquivos de configuração que precisam de valores diferentes com base no ambiente de destino, você poderá criar um token para o arquivo de configuração.

5. Especifique outras configurações que o processo de compilação exige e salve a definição de compilação.

Configurar o modelo de versão

1. Se você ainda não instalou o Release Management Client para Visual Studio 2013 no servidor de compilação, faça isso agora. Configure o Release Management Client para se conectar ao Release Management Server.

   Depois de instalar o cliente no servidor de compilação, reinicie os serviços de compilação. Você pode fazer isso no Console de Administração do Team Foundation Server.

2. Em seu modelo de versão, escolha a definição de compilação que você configurou para disparar uma compilação e marque a caixa de seleção para habilitar o processo de compilação para disparar uma versão.

   

   Se a opção Definição da Compilação não aparecer, você precisa adicionar a conexão do TFS ao Release Management Client. (Adicione a conexão usando a guia Gerenciar TFS da seção Administração.)

   Depois que a versão for disparada, ele passará pelas etapas do estágio que foi selecionado. Se você não configurar Etapa de Aceitação e Etapa da Implantação como Automatizada para estágio, a versão não será iniciada. Você deve marcar essas etapas como automatizadas no caminho da versão.

Perguntas e respostas

P: Posso usar o modelo padrão.Que modelo de processo de compilação devo usar no Release Management e como o adiciono ao TFS?

R: Se estiver usando o modelo padrão, tudo que você precisa fazer é substituí-lo pelo modelo de processo de gerenciamento de versão correspondente.

1. Se você não tem permissão para contribuir com arquivos ou editar definições de compilação, obtenha-a agora.

2. No Visual Studio, Team Explorer, conecte-se ao projeto de equipe no qual você deseja trabalhar (Teclado: Ctrl + 0, C).

3. Na pasta Unidade:\Arquivos de Programas (x86)\ Microsoft Visual Studio 12.0\ReleaseManagement\bin, localize o modelo que você precisa. Ou baixe o modelo para esse diretório do arquivo zip anexado a este post do blog.

   • TFS 2013

     • TFVC: ReleaseTfvcTemplate.12.xaml.

     • Git: ReleaseGitTemplate.12.xaml

   • TFS 2012: ReleaseDefaultTemplate.11.1.xaml

   • TFS 2010: ReleaseDefaultTemplate.xaml

4. Adicione o modelo ao controle de versão. É uma boa ideia colocar o modelo na pasta BuildProcessTemplates de seu projeto de equipe.

   • TFVC: adicionar arquivos ao servidor

   • Git: Gerenciar arquivos em seu computador de desenvolvimento

5. Na página Compilações (Teclado: Ctrl + 0, B), crie ou edite uma definição de compilação.

6. Na guia Processo, escolha Novo para selecionar o modelo a ser usado com seu Arquivo do processo de compilação. (O sistema deve permitir que você faça uma busca para selecionar o modelo que acabou de adicionar.)

P: Eu uso um modelo de processo de compilação personalizado.Como faço para adicionar a lógica de fluxo de trabalho para disparar uma versão?

R: Adicione seções ao seu modelo de processo de compilação personalizado para fornecer a lógica do fluxo de trabalho. Baixe o arquivo de trechos com essas seções desta página. Use os trechos para adicionar estes argumentos ao modelo de processo de compilação: ConfigurationsToRelease, ReleaseBuild, ReleaseTargetStage, DropBuild.

Salve o modelo de processo de compilação. Se você usar o controle de versão do Team Foundation, faça o check-in do modelo. Se você usar Git, confirme e envie por push o modelo de processo de compilação.

P: Eu uso o modelo de atualização.Que modelo de processo de compilação devo usar no Release Management?

R: Saiba o que você precisa fazer aqui.

P: Posso implantar componentes do meu aplicativo em computadores diferentes?

R:: Sim, crie componentes por meio do Release Management Client e adicione-os ao seu modelo da versão.

Em seguida, você pode adicionar esses componentes à sua compilação.

Quando a janela Componentes aparecer, clique duas vezes no componente que você deseja adicionar.

Cada componente que você adicionar deve ser configurado como Compila com aplicativo ou Compila externamente.

Uma '\' no Local de Destino da Compilação indica que a compilação está localizada na raiz da pasta de destino.

P: Que ferramentas posso usar para implantar um componente?

R: Para cada componente que você definir, você pode selecionar a ferramenta a ser usada na guia Implantação. Clique aqui para saber mais sobre cada ferramenta.

Substitua os Argumentos por informações específicas da implantação desse componente.

Para usar uma ferramenta personalizada, primeiro adicione a ferramenta na página Inventário e depois a selecione na guia Implantação.

Verifique se todos os arquivos referenciados por seu comando estão disponíveis no local de seu pacote no momento da implantação.

P: Por que minha versão não foi iniciada?

Estes são alguns problemas possíveis:

• Se você configurar sua compilação para disparar uma versão (Compilação de Versão=True) e não marcar a caixa de seleção Pode Disparar uma Versão de uma Compilação? para o modelo de versão. Isso faz com que a compilação falhe e consequentemente a versão não é iniciada.

• Se você configurar seu modelo de versão para usar uma definição de compilação que esteja configurado para disparar uma versão (Compilação de Versão=False) ou que não contém a lógica da versão correta.

• Se um modelo de versão contiver qualquer componente que esteja configurado para compilar de forma independente.

• Se você não configurar Etapa de Aceitação e Etapa da Implantação como Automatizada para o estágio selecionado para disparar a versão, a versão não será iniciada. Você deve configurar essas etapas como automatizadas para esse caminho da versão.

• Se você não tiver instalado o Release Management Client no computador que está executando o Team Foundation Build Server.

• Se o tempo necessário para uma implantação terminar exceder 10 minutos. Você pode alterar o valor atribuído ao Tempo Limite da Implantação Disparada pelo TFS na guia Administração, página Configurações.

P: Como posso lidar com os arquivos de configuração que precisam de valores diferentes com base no ambiente de destino?

R: Use arquivos de configuração com token.

Para cada arquivo de configuração em sua solução que exige valores diferentes em diferentes ambientes, crie uma versão com token desse arquivo.

Por exemplo, se sua solução contiver um arquivo denominado web.config, faça uma cópia do arquivo e nomeie-o como web.config.token. Seu arquivo web.config não muda e é usado quando você executa o aplicativo localmente. O arquivo web.config.token contém tokens em vez de valores reais.

Por exemplo, se seu arquivo web.config contiver esta linha:

<add key="SMTPHostServer" value="mysmtp.myserver.domain"/>

seu arquivo web.config.token conterá esta linha, em que SMTPHostServer é o token:

<add key="SMTPHostServer" value="SMTPHostServer"/>

Mantenha seus arquivos locais e arquivos com token sincronizados.

P: Como faço para definir quais arquivos devem ser examinados para substituir tokens por variáveis?

R: Para cada componente definido, você pode especificar o filtro de extensão de arquivo na guia Variáveis de Configuração.

O agente de implantação especificado para o componente usa a correspondência de padrões para verificar o conjunto de arquivos que precisam de tokens substituídos por variáveis. Separe duas ou mais extensões de arquivo usando ponto-e-vírgula (;).