This guide will show how to validate CBA velocity Templates.
Add pom.xml to your CBA
.
├── Definitions
│ └── hello_world.json
├── Templates
│ └── base-config-data-velocity.json
│ └── base-config-velocity-template.vtl
│ └── default-variable-value-data.json
│ └── default-variable-value-velocity-template.vtl
├── TOSCA-Metadata
│ └── TOSCA.meta
├── pom.xml
pom.xml Expand source <?xml version="1.0" encoding="UTF-8"?>
<!--
~ Copyright © 2020 Bell Canada
~
~ Licensed under the Apache License, Version 2.0 (the "License");
~ you may not use this file except in compliance with the License.
~ You may obtain a copy of the License at
~
~ http://www.apache.org/licenses/LICENSE-2.0
~
~ Unless required by applicable law or agreed to in writing, software
~ distributed under the License is distributed on an "AS IS" BASIS,
~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
~ See the License for the specific language governing permissions and
~ limitations under the License.
-->
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.onap.ccsdk.cds.components.cba</groupId>
<artifactId>blueprint-model</artifactId>
<version>1.3.0-SNAPSHOT</version>
</parent>
<artifactId>hello_world_1.0.0-CBA</artifactId>
<packaging>pom</packaging>
<name>Components Model Catalog - Blueprints Model - hello_world_1.0.0 Parent</name>
<properties>
<kotlin.version>1.6.20-RC</kotlin.version>
</properties>
<dependencies>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.modules</groupId>
<artifactId>execution-service</artifactId>
</dependency>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.functions</groupId>
<artifactId>resource-resolution</artifactId>
</dependency>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.functions</groupId>
<artifactId>netconf-executor</artifactId>
</dependency>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.functions</groupId>
<artifactId>restconf-executor</artifactId>
</dependency>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.functions</groupId>
<artifactId>cli-executor</artifactId>
</dependency>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.functions</groupId>
<artifactId>message-prioritization</artifactId>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-test-junit</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlinx</groupId>
<artifactId>kotlinx-coroutines-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.mockk</groupId>
<artifactId>mockk</artifactId>
<version>1.10.0</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>3.14.0</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-stdlib-jdk8</artifactId>
<version>${kotlin.version}</version>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-test</artifactId>
<version>${kotlin.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.onap.ccsdk.cds.blueprintsprocessor.modules</groupId>
<artifactId>blueprint-core</artifactId>
<version>1.3.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity</artifactId>
<version>1.5</version>
</dependency>
</dependencies>
<build>
<sourceDirectory>src/kotlin</sourceDirectory>
<resources>
<resource>
<directory>${project.basedir}/Environments</directory>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<executions>
<execution>
<id>pre-unit-test</id>
<phase>none</phase>
</execution>
<execution>
<id>default-prepare-agent</id>
<phase>none</phase>
</execution>
<execution>
<id>post-unit-test</id>
<phase>none</phase>
</execution>
<execution>
<id>default-report</id>
<phase>none</phase>
</execution>
<execution>
<id>pre-integration-test</id>
<phase>none</phase>
</execution>
<execution>
<id>post-integration-test</id>
<phase>none</phase>
</execution>
<execution>
<id>default-check</id>
<phase>none</phase>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-maven-plugin</artifactId>
<version>${kotlin.version}</version>
<executions>
<execution>
<id>compile</id>
<phase>compile</phase>
<goals>
<goal>compile</goal>
</goals>
</execution>
<execution>
<id>test-compile</id>
<phase>test-compile</phase>
<goals>
<goal>test-compile</goal>
</goals>
</execution>
</executions>
<configuration>
<jvmTarget>1.8</jvmTarget>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<executions>
<execution>
<id>attach-descriptor</id>
<phase>none</phase>
</execution>
</executions>
</plugin>
<plugin>
<artifactId>maven-checkstyle-plugin</artifactId>
<executions>
<execution>
<id>check-license</id>
<phase>none</phase>
</execution>
<execution>
<id>check-style</id>
<phase>none</phase>
</execution>
</executions>
</plugin>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<dependencies>
<dependency>
<groupId>org.onap.ccsdk.cds.components.cba</groupId>
<artifactId>cba-assembly-descriptor</artifactId>
<version>${ccsdk.cds.version}</version>
<exclusions>
<exclusion>
<groupId>*</groupId>
<artifactId>*</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
<configuration>
<descriptorRefs>
<descriptorRef>cba_zip</descriptorRef>
</descriptorRefs>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-failsafe-plugin</artifactId>
<executions>
<execution>
<id>default</id>
<phase>none</phase>
</execution>
<execution>
<id>integration-tests</id>
<phase>none</phase>
</execution>
</executions>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<executions>
<execution>
<id>default-test</id>
<phase>test</phase>
<goals>
<goal>test</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
<profiles>
<profile>
<id>deploy-cba</id>
<build>
<plugins>
<plugin>
<groupId>org.codehaus.gmaven</groupId>
<artifactId>groovy-maven-plugin</artifactId>
<dependencies>
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>3.14.0</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>${commons-io-version}</version>
</dependency>
</dependencies>
<executions>
<execution>
<id>deploy-cba</id>
<phase>install</phase>
<goals>
<goal>execute</goal>
</goals>
<configuration>
<source>
import okhttp3.Credentials
import okhttp3.MediaType
import okhttp3.MultipartBody
import okhttp3.OkHttpClient
import okhttp3.Request
import okhttp3.RequestBody
import org.apache.commons.io.IOUtils
import java.io.File
target = "${basedir.absolutePath}/target"
userName = throwIfPropMissing('cds.username')
password = throwIfPropMissing('cds.password')
protocol = properties['cds.protocol'] ?: 'http'
host = properties['cds.host'] ?: 'localhost'
port = properties['cds.port'] ?: '8081'
def cba = "${project.artifact.artifactId}-${project.artifact.version}-cba.zip"
def enrichedCba = "${project.artifact.artifactId}-${project.artifact.version}-enriched-cba.zip"
def enrichEndpoint = properties['cds.enrich.endpoint'] ?: 'api/v1/blueprint-model/enrich'
def publishEndpoint = properties['cds.publish.endpoint'] ?: 'api/v1/blueprint-model/publish'
def throwIfPropMissing(prop) {
value = properties[prop]
if (!value || "".equals(value)) {
throw new RuntimeException("Property missing: $prop")
}
return value
}
def buildRequest(endpoint, fileName) {
body = new MultipartBody.Builder()
.setType(MultipartBody.FORM)
.addFormDataPart("file",
fileName,
RequestBody.create(MediaType.parse('application/zip'), new File(target, fileName)))
.build()
return new Request.Builder()
.url("$protocol://$host:$port/$endpoint")
.addHeader('Authorization', Credentials.basic(userName, password))
.post(body)
.build()
}
def logAndThrow(msg) {
if(response) {
log.error(response.body().string())
}
throw new RuntimeException(msg)
}
response = null
try {
def client = new OkHttpClient()
response = client.newCall(buildRequest(enrichEndpoint, cba)).execute()
if (!response || !response.isSuccessful()) {
logAndThrow("Failed to enrich CBA")
}
IOUtils.copy(
response.body().byteStream(),
new FileOutputStream(new File(target, enrichedCba))
)
log.info("Created enriched cba: $enrichedCba")
response = client.newCall(buildRequest(publishEndpoint, enrichedCba)).execute()
if (!response || !response.isSuccessful()) {
logAndThrow("Failed to publish CBA")
}
log.info("CBA Deployed")
log.info(response.body().string())
} finally {
if (response) {
response.close()
}
}
</source>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
</profiles>
</project>
|
|---|
Add the above pom.xml to your CBA and change artifactId to your-cba-name.
| Run tests with maven |
|---|
mvn clean test |
| Build zip file |
|---|
mvn clean install
|
Add Unit tests
.
├── Definitions
│ └── hello_world.json
├── Templates
│ └── base-config-data-velocity.json
│ └── base-config-velocity-template.vtl
│ └── default-variable-value-data.json
│ └── default-variable-value-velocity-template.vtl
├── Tests
│ └── kotlin
│ └── BlueprintVelocityTemplateTest.kt
│ └── default-variable-value-data.txt
├── TOSCA-Metadata
│ └── TOSCA.meta
├── pom.xml
Kotlin unit tests should be added under /Tests/kotlin as show above. Test files must contain "Test" in the filename,
for example BlueprintVelocityTemplateTest.kt or TestBlueprintVelocityTemplate.kt
Example project:
hello_world-1.0.0-CBA.zip
Testing
After the pom is added, the CBA can be used in IntelliJ as a maven project.
Create a new empty project
.png?version=1&modificationDate=1646749031000&cacheVersion=1&api=v2&width=759&height=400)
Give it a name
.png?version=1&modificationDate=1646749073000&cacheVersion=1&api=v2&width=748&height=400)
Click the + symbol and select import module
.png?version=1&modificationDate=1646749111000&cacheVersion=1&api=v2&width=747&height=400)
Select the pom.xml in your CBA directory
.png?version=1&modificationDate=1646749178000&cacheVersion=1&api=v2&width=745&height=400)
CBA with JSON & Templates
Inorder to Validate the Templates we require JSON file where we include variable values, so that it maps to the VTL
For each variable in base-config-template.vtl we have base-config-velocity.json which has variable values
.png?version=1&modificationDate=1646750279000&cacheVersion=1&api=v2&width=741&height=400)
Similarly, we have default-variable-value-data.json which has only one variable value for default-variable-value-template.vtl
.png?version=1&modificationDate=1646750626000&cacheVersion=1&api=v2&width=750&height=400)
You should now be able to write, run unit tests
Create BlueprintVelocityTemplateTest class , Under Test directory to implement unit tests
.png?version=1&modificationDate=1646751909000&cacheVersion=1&api=v2&width=750&height=400)
Here we use the existing class BlueprintVelocityTemplateService which is in CDS container by importing it to project ,where
it has Velocity Engine implementation
.png?version=1&modificationDate=1646752023000&cacheVersion=1&api=v2&width=750&height=400)
Once you include Test code, Make sure your CBA is working properly, then run the below command in the terminal
.png?version=1&modificationDate=1646752276000&cacheVersion=1&api=v2&width=752&height=400)
Then we get Build Success. Also we can see Target folder has been created
.png?version=1&modificationDate=1646752467000&cacheVersion=1&api=v2&width=748&height=400)
You can implement following methods to test the templates
First we use assertNotNull() method means " passed parameter must not be null ": if it is null then the test case fails
.png?version=1&modificationDate=1646752944000&cacheVersion=1&api=v2&width=748&height=400)
Second , assertEquals can be used to check if two objects is equally defined or not
.png?version=1&modificationDate=1646753047000&cacheVersion=1&api=v2&width=742&height=400)
Third , we take the Expected value variable from a file
.png?version=1&modificationDate=1646753421000&cacheVersion=1&api=v2&width=749&height=400)
Then we write tests
.png?version=1&modificationDate=1646753487000&cacheVersion=1&api=v2&width=761&height=400)
Once you run the BlueprintVelocityTemplateTest class, then we get the result
.png?version=1&modificationDate=1646753704000&cacheVersion=1&api=v2&width=745&height=400)