Sharding

Por padrão, o WebdriverIO executa testes em paralelo e busca a utilização ideal dos núcleos da CPU em sua máquina. Para alcançar uma paralelização ainda maior, você pode escalar ainda mais a execução de testes do WebdriverIO executando testes em várias máquinas simultaneamente. Chamamos esse modo de operação de "sharding".

Distribuindo testes entre várias máquinas

Para dividir a suíte de testes, passe --shard=x/y para a linha de comando. Por exemplo, para dividir a suíte em quatro partes, cada uma executando um quarto dos testes:

npx wdio run wdio.conf.js --shard=1/4
npx wdio run wdio.conf.js --shard=2/4
npx wdio run wdio.conf.js --shard=3/4
npx wdio run wdio.conf.js --shard=4/4

Agora, se você executar essas partes em paralelo em diferentes computadores, sua suíte de testes será concluída quatro vezes mais rápido.

Exemplo do GitHub Actions

O GitHub Actions suporta distribuição de testes entre vários jobs usando a opção jobs.<job_id>.strategy.matrix. A opção matrix executará um job separado para cada combinação possível das opções fornecidas.

O exemplo a seguir mostra como configurar um job para executar seus testes em quatro máquinas em paralelo. Você pode encontrar toda a configuração do pipeline no projeto Cucumber Boilerplate.

• Primeiro, adicionamos uma opção de matriz à nossa configuração de job com a opção de shard contendo o número de shards que queremos criar. shard: [1, 2, 3, 4] criará quatro shards, cada um com um número de shard diferente.
• Em seguida, executamos nossos testes WebdriverIO com a opção --shard ${{ matrix.shard }}/${{ strategy.job-total }}. Este será nosso comando de teste para cada shard.
• Finalmente, fazemos upload do nosso relatório de log wdio para os Artefatos do GitHub Actions. Isso tornará os logs disponíveis caso o shard falhe.

O pipeline de teste é definido da seguinte forma:

name: Test

on: [push, pull_request]

jobs:
    lint:
        # ...
    unit:
        # ...
    e2e:
        name: 🧪 Test (${{ matrix.shard }}/${{ strategy.job-total }})
        runs-on: ubuntu-latest
        needs: [lint, unit]
        strategy:
            matrix:
                shard: [1, 2, 3, 4]
        steps:
            - uses: actions/checkout@v4
            - uses: ./.github/workflows/actions/setup
            - name: E2E Test
              run: npm run test:features -- --shard ${{ matrix.shard }}/${{ strategy.job-total }}
            - uses: actions/upload-artifact@v1
              if: failure()
              with:
                  name: logs-${{ matrix.shard }}
                  path: logs

Isso executará todos os shards em paralelo, reduzindo o tempo de execução dos testes em 4:

Veja o commit 96d444e do projeto Cucumber Boilerplate que introduziu o sharding em seu pipeline de testes, o que ajudou a reduzir o tempo total de execução de 2:23 min para 1:30 min, uma redução de 37% 🎉.