In this tutorial, we will create a CBA using the archetype-blueprint Archetypes and compile and deploy it. Before you begin, you will need to have installed Maven, but you no longer need to manually install the archetype-blueprin Archetypes as they are in the Central Maven Nexus Repository now, so you just need to make sure your index is up to datemvn settings.xml file points to this repo.
Maven archetypes can be thought of as templates that are installed into the Maven environment and can be used to generate new applications from scratch that are pre-configured for certain environments. We use this to generate CBA boilerplate code.
Boilerplate CBA from the command line.
Requirement: Please add the following repository to your maven settings.xml once. This helps the maven-archetype-plugin to fetch the correct archetype.
Code Block |
---|
<repositories> --- <repository> <!-- id expected by maven-archetype-plugin to avoid fetching from everywhere --> <id>archetype</id> <url>http://nexus.onap.org/content/repositories/snapshots</url> <releases> <enabled>true</enabled> <checksumPolicy>fail</checksumPolicy> </releases> <snapshots> <enabled>true</enabled> <checksumPolicy>warn</checksumPolicy> </snapshots> </repository> --- </repositories> |
- Start by opening up a command prompt and navigating to the directory your project will reside in
The easy way to create a project on the command line is to just type
1
mvn archetype:generate -DarchetypeCatalog=remote
We will use the easier version where we don’t have to specify long command lines that include the group and archetype Ids and versions.
You will be greeted with a long list of possible archetypes with a number next to them and a prompt at the bottom to enter the number of the archetype you want to use.
HintChoose archetype:
1: remote -> amorg.onap.ikpolicy.drools-applications:archetype:elm-spring-boot-blank-archetype (Blank multi projectcl-amsterdam (Archetype to generate a yaml based control loop for SpringONAP BootAmsterdam + Elmrelease)
2: remote -> am.ik.archetype:graalvm-blank-archetype (Blank project for GraalVMorg.onap.policy.drools-applications.controlloop.templates:archetype-cl-amsterdam (Archetype to generate a yaml based control loop for ONAP Amsterdam release)
3: remote -> am.ik.archetype:graalvm-springmvc-blank-archetype (Blank project for GraalVM + Spring MVCorg.onap.policy.drools-applications.controlloop.templates:archetype-cl-casablanca (Archetype to generate a yaml based control loop for ONAP Casablanca release)
...
...
29369: localremote -> org.onap.ccsdk.cds.components.cba:archetype-blueprint (CDS Micro-services Archetype CBA)
Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 1785:Your locally installed ones should be near the end of the list.:
Enter the number of the archetype-blueprint archetype you want to use and press enter.
Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 1785: 29369
You will then be asked to accept a number of default properties for the cba. If If you don't want to accept use any of the defaults then simply press "n" at the end and hit enter -otherwise press "Y' and hit enter.
[INFO] Using property: groupId = org.onap.ccsdk.cds.components.cba
[INFO] Using property: artifactId = test-cba
Define value for property 'version' 1.0-SNAPSHOT: :
[INFO] Using property: package = org.onap.ccsdk.cds.components.cba
[INFO] Using property: cdsPassword = ccsdkapps
[INFO] Using property: cdsUsername = ccsdkapps
Confirm properties configuration:
groupId: org.onap.ccsdk.cds.components.cba
artifactId: test-cba
version: 1.0-SNAPSHOT
package: org.onap.ccsdk.cds.components.cba
cdsPassword: ccsdkapps
cdsUsername: ccsdkapps
Y: : nSince for the sake of demonstration, I have entered "n" then I was given the prompt the to change these default values. I changed test-cba to test-cba2.
Define value for property 'groupId' org.onap.ccsdk.cds.components.cba: :
Define value for property 'artifactId' test-cba: : test-cba2
Define value for property 'version' 1.0-SNAPSHOT: :
Define value for property 'package' org.onap.ccsdk.cds.components.cba: :
Define value for property 'cdsPassword' ccsdkapps: :
Define value for property 'cdsUsername' ccsdkapps: :
Confirm properties configuration:
groupId: org.onap.ccsdk.cds.components.cba
artifactId: test-cba2
version: 1.0-SNAPSHOT
package: org.onap.ccsdk.cds.components.cba
cdsPassword: ccsdkapps
cdsUsername: ccsdkapps
Y: : y
[INFO] ----------------------------------------------------------------------------
[INFO] Using following parameters for creating project from Archetype: archetype-blueprint:1.0.0-SNAPSHOT
[INFO] ----------------------------------------------------------------------------
[INFO] Parameter: groupId, Value: org.onap.ccsdk.cds.components.cba
[INFO] Parameter: artifactId, Value: test-cba2
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] Parameter: package, Value: org.onap.ccsdk.cds.components.cba
[INFO] Parameter: packageInPathFormat, Value: org/onap/ccsdk/cds/components/cba
[INFO] Parameter: package, Value: org.onap.ccsdk.cds.components.cba
[INFO] Parameter: groupId, Value: org.onap.ccsdk.cds.components.cba
[INFO] Parameter: artifactId, Value: test-cba2
[INFO] Parameter: cdsUsername, Value: ccsdkapps
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] Parameter: cdsPassword, Value: ccsdkapps
[INFO] Project created from Archetype in dir: /Users/kuldipr/Documents/Temp/test-cba2
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 32.565 s
[INFO] Finished at: 2021-05-21T17:15:21-04:00
[INFO] ------------------------------------------------------------------------Once complete, if you look in the directory you will see a new directory called
test-cba2 or what ever name you picked for cba
. Move into this directoryyour-machine:Temp$ ls
test-cba2
your-machine:Temp$ cd test-cba2/
your-machine:test-cba2$ ls
Definitions Scripts TOSCA-Metadata Tests pom.xmlYou can now build this cba.
your-machine:test-cba2$ mvn clean install
[INFO] Scanning for projects...
Downloading from onap-staging: https://nexus.onap.org/content/groups/staging/org/onap/ccsdk/parent/dependencies-bom/2.1.0-SNAPSHOT/maven-metadata.xml
...
...[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 24.851 s
[INFO] Finished at: 2021-05-21T17:30:17-04:00
[INFO] ------------------------------------------------------------------------You can now deploy it.
your-machine:test-cba2$ mvn install -Pdeploy-cba
[INFO] Scanning for projects...
Downloading from onap-public: https://nexus.onap.org/content/groups/public/org/onap/ccsdk/parent/dependencies-bom/2.1.0-SNAPSHOT/maven-metadata.xml...
...[INFO] Created enriched cba: test-cba2-1.1.0-SNAPSHOT-enriched-cba.zip
[INFO] CBA Deployed
[INFO] {"blueprintModel":{"id":"d99744e8-969b-452e-a4f2-e822a6087907","artifactUUId":null,"artifactType":"SDNC_MODEL","artifactVersion":"1.0.0",
"artifactDescription":"Controller Blueprint for RT-test-kotlin:1.0.0","internalVersion":null,"createdDate":"2021-05-21T21:32:44.000Z",
"artifactName":"RT-test-kotlin","published":"Y","updatedBy":"Selffish","tags":"test, regression"}}
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 24.639 s
[INFO] Finished at: 2021-05-21T17:32:45-04:00
[INFO] ------------------------------------------------------------------------
...