🌱 Stop test suite when a capi e2e test fails

[wfernandes]

What this PR does / why we need it:
This PR adds the ginkgo --failFast flag to our ginkgo run.

For Reviewers
However, if our test suites are run in parallel, then I don't believe a failing test will stop all the parallel runs.
If you'd like to verify this,

1. in the root Makefile set GINKGO_NODES and GINKGO_ARGS,

    .PHONY: test-e2e
    test-e2e: ## Run the e2e tests
          #The `-stream` flag will stream output from all parallel nodes in real-time, prepending each log line with the node # that emitted it.
          GINKGO_NODES=3 GINKGO_ARGS="--failFast -stream" $(MAKE) -C test/e2e run

2. Then run make test-e2e.

Which issue(s) this PR fixes (optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged):
Fixes #3571

[wfernandes]

/test pull-cluster-api-e2e

[randomvariable]

/lgtm

[randomvariable]

/remove lgtm

[randomvariable]

/lgtm cancel

[randomvariable]

/lgtm

[fabriziopandini]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: fabriziopandini

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [fabriziopandini]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment