Make jobs karaf-version specific, some duplicities

Make jobs karaf-version specific, some duplicities

+ Affected jobs: distribution-check, csit, *patch-test, deploy, offline.
+ Carbon: csit and *patch pick one version, other affected run both.
+ Introduced KARAF_VERSION bash variable.
+ Macro to set that variable.
+ Default value set to 'karaf4'.
+ Pre-carbon branches (and caron temporarily) use 'karaf3'.
+ Karaf version usually configurable per job definition and stream.
+ csit-verify jobs use {verify-karaf-version} from releng defaults.
+ Scripts -bundle-vars, -distribution-check, -deploy, -offline renamed.
+ Macros which include (some of) them also renamed to match.
+ The bundle script sets artifact name and path from karaf version.
+ KARAF_ARTIFACT computed and used instead of distribution-karaf.
+ The part detecting version from nexus moved to separate macro.
+ The nexus upload macro tolerates failures (for Sandbox).
+ The nexus upload macro cats log to console to see attempted URL is ok.
+ High level macros usually call dependent macros (unless duplication).
+ Also they inject their property file right away.
+ BUNDLE_URL and ACTUAL_BUNDLE_URL always with underscores.
- BUNDLEVERSION and BUNDLEFOLDER still without underscores, cause Robot.
+ On yaml side, bundle-url always with dash.
+ concurrent:false for distribution deploy and offline jobs.
+ distribution-jobs moved to jjb/integration/distribution/.
+ Separated distribution-templates (distribution-check moved there)..
+ Simple Yaml string without quotes, unless that looks ugly in lists.
+ Description comments moved inside to not repeat the name.
+ Used by field dropped, Argumens and Required added (TODOs left).
+ Some typos from previous changes corrected.
+ Random bash linting improvements.
- Two carbon distribution-check jobs is a waste, worth fixing?
- Karaf4 bin/client is failing, to be fixed later (affects offline job).
- No alternative to Nexus uploading for Sandbox.
- Releng/Integration/Distribution stuff to be named and placed better.
- Some jobs get KARAF_VERSION even if they do not need that (yet).
- Code de-duplication left for another time.

Change-Id: I85c71a7ea94b9383b932d65b496056865bcecf78
Signed-off-by: Vratko Polak <vrpolak@cisco.com>