(release) v2.29.1

vmware · Feb 15, 2023 · dab5860 · dab5860
1 parent b9838da
commit dab5860
Show file tree

Hide file tree

Showing 226 changed files with 4,882 additions and 286 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,5 @@
+## v2.29.1 - 15 Feb 2023
+
 ### Fixes
 * [package-installer] IAC-713 / Installer doesn't ask for all required information about importing vRА
 * [polyglotpkg] IAC-712 / Enabled unit testing phase for npm lib projects, fix abx and polyglot pkg to be backward compatible
@@ -1016,4 +1018,4 @@
 * Cloud Client could not import bundles
 
 ## v1.0.0 - 02 Mar 2018
-* Initial version
+* Initial version
diff --git a/common/artifact-manager/pom.xml b/common/artifact-manager/pom.xml
@@ -4,7 +4,7 @@
 	<parent>
 		<artifactId>iac</artifactId>
 		<groupId>com.vmware.pscoe</groupId>
-		<version>2.29.1-SNAPSHOT</version>
+		<version>2.29.1</version>
 		<relativePath>../../pom.xml</relativePath>
 	</parent>
 

diff --git a/common/o11n/project/pom.xml b/common/o11n/project/pom.xml
@@ -4,7 +4,7 @@
 	<parent>
 		<artifactId>iac</artifactId>
 		<groupId>com.vmware.pscoe</groupId>
-		<version>2.29.1-SNAPSHOT</version>
+		<version>2.29.1</version>
 		<relativePath>../../../pom.xml</relativePath>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>

diff --git a/docs/versions/latest/General/Cheatsheets/abx-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/abx-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: abx-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: abx-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: abx
 
 This plugin has 3 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/actions-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/actions-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: o11n-actions-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-actions-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 6 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/bsc-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/bsc-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: bsc-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: bsc-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: bsc
 
 This plugin has 1 goal:

diff --git a/docs/versions/latest/General/Cheatsheets/cs-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/cs-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: cs-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: cs-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: cs
 
 This plugin has 2 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/polyglot-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/polyglot-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: o11n-polyglot-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-polyglot-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 3 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/ssh-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/ssh-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: ssh-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: ssh-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: ssh
 
 This plugin has 2 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/typescript-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/typescript-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: o11n-typescript-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-typescript-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 5 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/vcd-ng-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vcd-ng-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: vcd-ng-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vcd-ng-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vcd-ng
 
 This plugin has 2 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/vra-ng-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vra-ng-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: vra-ng-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vra-ng-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vra-ng
 
 This plugin has 2 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/vra-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vra-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: vra-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vra-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vra
 
 This plugin has 2 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/vrealize-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vrealize-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: vrealize-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vrealize-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vrealize
 
 This plugin has 4 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/vrli-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vrli-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: vrli-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vrli-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vrli
 
 This plugin has 2 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/vrops-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vrops-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: vrops-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: vrops-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vrops
 
 This plugin has 3 goals:

diff --git a/docs/versions/latest/General/Cheatsheets/xml-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/xml-plugin-arguments.md
@@ -2,7 +2,7 @@ Name: o11n-xml-package-maven-plugin
 Description: (no description available)
 Group Id: com.vmware.pscoe.maven.plugins
 Artifact Id: o11n-xml-package-maven-plugin
-Version: 2.28.1-SNAPSHOT
+Version: 2.29.1-SNAPSHOT
 Goal Prefix: vro
 
 This plugin has 5 goals:

