Esta página aborda sistemas de build baseados em tarefas, como eles funcionam e alguns dos e complicações que podem ocorrer com sistemas baseados em tarefas. Depois dos scripts de shell, os sistemas de build baseados em tarefas são a próxima evolução lógica do build.
Noções básicas sobre sistemas de build baseados em tarefas
Em um sistema de build baseado em tarefas, a unidade de trabalho fundamental é a tarefa. Cada tarefa é um script que pode executar qualquer tipo de lógica, e as tarefas especificam outras tarefas como dependências que precisam ser executadas antes delas. A maioria dos principais sistemas de build em uso hoje, como Ant, Maven, Gradle, Grunt e Rake, são baseados em tarefas. Em vez de scripts de shell, a maioria dos sistemas de build modernos exige que os engenheiros criem arquivos de build que descrevem como executar o build.
Confira este exemplo do manual do Ant (link em inglês):
<project name="MyProject" default="dist" basedir=".">
<description>
simple example build file
</description>
<!-- set global properties for this build -->
<property name="src" location="src"/>
<property name="build" location="build"/>
<property name="dist" location="dist"/>
<target name="init">
<!-- Create the time stamp -->
<tstamp/>
<!-- Create the build directory structure used by compile -->
<mkdir dir="${build}"/>
</target>
<target name="compile" depends="init"
description="compile the source">
<!-- Compile the Java code from ${src} into ${build} -->
<javac srcdir="${src}" destdir="${build}"/>
</target>
<target name="dist" depends="compile"
description="generate the distribution">
<!-- Create the distribution directory -->
<mkdir dir="${dist}/lib"/>
<!-- Put everything in ${build} into the MyProject-${DSTAMP}.jar file -->
<jar jarfile="${dist}/lib/MyProject-${DSTAMP}.jar" basedir="${build}"/>
</target>
<target name="clean"
description="clean up">
<!-- Delete the ${build} and ${dist} directory trees -->
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>
</project>
O buildfile é escrito em XML e define alguns metadados simples sobre o build.
com uma lista de tarefas (as tags <target>
no XML). (Ant usa a palavra
target para representar uma tarefa e usar a palavra tarefa para se referir a
commands. Cada tarefa executa uma lista de comandos possíveis definidos pelo Ant,
que inclui a criação e a exclusão de diretórios, a execução de javac
e
a criação de um arquivo JAR. Esse conjunto de comandos pode ser estendido por plug-ins fornecidos pelo usuário
para cobrir qualquer tipo de lógica. Cada tarefa também pode definir as tarefas das quais
depende pelo atributo "depends". Essas dependências formam um gráfico acíclico,
como mostrado na Figura 1.
Figura 1. Gráfico acíclico mostrando dependências
Os usuários realizam builds fornecendo tarefas para a ferramenta de linha de comando do Ant. Por exemplo:
quando um usuário digita ant dist
, o Ant segue as seguintes etapas:
- Carrega um arquivo chamado
build.xml
no diretório atual e o analisa para crie a estrutura do gráfico mostrado na figura 1. - Procura a tarefa
dist
fornecida na linha de comando e descobre que ela tem uma dependência da tarefacompile
. - Procura a tarefa chamada
compile
e descobre que ela tem uma dependência a tarefa chamadainit
. - Procura a tarefa chamada
init
e descobre que ela não tem dependências. - Executa os comandos definidos na tarefa
init
. - Executa os comandos definidos na tarefa
compile
, já que tudo isso dependências da tarefa tenham sido executadas. - Executa os comandos definidos na tarefa
dist
, já que tudo isso dependências da tarefa tenham sido executadas.
No final, o código executado pelo Ant ao executar a tarefa dist
é equivalente
no seguinte script de shell:
./createTimestamp.sh
mkdir build/
javac src/* -d build/
mkdir -p dist/lib/
jar cf dist/lib/MyProject-$(date --iso-8601).jar build/*
Quando a sintaxe é removida, o buildfile e o script de build não são muito diferentes. Mas já ganhamos muito fazendo isso. Podemos
criar novos arquivos de build em outros diretórios e vinculá-los. Podemos adicionar facilmente
novas tarefas que dependem de tarefas atuais de maneiras arbitrárias e complexas. Qa
você só precisa transmitir o nome de uma tarefa para a ferramenta de linha de comando ant
, e ela
determina tudo que precisa ser executado.
Ant é um software antigo, originalmente lançado em 2000. Outras ferramentas, como O Maven e o Gradle melhoraram o Ant nos anos seguintes e essencialmente e o substituiu por recursos como o gerenciamento automático dependências e uma sintaxe mais limpa sem nenhum XML. Mas a natureza desses novos permanecem os mesmos: eles permitem que os engenheiros escrevam scripts de build em um com princípios e modulares como tarefas e fornecem ferramentas para a execução dessas tarefas e gerenciar dependências entre eles.
O lado sombrio dos sistemas de build baseados em tarefas
Como essas ferramentas permitem que os engenheiros definam qualquer script como uma tarefa, eles são extremamente poderosos, permitindo que você faça quase tudo o que pode imaginar com eles. Mas esse poder tem desvantagens, e sistemas de compilação baseados em tarefas podem à medida que os scripts de build ficam mais complexos. O problema com esses sistemas é que eles acabam dando muito poder aos engenheiros e não o suficiente para o sistema. Como o sistema não tem ideia do que os scripts estão fazendo, a performance sofre, já que ele precisa ser muito conservador na forma como programa e executa as etapas de build. E não há como o sistema confirmar se cada script está fazendo o que deveria. Por isso, os scripts tendem a aumentar de complexidade e acabam sendo outra coisa que precisa de depuração.
Dificuldade de paralelizar etapas de build
As estações de trabalho de desenvolvimento modernas são bastante potentes, com várias cores que são capazes de executar várias etapas de build em paralelo. No entanto, os sistemas baseados em tarefas geralmente não conseguem executar tarefas em paralelo, mesmo quando parece que deveriam. Suponha que a tarefa A dependa das tarefas B e C. Como as tarefas B e C não dependem uma da outra, é seguro executá-las ao mesmo tempo para que o sistema chegue mais rapidamente à tarefa A? Talvez, se eles não tocarem em nenhum dos mesmos recursos. Mas talvez não; talvez ambos usem o mesmo arquivo para acompanhar os status e executá-las ao mesmo tempo causa um conflito. Não há maneira em geral para o sistema saber, então ele tem que arriscar esses conflitos (levando a problemas de compilação raros, mas muito difíceis de depurar), ou precisa restringir todo o build para execução em uma única linha de execução em um único processo. Isso pode ser um grande desperdício de uma poderosa máquina de desenvolvedor exclui a possibilidade de distribuir o build em várias máquinas.
Dificuldade em executar builds incrementais
Um bom sistema de build permite que os engenheiros realizem builds incrementais confiáveis, de modo que uma pequena mudança não exija que todo o código-base seja recriado do zero. Isso é ainda mais importante se o sistema de build for lento e não conseguir paralelize as etapas de build pelos motivos mencionados. Mas, infelizmente, os sistemas de build baseados em tarefas também têm dificuldades. Como as tarefas podem fazer qualquer coisa, em geral, não há como verificar se elas já foram concluídas. Muitas tarefas basta executar um compilador para criar um conjunto de arquivos-fonte binaries; Assim, eles não precisam ser executados novamente se os arquivos de origem não mudaram. Mas, sem informações adicionais, o sistema não pode dizer isso com certeza. Talvez a tarefa faça o download de um arquivo que poderia ter sido alterado, ou talvez grava um carimbo de data/hora que pode ser diferente em cada execução. Para garantir a correção, o sistema normalmente precisa executar todas as tarefas durante cada build. Algumas os sistemas de build tentam ativar builds incrementais permitindo que os engenheiros especifiquem condições sob as quais uma tarefa precisa ser executada novamente. Às vezes, isso é possível, mas muitas vezes é um problema muito mais complicado do que parece. Por exemplo, em linguagens como C++, que permitem a inclusão direta de arquivos por outros arquivos, é impossível determinar todo o conjunto de arquivos que devem ser monitorados quanto a alterações sem analisar as origens de entrada. Os engenheiros muitas vezes acabam usando atalhos esses atalhos podem levar a problemas raros e frustrantes em que o resultado de uma tarefa reutilizados mesmo quando não deveriam ser. Quando isso acontece com frequência, os engenheiros o hábito de fazer a limpeza antes de cada build para obter um novo estado, anulando completamente o propósito de ter um build incremental na lugar Descobrir quando uma tarefa precisa ser executada novamente é surpreendentemente sutil e é trabalhos mais bem administrados por máquinas do que por humanos.
Dificuldade em manter e depurar scripts
Por fim, os scripts de compilação impostos pelos sistemas de compilação baseados em tarefas geralmente são apenas difíceis de trabalhar. Embora eles recebam menos atenção, os scripts de build são códigos como o sistema em desenvolvimento e são lugares fáceis para bugs se esconderem. Confira alguns exemplos de bugs muito comuns ao trabalhar com um sistema de build baseado em tarefas:
- A tarefa A depende da tarefa B para produzir um arquivo específico como saída. O proprietário da tarefa B não percebe que outras tarefas dependem dela, então muda para em um local diferente. Ele só será detectado se alguém tenta executar a tarefa A e descobre que ela falha.
- A Tarefa A depende da tarefa B, que depende da tarefa C, que está produzindo uma arquivo específico como saída que é necessária para a tarefa A. O proprietário da tarefa B decide que não precisa mais depender da tarefa C, o que faz com que a tarefa A falha de A, mesmo que a tarefa B não se importe com a tarefa C!
- O desenvolvedor de uma nova tarefa acidentalmente faz uma suposição máquina que executa a tarefa, como a localização de uma ferramenta ou o valor variáveis de ambiente específicas. A tarefa funciona na máquina, mas falha sempre que outro desenvolvedor testar.
- Uma tarefa contém um componente não determinístico, como o download de um arquivo da Internet ou a adição de um carimbo de data/hora a um build. Agora, as pessoas ficam resultados potencialmente diferentes cada vez que o build é executado, ou seja, os engenheiros nem sempre conseguem reproduzir e corrigir as falhas uns dos outros ou falhas que ocorrem em um sistema de build automatizado.
- Tarefas com várias dependências podem criar disputas. Se a tarefa A depende da tarefa B e da tarefa C, e as tarefas B e C modificam a mesma arquivo, a tarefa A obtém um resultado diferente dependendo de qual das tarefas B e C terminar primeiro.
Não há uma maneira de uso geral para resolver esses problemas de desempenho, problemas de manutenção no framework baseado em tarefas disposto aqui. Enquanto os engenheiros puderem escrever códigos arbitrários que são executados durante o build, o sistema não poderá ter informações suficientes para sempre executar builds de maneira rápida e correta. Para resolver o problema, precisamos tirar energia das mãos de para engenheiros e colocá-los de volta nas mãos do sistema e reconcedê-los função do sistema não como execução de tarefas, mas como produção de artefatos.
Essa abordagem levou à criação de sistemas de build baseados em artefatos, como Blaze e Bazel.