@sap/cds-dk 9.6.1 → 9.7.0

package/lib/deploy/to-hana/hana.js

@@ -24,14 +24,15 @@ const allowList = [
   '--auto-undeploy',
   '--dry',
   '--for',
+  '--no-build',
   '--on',
+  '--out',
+  '--resolve-bindings',
   '--store-credentials',
   '--to',
   '--tunnel-address',
   '--vcap-file',
-  '--with-mocks',
-  '--no-build',
-  '--resolve-bindings'
+  '--with-mocks'
 ]
 
 module.exports = new class HanaDeployer {
@@ -51,6 +52,11 @@ module.exports = new class HanaDeployer {
   }
 
   async deploy(options = {}) {
+
+    if (options.dry && options.out) { // dry run equals cds compile to hana
+      return await this._runCompileToHana(options);
+    }
+
     let unknownOptions = Object.keys(options)
       .map(key => `--${key.replace(/([A-Z])/g, '-$1').toLowerCase()}`)
       .filter(key => allOptions.includes(key) && !allowList.includes(key));
@@ -59,7 +65,7 @@ module.exports = new class HanaDeployer {
       throw `One or more options are not supported by cds deploy to hana: ${unknownOptions.join(', ')}`;
     }
 
-    let { model, serviceName: pServiceName, tunnelAddress, vcapFile, undeployWhitelist, hdiOptions = {}, dry } = options;
+    let { model, serviceName: pServiceName, tunnelAddress, vcapFile, undeployWhitelist, hdiOptions = {} } = options;
 
     options.for ??= 'hybrid';
 
@@ -69,10 +75,6 @@ module.exports = new class HanaDeployer {
 Therefore, specifying the CDS model is not required when calling 'cds deploy'.`;
     }
 
-    if (dry) {
-      console.log('--- running in dry mode ---');
-    }
-
     if (vcapFile) {
       console.log(`Using VCAP_SERVICES from file ${vcapFile}.`);
     }
@@ -97,36 +99,34 @@ Therefore, specifying the CDS model is not required when calling 'cds deploy'.`;
       buildResult = await this._build();
     }
 
+    if (options.out) {
+      await this._runCompileToHana(options);
+    }
+
+    if (options.dry) {
+      return;
+    }
+
     if (process.env.TARGET_CONTAINER) {
       vcapEnv.TARGET_CONTAINER = process.env.TARGET_CONTAINER;
     }
 
-    if (dry) {
-      if (!buildResult) return
-      const sortedResult = Array.from(buildResult.hana).sort();
-      for (const file of sortedResult) {
-        const srcPath = path.join(buildResult.dest, file);
-        console.log(`-- ${path.relative(cds.root, srcPath)}`);
-        console.log(await read(srcPath));
-        console.log();
-      }
-    } else {
-      // the primary database is always built and deployed
-      // const dest = buildResult.dest
-      const dest = path.join(cds.root, cds.env.build.target, cds.env.folders.db);
+    // the primary database is always built and deployed
+    // const dest = buildResult.dest
+    const dest = path.join(cds.root, cds.env.build.target, cds.env.folders.db);
 
-      if (undeployWhitelist) {
-        console.log('Writing undeploy.json');
-        await write(undeployWhitelist).to(dest, 'undeploy.json')
-      }
+    if (undeployWhitelist) {
+      console.log('Writing undeploy.json');
+      await write(undeployWhitelist).to(dest, 'undeploy.json')
+    }
 
-      const hasVCAPEnv = Object.keys(vcapEnv).length > 0;
+    const hasVCAPEnv = Object.keys(vcapEnv).length > 0;
 
-      let bindOptions
-      if (cds.cli.options.on === 'k8s') {
-        const cp = require('node:child_process')
-        const appName = pServiceName ?? path.basename(cds.root)
-        const instance =
+    let bindOptions
+    if (cds.cli.options.on === 'k8s') {
+      const cp = require('node:child_process')
+      const appName = pServiceName ?? path.basename(cds.root)
+      const instance =
 `apiVersion: services.cloud.sap.com/v1
 kind: ServiceInstance
 metadata:
@@ -136,7 +136,7 @@ spec:
   servicePlanName: hdi-shared
 `
 
-        const binding =
+      const binding =
 `apiVersion: services.cloud.sap.com/v1
 kind: ServiceBinding
 metadata:
@@ -144,95 +144,93 @@ metadata:
 spec:
   serviceInstanceName: ${appName}-db
   secretName: ${appName}-db-secret
-
 `
 
-        try {
-          cp.execSync('kubectl apply -f -', { input: instance })
-          cp.execSync('kubectl apply -f -', { input: binding })
-          cp.execSync(`kubectl wait --for=condition=Ready servicebinding/${appName}-db-binding --timeout=120s`)
-          cp.execSync(`kubectl wait --for=condition=Ready serviceinstance/${appName}-db --timeout=120s`)
-        } catch (error) {
-          const descr = cp.execSync(`kubectl describe serviceinstance/${appName}-db`).toString()
-          const message = descr.match(/Message:\s+(.*)/)?.[1] || 'None'
-          throw error.message + `\nInstance Message: ${message}`
-        }
+      try {
+        cp.execSync('kubectl apply -f -', { input: instance })
+        cp.execSync('kubectl apply -f -', { input: binding })
+        cp.execSync(`kubectl wait --for=condition=Ready servicebinding/${appName}-db-binding --timeout=180s`)
+        cp.execSync(`kubectl wait --for=condition=Ready serviceinstance/${appName}-db --timeout=180s`)
+      } catch (error) {
+        const descr = cp.execSync(`kubectl describe serviceinstance/${appName}-db`).toString()
+        const message = descr.match(/Message:\s+(.*)/)?.[1] || 'None'
+        throw error.message + `\nInstance Message: ${message}`
+      }
 
-        const { data: encoded } = JSON.parse(cp.execSync(`kubectl get secrets/${appName}-db-secret -o json`).toString())
-        const credentials = {}
-        for (const [key, value] of Object.entries(encoded)) {
-          credentials[key] = Buffer.from(value, 'base64').toString('utf-8');
-        }
-        vcapEnv.VCAP_SERVICES ??= {
-          hana: [{
-            tags: ['hana'],
-            credentials
-          }]
-        }
-        bindOptions = {
-          ...options,
-          to: `${appName}-db-binding`,
-          for: options.for,
-          kind: BUILD_TASK_HANA
-        }
-      } else {
-        let serviceName = pServiceName;
-        let serviceKeyName;
-        const { instance, key } = cds.requires.db?.binding ?? {};
-        if (!serviceName && instance) {
-          serviceName = instance;
-          serviceKeyName = key;
-        }
+      const { data: encoded } = JSON.parse(cp.execSync(`kubectl get secrets/${appName}-db-secret -o json`).toString())
+      const credentials = {}
+      for (const [key, value] of Object.entries(encoded)) {
+        credentials[key] = Buffer.from(value, 'base64').toString('utf-8');
+      }
+      vcapEnv.VCAP_SERVICES ??= {
+        hana: [{
+          tags: ['hana'],
+          credentials
+        }]
+      }
+      bindOptions = {
+        ...options,
+        to: `${appName}-db-binding`,
+        for: options.for,
+        kind: BUILD_TASK_HANA
+      }
+    } else {
+      let serviceName = pServiceName;
+      let serviceKeyName;
+      const { instance, key } = cds.requires.db?.binding ?? {};
+      if (!serviceName && instance) {
+        serviceName = instance;
+        serviceKeyName = key;
+      }
 
-        if (!serviceName && hasVCAPEnv) {
-          await mkdirp(dest);
-        } else {
-          const { cfServiceInstanceName, cfServiceInstanceKeyName, serviceKey } = await this._getOrCreateCFService(dest, serviceName, serviceKeyName, tunnelAddress);
-          serviceName ??= cfServiceInstanceName;
-          serviceKeyName ??= cfServiceInstanceKeyName
-          if (!vcapEnv.VCAP_SERVICES || serviceName) {
-            const base = process.env.VCAP_SERVICES ? JSON.parse(process.env.VCAP_SERVICES) : (vcapEnv.VCAP_SERVICES ?? {});
-            const hanas = Array.isArray(base.hana) ? base.hana : [];
-            let hanaTagged = hanas.filter(s => s?.name === cfServiceInstanceName || (Array.isArray(s?.tags) && s.tags.includes('hana')));
-            if (hanaTagged.length === 0) {
-              const entry = { name: cfServiceInstanceName, label: 'hana', tags: ['hana'], credentials: {} };
-              hanas.push(entry);
-              hanaTagged = [entry];
-            }
-            for (const entry of hanaTagged) {
-              entry.name ??= cfServiceInstanceName;
-              entry.tags = Array.from(new Set([...entry.tags || [], 'hana']));
-              entry.credentials = { ...(entry.credentials || {}), ...serviceKey };
-            }
-            base.hana = hanas;
-            vcapEnv.VCAP_SERVICES = base;
-            process.env.VCAP_SERVICES = JSON.stringify(base);
+      if (!serviceName && hasVCAPEnv) {
+        await mkdirp(dest);
+      } else {
+        const { cfServiceInstanceName, cfServiceInstanceKeyName, serviceKey } = await this._getOrCreateCFService(dest, serviceName, serviceKeyName, tunnelAddress);
+        serviceName ??= cfServiceInstanceName;
+        serviceKeyName ??= cfServiceInstanceKeyName
+        if (!vcapEnv.VCAP_SERVICES || serviceName) {
+          const base = process.env.VCAP_SERVICES ? JSON.parse(process.env.VCAP_SERVICES) : (vcapEnv.VCAP_SERVICES ?? {});
+          const hanas = Array.isArray(base.hana) ? base.hana : [];
+          let hanaTagged = hanas.filter(s => s?.name === cfServiceInstanceName || (Array.isArray(s?.tags) && s.tags.includes('hana')));
+          if (hanaTagged.length === 0) {
+            const entry = { name: cfServiceInstanceName, label: 'hana', tags: ['hana'], credentials: {} };
+            hanas.push(entry);
+            hanaTagged = [entry];
           }
+          for (const entry of hanaTagged) {
+            entry.name ??= cfServiceInstanceName;
+            entry.tags = Array.from(new Set([...entry.tags || [], 'hana']));
+            entry.credentials = { ...(entry.credentials || {}), ...serviceKey };
+          }
+          base.hana = hanas;
+          vcapEnv.VCAP_SERVICES = base;
+          process.env.VCAP_SERVICES = JSON.stringify(base);
+        }
 
-          if (!hasVCAPEnv) {
-            bindOptions = {
-              ...options,
-              to: `${serviceName}:${serviceKeyName}`,
-              for: options.for,
-              kind: BUILD_TASK_HANA
-            }
+        if (!hasVCAPEnv) {
+          bindOptions = {
+            ...options,
+            to: `${serviceName}:${serviceKeyName}`,
+            for: options.for,
+            kind: BUILD_TASK_HANA
           }
         }
       }
+    }
 
-      console.log(`${bold('starting deployment to SAP HANA ...')}`);
-      DEBUG?.({ dest, vcapEnv, hdiOptions })
-      await hdi.deploy(dest, vcapEnv, hdiOptions);
+    console.log(`${bold('starting deployment to SAP HANA ...')}`);
+    DEBUG?.({ dest, vcapEnv, hdiOptions })
+    await hdi.deploy(dest, vcapEnv, hdiOptions);
 
-      if (!hasVCAPEnv) {
-        const services = await bind(bindOptions)
-        await storeBindings(services, bindOptions)
-      }
+    if (!hasVCAPEnv) {
+      const services = await bind(bindOptions)
+      await storeBindings(services, bindOptions)
+    }
 
-      const { env4 } = require('../../init/projectReader')
-      if (env4('production').requires?.db?.kind !== 'hana') {
-        console.log(`use ${info('cds add hana')} to configure the project for SAP HANA.\n`);
-      }
+    const { env4 } = require('../../init/projectReader')
+    if (env4('production').requires?.db?.kind !== 'hana') {
+      console.log(`use ${info('cds add hana')} to configure the project for SAP HANA.\n`);
     }
 
     console.log(`successfully finished deployment`);
@@ -245,6 +243,16 @@ spec:
     return buildResult;
   }
 
+  async _runCompileToHana(options) {
+    const csn = await cds.load('*');
+    const files = cds.compile.to.hana(csn, options);
+    const outDir = path.resolve(cds.root, options.out);
+    for (const [content, { file }] of files) {
+      const filePath = path.join(outDir, file);
+      await cds.utils.write(content).to(filePath);
+    }
+  }
+
   async _getOrCreateCFService(currentModelFolder, serviceName, serviceKeyName, tunnelAddress) {
 
     // get from param

package/lib/env/schemas/cds-rc.js

@@ -285,8 +285,6 @@ module.exports = {
                 "mtx-sidecar",
                 "mtx-extension",
                 "mtx",
-                "node-cf",
-                "java-cf",
                 "helm"
             ]),
             enumDescriptions: [
@@ -296,8 +294,6 @@ module.exports = {
                 "MTX sidecar build plugin",
                 "MTX extension build plugin",
                 "MTX build plugin",
-                "Node.js Cloud Foundry build plugin",
-                "Java Cloud Foundry build plugin",
                 "Helm chart build plugin"
             ]
         },

package/lib/import/odata/v4parser.js

@@ -122,7 +122,7 @@ function _getIndexAndNamespaceOfSchema(fqName, schemaName, parserContext) {
     }
     // the schema namespace is not resolvable, throw error
     else {
-        throw new Error(messages.UNRESOLVED_SCHEMA_NAMESPACE + fqName );
+        throw new Error(messages.UNRESOLVED_SCHEMA_NAMESPACE + fqName);
     }
 }
 
@@ -290,7 +290,7 @@ function _replaceSpecialCharacters(text) {
 function _resolveCoreTerm(annotationTerm, annotationTermObject, csnDefsTargetObject) {
     if (annotationTerm === "@Core.Description" || annotationTerm === "@Core.LongDescription") {
         // we don't capture `null` value for doc
-        if (annotationTermObject === null)  return;
+        if (annotationTermObject === null) return;
 
         annotationTermObject = _replaceSpecialCharacters(annotationTermObject);
 
@@ -474,9 +474,9 @@ function _resolveAnnotationTerm(schemaDataAnnotation, parserContext) {
     let index = schemaDataAnnotation.indexOf('"@');
     while (index != -1) {
         let i = schemaDataAnnotation.indexOf('"', index + 1);
-        let annotationTerm = schemaDataAnnotation.substring(index+1, i);
+        let annotationTerm = schemaDataAnnotation.substring(index + 1, i);
         _validateAnnotationNamespace(annotationTerm, parserContext.vocabNamespaceToAlias);
-        index = schemaDataAnnotation.indexOf('"@', i+1);
+        index = schemaDataAnnotation.indexOf('"@', i + 1);
     }
 
     return JSON.parse(schemaDataAnnotation);
@@ -688,10 +688,23 @@ function _parseAssociationProperty(foreignReference, associationNode, parserCont
     // "generation" of keys, that do not exist in the external service.
     if (associationNode.$Partner && associationProperty.type === 'cds.Composition') {
         associationProperty.on = [
-            {ref: [foreignReference, associationNode.$Partner]},
+            { ref: [foreignReference, associationNode.$Partner] },
             '=',
-            {ref: ['$self']}
+            { ref: ['$self'] }
         ]
+    } else if (associationNode.$ReferentialConstraint) {
+        associationProperty.on = []
+        for (const constraint in associationNode.$ReferentialConstraint) {
+            if (associationProperty.on.length) {
+                associationProperty.on.push('and')
+            }
+            associationProperty.on.push(
+                { ref: [foreignReference, associationNode.$ReferentialConstraint[constraint]] },
+                '=',
+                { ref: [constraint] }
+            )
+        }
+
     } else if (common.checkForEmptyKeys(associationProperty, "V4")) {
         associationProperty.keys = [];
     }
@@ -738,52 +751,63 @@ function _parsePropertyContent(csnObj, elementObj, parserContext) {
     const isPrimaryKey = true;
     let dataType, isPrimitiveType, keySet = [];
 
-    Object.keys(elementObj).forEach(objKey => {
-        const contentKind = elementObj[objKey].$Kind;
-        contentObj = elementObj[objKey];
-
-        if ((objKey.indexOf('@') === -1) && (objKey.indexOf('.') === -1)) {
-            if (contentObj instanceof Object) {
-                if (contentObj.$Type) {
-                    dataType = contentObj.$Type;
-                    isPrimitiveType = dataType.startsWith('Edm') ? true : false;
-                }
-                if (objKey === '$Key') {
-                    keySet.push(...elementObj.$Key);
-                }
-                // primitive datatypes
-                else if (isPrimitiveType) {
-                    if (edmPrimitiveTypes.includes(dataType)) {
-                        csnObj.elements[objKey] = _generatePrimitiveDataTypeCsn(contentObj,
-                            (keySet.includes(objKey) ? isPrimaryKey : !isPrimaryKey),
-                            parserContext
-                        );
-                    } else {
-                        throw new Error(messages.INVALID_DATATYPE + `'${dataType}' in element: '${objKey}'`)
+    Object.keys(elementObj)
+        .sort((ele1, ele2) => {
+            if (elementObj[ele1]?.$Kind === elementObj[ele2]?.$Kind) {
+                return 0
+            } else if (elementObj[ele1]?.$Kind === 'NavigationProperty') {
+                return 1
+            } else if (elementObj[ele2]?.$Kind === 'NavigationProperty') {
+                return -1
+            }
+            return 0
+        })
+        .forEach(objKey => {
+            const contentKind = elementObj[objKey].$Kind;
+            contentObj = elementObj[objKey];
+
+            if ((objKey.indexOf('@') === -1) && (objKey.indexOf('.') === -1)) {
+                if (contentObj instanceof Object) {
+                    if (contentObj.$Type) {
+                        dataType = contentObj.$Type;
+                        isPrimitiveType = dataType.startsWith('Edm') ? true : false;
                     }
-                }
-                // structured datatypes
-                else if (!isPrimitiveType && !(contentKind === 'NavigationProperty')) {
-                    const dataKind = _checkIsStructureTypeAndReturnDataKind(dataType, contentObj, 'property', parserContext);
-
-                    if (['EnumType', 'TypeDefinition'].includes(dataKind)) {
-                        csnObj.elements[objKey] = _generateStructuredDataTypeCsn(dataType, contentObj,
-                            (keySet.includes(dataType) ? isPrimaryKey : !isPrimaryKey),
-                            dataKind, 'property', parserContext
-                        );
+                    if (objKey === '$Key') {
+                        keySet.push(...elementObj.$Key);
                     }
-                    else {
-                        csnObj.elements[objKey] = _generateStructuredDataTypeCsn(dataType, contentObj,
-                            !isPrimaryKey, dataKind, 'property', parserContext
-                        );
+                    // primitive datatypes
+                    else if (isPrimitiveType) {
+                        if (edmPrimitiveTypes.includes(dataType)) {
+                            csnObj.elements[objKey] = _generatePrimitiveDataTypeCsn(contentObj,
+                                (keySet.includes(objKey) ? isPrimaryKey : !isPrimaryKey),
+                                parserContext
+                            );
+                        } else {
+                            throw new Error(messages.INVALID_DATATYPE + `'${dataType}' in element: '${objKey}'`)
+                        }
+                    }
+                    // structured datatypes
+                    else if (!isPrimitiveType && !(contentKind === 'NavigationProperty')) {
+                        const dataKind = _checkIsStructureTypeAndReturnDataKind(dataType, contentObj, 'property', parserContext);
+
+                        if (['EnumType', 'TypeDefinition'].includes(dataKind)) {
+                            csnObj.elements[objKey] = _generateStructuredDataTypeCsn(dataType, contentObj,
+                                (keySet.includes(dataType) ? isPrimaryKey : !isPrimaryKey),
+                                dataKind, 'property', parserContext
+                            );
+                        }
+                        else {
+                            csnObj.elements[objKey] = _generateStructuredDataTypeCsn(dataType, contentObj,
+                                !isPrimaryKey, dataKind, 'property', parserContext
+                            );
+                        }
+                    }
+                    else if (contentKind === 'NavigationProperty') {
+                        csnObj.elements[objKey] = _parseAssociationProperty(objKey, elementObj[objKey], parserContext);
                     }
-                }
-                else if (contentKind === 'NavigationProperty') {
-                    csnObj.elements[objKey] = _parseAssociationProperty(objKey, elementObj[objKey], parserContext);
                 }
             }
-        }
-    });
+        });
 }
 
 function _addBlobElement() {
@@ -960,7 +984,7 @@ function _parseBoundActionFunction(schemaData, csnObj, kind, parserContext) {
     const boundObject = (kind === 'action') ? parserContext.entityToBoundActions : parserContext.entityToBoundFunctions;
 
     Object.keys(boundObject).forEach(fqEntityName => {
-        const [schemaName, ] = _extractSchemaNameAndElementName(fqEntityName);
+        const [schemaName,] = _extractSchemaNameAndElementName(fqEntityName);
 
         if (schemaName === schemaData.$SchemaNamespace) {
             const actionFunctionObjectList = boundObject[fqEntityName];
@@ -982,7 +1006,7 @@ function _parseUnboundActionFunction(schemaData, kind, parserContext) {
     const csnObj = {};
 
     Object.keys(unboundObject).forEach(fqName => {
-        const [schemaName, ] = _extractSchemaNameAndElementName(fqName);
+        const [schemaName,] = _extractSchemaNameAndElementName(fqName);
 
         if (schemaName === schemaData.$SchemaNamespace) {
             const actionFunctionObject = unboundObject[fqName];
@@ -1039,7 +1063,7 @@ function _parserCSNForComplexType(schemaData, parserContext) {
 
 function _parseCSNForEnumType(schemaData, parserContext) {
     const nonMemberList = ["$Kind", "$Type", "$UnderlyingType", "$IsFlags"];
-    const possibleCdsTypes = ['cds.Integer',  'cds.Integer64'];
+    const possibleCdsTypes = ['cds.Integer', 'cds.Integer64'];
     const enumCsn = {};
     const isKey = true;
 
@@ -1058,7 +1082,7 @@ function _parseCSNForEnumType(schemaData, parserContext) {
             let underlyingType = enumObj.$UnderlyingType;
             enumObj.$Type = underlyingType;
 
-            let cdsType = underlyingType ? (_generatePrimitiveDataTypeCsn(enumObj, !isKey, parserContext)) : { type : 'cds.Integer' };
+            let cdsType = underlyingType ? (_generatePrimitiveDataTypeCsn(enumObj, !isKey, parserContext)) : { type: 'cds.Integer' };
             enumCsn[fqName].type = cdsType.type;
 
             if (cdsType['@odata.Type']) {
@@ -1127,7 +1151,7 @@ function _resolveEntityContainerAnnotationTarget(targetPath, csnDefs, hasPropert
     }
     // direct path to service object
     else {
-       return csnDefs[parserContext.primarySchema];
+        return csnDefs[parserContext.primarySchema];
     }
 }
 
@@ -1396,7 +1420,7 @@ function _populateUnboundActionFunction(isAction, fqName, schemaDataList, parser
             actionFunctionObject['$Parameter'] = [];
             parserContext.unboundFunctions[fqName] = actionFunctionObject;
             parserContext.unboundFunctions[fqName]["@cds.validate"] = false;
-            if(parserContext.unboundFunctions[fqName].$ReturnType){
+            if (parserContext.unboundFunctions[fqName].$ReturnType) {
                 parserContext.unboundFunctions[fqName].$ReturnType.$Type = "Edm.String";
             }
         }
@@ -1611,8 +1635,7 @@ function _preProcess(edmxAsJson, parserContext, importerContext) {
         parserContext.entityToEntitySetMap._.size === 0 &&
         parserContext.entityToSingletonMap._.size === 0 &&
         parserContext.actionToActionImportMap._.size === 0 &&
-        parserContext.functionToFunctionImportMap._.size === 0)
-    {
+        parserContext.functionToFunctionImportMap._.size === 0) {
         parserContext.mockServerUc = false;
     }
 
@@ -1686,7 +1709,8 @@ function _generateCSN(edmxAsJson, ignorePersistenceSkip, parserContext, importer
                 compTarget.elements[e].type === 'cds.Association' &&
                 compTarget.elements[e].target === eName
             )
-            if (compTarget.elements[backLink]?.keys) {
+            const entityKeys = Object.keys(entity.elements).filter(ele => entity.elements[ele].key)
+            if (compTarget.elements[backLink]?.keys && !entityKeys.some(key => compTarget.elements[backLink + '_' + key])) {
                 delete compTarget.elements[backLink].keys
             }
         }

package/lib/init/constants.js

@@ -5,7 +5,7 @@ module.exports = {
     COMMAND_ADD: 'add',
 
     JAVA_LTS_VERSIONS: [17, 21],
-    MAVEN_ARCHETYPE_VERSION: '4.6.1',
+    MAVEN_ARCHETYPE_VERSION: '4.6.2',
 
     OPTIONS: Object.freeze({
         COMPLETION: 'completion',
@@ -82,7 +82,10 @@ module.exports = {
         CAPIRE: 'https://cap.cloud.sap',
         MAVEN_ARCHETYPE_HELP: `https://cap.cloud.sap/docs/java/developing-applications/building#the-maven-archetype`,
         MAVEN_INSTALL_HELP: `https://maven.apache.org/install.html`,
-        CF_CLI: 'https://github.com/cloudfoundry/cli'
+        CF_INSTALL: 'https://docs.cloudfoundry.org/cf-cli/install-go-cli.html',
+        HELM_INSTALL: 'https://helm.sh/docs/intro/install/',
+        KUBECTL_INSTALL: 'https://kubernetes.io/docs/tasks/tools/',
+        DOCKER_INSTALL: 'https://docs.docker.com/get-docker/'
     }),
 
     PROJECT_FILES: ['package.json', 'pom.xml', '.cdsrc.json']