diff --git a/docs/versions/latest/Release.md b/docs/versions/latest/Release.md
@@ -39,60 +39,6 @@
 [//]: # (Optional But higlhy recommended Specify *NONE* if missing)
 [//]: # (#### Relevant Documentation:)
 
-### Enabled Unit testing for npm lib based projects
-
-#### Previous Behavior
-
-npm test was not part of maven lifecycle for npm based projects
-
-#### New Behavior
-
-npm test is now triggered during maven package goal for npm based projects
-
-#### Relevant Documentation
-
-None
-
-### Fix polyglotpkg/abx backward compatibility
-
-#### Previous Behavior
-
-If you upgrade to latest Build Tools for VMware Aria version the previously created ABX and polyglot actions will stop working
-
-#### New Behavior
-
-With small adjustments, the old ABX and polyglot actions should be upgradable
-
-#### Relevant Documentation
-
-None
-
-### Fix polyglotpkg dependencies
-
-#### Previous Behavior
-
-If you build project with polyglot + typescript-project-all the build will fail with dependency resolution error
-
-#### New Behavior
-
-If you build project with polyglot + typescript-project-all the build will succeed
-
-#### Relevant Documentation
-
-None
-
-### Installer v 2.27.0 Doesn't Ask for All Required Information about importing vRА
-Installer script doesn't show a prompt to ask for additional information for importing vRA - project name and ID and Organization name and ID
-
-#### Previous Behavior
-There was condition which let only Code Stream to prompt for vRA questions
-
-#### New Behavior
-The prevous condition was modified to be able to ask questions according to presense of vRA project.
-Unnecessary suppression of questions regarding embedded vRO had been removed
-
-#### Relevant Documentation
-**NONE**
 
 
 ## Upgrade procedure:

diff --git a/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/New Project.md b/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/New Project.md
@@ -0,0 +1,31 @@
+# New Project
+
+## Table Of Contents:
+1. [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
+```
diff --git a/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/Project Structure.md b/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/Project Structure.md
@@ -0,0 +1,49 @@
+# Project Structure
+
+## Overview
+The polyglot archetype supports multiple actions in the src folder. Each has it's own structure depending on the type of the package.
+
+## Table Of Contents:
+1. [General](#general)
+2. [Templates](#templates)
+3. [NodeJS](#nodejs)
+4. [Python](#python)
+5. [Powershell](#powershell)
+
+### General
+- `polyglot.json` - marks a folder as a polyglot package. Contains information about the package.
+    - If the `platform.action` is set to `auto` the name of the folder will be used as the package name.
+
+### Templates
+There are three templates:
+* src/template-nodejs ([NodeJs](#nodejs))
+* src/template-powershell ([Powershell](#powershell))
+* src/template-python ([Python](#python))
+
+
+Note: you do not need to delete template folders. Any folder starting with `template-` is ignored.
+
+### NodeJS
+- `handler.ts` - holds all the logic for the action
+- `tsconfig.json` - used by typescript to compile the code during `mvn package`, since rootDirs and srcDirs are dynamic, there are
+  placeholders in this file. **do not modify**
+
+> Dependencies
+> 
+> NodeJS' dependencies are defined in the `package.json` file in the `dependencies` property. Specify only dependencies to 
+> your code, there are no mandatory dependencies as well as no default ones.
+
+### Python
+- `handler.py` - holds all the logic for the action
+- `requirements.txt` - holds dependency information e.g. requirements.txt:
+    ```python
+    requests==2.23.0
+    ```
+
+> Dependencies
+>
+> These follow the standard python `requirements.txt` structure. No default or mandatory dependencies. [More Info](https://learnpython.com/blog/python-requirements-file/)
+
+### Powershell
+- `handler.ps1` - holds all the logic for the action
+
diff --git a/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/Troubleshooting.md b/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/Troubleshooting.md
@@ -0,0 +1 @@
+[//]: # (Finish with some troubleshooting tips, when any error are encountered and fixed for future issues)
diff --git a/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/Usage.md b/docs/versions/v2.29.1/Components/Archetypes/Polyglot/General/Usage.md
@@ -0,0 +1,11 @@
+# Usage
+
+## Overview
+Polyglot archetype just like any other archetype utilizes the `vrealize:push` to package and deploy the artifacts.
+
+## Table Of Contents:
+1. [Command](#command)
+
+### Command
+
+`mvn clean package vrealize:push -Penvironment_profile`
diff --git a/docs/versions/v2.29.1/Components/Archetypes/Polyglot/README.md b/docs/versions/v2.29.1/Components/Archetypes/Polyglot/README.md
@@ -0,0 +1,13 @@
+# Polyglot
+The polyglot archetype is an archetype that allows you to push "polyglot" actions to vRO and vRA ( like powershell, python, nodejs )
+
+## Overview
+The polyglot archetype is used to push multiple of these actions at the same time in a single package.
+
+## Navigation:
+- Getting Started
+  - [Project Structure](./General/Project Structure.md)
+  - [New Project](./General/New Project.md)
+- [Usage](./General/Usage.md)
+- [Troubleshooting](./General/Troubleshooting.md)
+