Update component to make CCM container image configurable

Also update manifest fetching to use the image tag by default. We keep
the `manifests_version` parameter, but deprecated it and default it to
the CCM image tag. Users which set the parameter will get a deprecation
warning if they use `manifests_version` with a version that differs from
the configured image tag.

Additionally, by using the best practices `images` config parameter, we
should get automated Renovate version updates for the cloudscale CCM.

Author: simu

class/defaults.yml

@@ -4,7 +4,12 @@ parameters:
       multi_tenant: true
     namespace: syn-cloudscale-cloud-controller-manager
 
-    manifests_version: 1.1.0
+    manifests_version: ${cloudscale_cloud_controller_manager:images:cloudscale_cloud_controller_manager:tag}
+    images:
+      cloudscale_cloud_controller_manager:
+        registry: quay.io
+        repository: cloudscalech/cloudscale-cloud-controller-manager
+        tag: 1.1.0
 
     args: []
 

component/main.jsonnet

@@ -5,10 +5,21 @@ local inv = kap.inventory();
 local params = inv.parameters.cloudscale_cloud_controller_manager;
 local isOpenShift = std.member([ 'openshift4', 'oke' ], inv.parameters.facts.distribution);
 
+local manifests_version =
+  local ccm_tag = params.images.cloudscale_cloud_controller_manager.tag;
+  if params.manifests_version != ccm_tag then
+    std.trace(
+      'Parameter `manifests_version` is deprecated, we recommend using ' +
+      '`images.cloudscale_cloud_controller_manager.tag` to configure the CCM version.',
+      params.manifests_version
+    )
+  else
+    ccm_tag;
+
 local manifests = std.parseJson(
   kap.yaml_load_stream(
     '%s/manifests/%s/config.yml'
-    % [ inv.parameters._base_directory, params.manifests_version ]
+    % [ inv.parameters._base_directory, manifests_version ]
   )
 );
 
@@ -21,6 +32,9 @@ local patchDaemonset(obj) =
             containers: [
               if c.name == 'cloudscale-cloud-controller-manager' then
                 c {
+                  image:
+                    '%(registry)s/%(repository)s:%(tag)s' %
+                    params.images.cloudscale_cloud_controller_manager,
                   command+: params.args,
                 }
               else

docs/modules/ROOT/pages/references/parameters.adoc

@@ -14,10 +14,26 @@ The namespace in which to deploy this component.
 
 [horizontal]
 type:: string
-defaults:: [See `class/defaults.yml`]
+defaults:: `${cloudscale_cloud_controller_manager:images:cloudscale_cloud_controller_manager:tag}`
+
+[IMPORTANT]
+====
+This parameter is deprecated.
+Users should use parameter `images.cloudscale_cloud_controller_manager.tag` to select the manifests version that the component uses.
+====
 
 The cloudscale CCM version to deploy.
 
+== `images`
+
+[horizontal]
+type:: object
+defaults:: [See `class/defaults.yml`]
+
+The container images to use.
+
+NOTE: The component uses the value of `images.cloudscale_cloud_controller_manager.tag` when downloading the upstream manifests which form the base for the manifests generated by the component.
+
 == `args`
 
 [horizontal]