(release) v4.0.0

Author: svc-wwcoe-ci-admin

docs/versions/latest/General/Cheatsheets/abx-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: abx-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: abx-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: abx
 
 This plugin has 3 goals:

docs/versions/latest/General/Cheatsheets/actions-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: o11n-actions-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-actions-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 6 goals:

docs/versions/latest/General/Cheatsheets/bsc-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: bsc-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: bsc-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: bsc
 
 This plugin has 1 goal:

docs/versions/latest/General/Cheatsheets/cs-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: cs-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: cs-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: cs
 
 This plugin has 2 goals:

docs/versions/latest/General/Cheatsheets/polyglot-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: o11n-polyglot-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-polyglot-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 3 goals:

docs/versions/latest/General/Cheatsheets/ssh-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:ssh-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:ssh-maven-plugin:3.2.1-SNAPSHOT
 
 Name: ssh-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: ssh-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: ssh
 
 This plugin has 2 goals:

docs/versions/latest/General/Cheatsheets/typescript-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: o11n-typescript-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-typescript-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 5 goals:

docs/versions/latest/General/Cheatsheets/vcd-ng-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: vcd-ng-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vcd-ng-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vcd-ng
 
 This plugin has 2 goals:

docs/versions/latest/General/Cheatsheets/vra-ng-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: vra-ng-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vra-ng-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vra-ng
 
 This plugin has 2 goals:

docs/versions/latest/General/Cheatsheets/vrealize-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: vrealize-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vrealize-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vrealize
 
 This plugin has 4 goals:

docs/versions/latest/General/Cheatsheets/vrli-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: vrli-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vrli-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vrli
 
 This plugin has 2 goals:

docs/versions/latest/General/Cheatsheets/vrops-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: vrops-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vrops-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vrops
 
 This plugin has 3 goals:

docs/versions/latest/General/Cheatsheets/xml-plugin-arguments.md

@@ -1,4 +1,4 @@
-com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:3.1.2-SNAPSHOT
+com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:3.2.1-SNAPSHOT
 
 Name: o11n-xml-package-maven-plugin
 Description: Build Tools for VMware Aria provides development and release
@@ -8,7 +8,7 @@ Description: Build Tools for VMware Aria provides development and release
   DevOps practices for managing and deploying content.
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-xml-package-maven-plugin
-Version: 3.1.2-SNAPSHOT
+Version: 3.2.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 5 goals:

docs/versions/latest/Release.md

