Adding an E2E test that runs a full CAPL cluster test (default, k3s, & rke2) on merging to main

[komer3]

What type of PR is this?
/kind testing

What this PR does / why we need it:
This PR contains the following changes:

• New e2e tests for 3 flavors default, k3s, and rke2
• New feature to allow selecting specific e2e tests using --selector LABEL flag (check testing docs for more detail)
• A complete e2e test (All the e2e test) that runs when a PR is merged into the main branch
• Adding some catch blocks for debugging

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 #

Special notes for your reviewer:

TODOs:

• squashed commits
• includes documentation
• adds unit tests
• adds or updates e2e tests

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 64.40%. Comparing base (1af26a0) to head (f6425ba).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #266   +/-   ##
=======================================
  Coverage   64.40%   64.40%           
=======================================
  Files          30       30           
  Lines        1750     1750           
=======================================
  Hits         1127     1127           
  Misses        574      574           
  Partials       49       49           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[eljohnson92]

given we are always including the selector here, can we maybe have --selector ${E2E_SELECTOR} ${E2E_FLAGS} and do the switches in GHA?

[amold1]

There's quite a lot of duplication where we have multiple files creating the same resources in different directories. I'll try to refactor this so we have all of them in one place along with the try..catch blocks.