@@ -9,32 +9,13 @@
 [//]: # (### *Breaking Change*)
 [//]: # (Describe the breaking change AND explain how to resolve it)
 [//]: # (You can utilize internal links /e.g. link to the upgrade procedure, link to the improvement|deprecation that introduced this/)
-### *Upgrade to node.js 22 (22.13.1)*
-BTVA is compiled for node.js 22 and may use features not available in older node.js versions. Make sure proper version of node.js is used for project build.
-Projects that use older versions of @types/node should upgrade to the later versions compatible with node.js 22. Changes in code using obsolete functions may be required.
-
-### *Upgrade to latest typescipt and ts-node*
-The latest versions of typescipt have stricter code validation and may report errors where they were previously ignored.
-Examples: not passing all mandatory function parameters, use of 'this' in workflow definitions (*.wf.ts).
-
-### *Aria (vra-ng) policies are now handled differently.*
-
-Previously, when pulling and pushing policies, duplicates were allowed, however this didn't allow us to map them correctly. So that being the case, now policies with the same name and of the same type on the environment will break the execution of the code.
 
 ## Deprecations
 
 [//]: # (### *Deprecation*)
 [//]: # (Explain what is deprecated and suggest alternatives)
 
 [//]: # (Features -> New Functionality)
-### *Angular 8 not supported for VCD projects*
-The VCD projects based on Angular 8 templates are not supported anymore. Projects must be upgraded to Angular 15 templates.
-
-### *Remove powershell runtime option*
-The following option have been removed:
-```text
-- `powershell:7.4`
-```
 
 ## Features
 
@@ -58,37 +39,6 @@ The following option have been removed:
 [//]: # (Optional But higlhy recommended Specify *NONE* if missing)
 [//]: # (#### Relevant Documentation:)
 
-### *Fix documentation typo*
-
-It is now possible to configure how the unit tests are being bootstrapped and executed.
-
-#### Previous Behavior
-
-Missing a close curly brace in the Workflow's User Interaction example.
-
-#### New Behavior
-
-The example now has a close curly brace.
-
-#### Relevant Documentation
-
-[Workflows.md](../../versions/latest/Components/Archetypes/typescript/Components/Workflows.md).
-
-### *Fix unit test execution in Windows reporting error*
-
-#### Previous Behavior
-
-When maven build executes unit tests, it reports "Error occurred in unit tests execution: null"
-
-#### New Behavior
-
-The correct output of unit tests result is shown
-
 ## Upgrade procedure
 
 [//]: # (Explain in details if something needs to be done)
-
-For older vCD projects which are not buildable with Node 22 you can:
-* Build them as a separate project
-* Use Node version manager to dynamically switch between Node versions during build phases of the different subprojects
-* Utilise Maven goals and plugins to dynamically switch to earlier Node version in the vCD project's pom.xml

docs/versions/v4.0.0/Components/Archetypes/General/Goals/Vrealize Clean.md

@@ -0,0 +1,36 @@
+# Vrealize Clean
+
+`vrealize:clean` is a goal used to clean up archetype packages on a given environment.
+
+## Overview
+
+`vrealize:clean` gives us a lot of flexibility in what is going to be deleted. You can find more about the different options in the sections below.
+
+## Table Of Contents
+
+1. [Archetype Support for vrealize:clean](#archetype-support-for-vrealizeclean)
+2. [Usage](#usage)
+
+### Archetype Support for vrealize:clean
+
+| Archetype | Supported | Comment                                                            |
+|-----------|-----------|--------------------------------------------------------------------|
+| vra       | Yes       | -                                                                  |
+| vro       | Yes       | -                                                                  |
+| vcd       | Partial   | It does not support dryRunning                                     |
+| abx       | No        | Not implemented                                                    |
+| vrops     | No        | Not implemented                                                    |
+| vra-ng    | Partial   | Does not support dryRunning and does not work for regional content |
+| vrli      | No        | vRLI does not provide native package support                       |
+| cs        | No        | Code Stream Services does not provide native support for packages  |
+
+### Usage
+
+```bash
+mvn vrealize:clean -DincludeDependencies=true -DcleanUpOldVersions=true -DcleanUpLastVersion=false -Ddryrun=true -P${PROFILE}
+```
+
+- includeDependencies - a flag depicting if dependencies should also be deleted
+- cleanUpOldVersions - a flag depicting if old versions of the package (and dependencies in case of includeDependencies) should be deleted
+- cleanUpLastVersion - a flag depicting if the latest version should also be deleted before importing
+- dryrun - Dryrun or not

docs/versions/v4.0.0/Components/Archetypes/Polyglot/General/New Project.md

@@ -0,0 +1,32 @@
+# New Project
+
+## Table Of Contents
+
+- [Generate A New Project](#generate-a-new-project)
+
+### Generate A New Project
+
+- Replace `archetypeVersion` with the latest toolchain version
+- Specify `type` to be either `abx` (vRA ABX Actions) or `vro` (vRO Polyglot Actions).
+
+```bash
+#vRO:  
+mvn archetype:generate \ 
+  -DinteractiveMode=false \
+  -DarchetypeGroupId=com.vmware.pscoe.polyglot.archetypes \
+  -DarchetypeArtifactId=package-polyglot-archetype \
+  -DarchetypeVersion={LATEST_VERSION} \ 
+  -DgroupId=com.vmware.pscoe \
+  -DartifactId=testvronew \
+  -Dtype=vro  
+
+#ABX:  
+mvn archetype:generate \
+  -DinteractiveMode=false \
+  -DarchetypeGroupId=com.vmware.pscoe.polyglot.archetypes \
+  -DarchetypeArtifactId=package-polyglot-archetype \
+  -DarchetypeVersion={LATEST_VERSION} \
+  -DgroupId=com.vmware.pscoe \
+  -DartifactId=testabxnew \
+  -Dtype=abx
+```