Skip to content

Commit

Permalink
(release) v2.38.0
Browse files Browse the repository at this point in the history
  • Loading branch information
WWCoE CI admin committed Mar 29, 2024
1 parent 559e984 commit 4c31a4c
Show file tree
Hide file tree
Showing 141 changed files with 2,939 additions and 138 deletions.
4 changes: 3 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## v2.38.0 - 29 Mar 2024

### Enhancements
* [vrotsc] `vrotsc` refactoring. Updated documentation and reworks. Check [this](https://github.com/vmware/build-tools-for-vmware-aria/pull/233) for detailed information
* [artifact-manager] IAC-796 / Upgrade VCD archetype to support Angular 15
Expand Down Expand Up @@ -1155,4 +1157,4 @@ with different domain.
* Cloud Client could not import bundles.

## v1.0.0 - 02 Mar 2018
* Initial version.
* Initial version.
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'abx-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'o11n-actions-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'bsc-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'cs-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'o11n-polyglot-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'ssh-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:ssh-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:ssh-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:ssh-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:ssh-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'o11n-typescript-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'vcd-ng-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'vra-ng-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'vra-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vra-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vra-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'vrealize-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'vrli-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'vrops-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[ERROR]
[ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
[ERROR] artifactId: 'o11n-xml-package-maven-plugin'
[ERROR] version: '2.36.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:2.36.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:jar:2.36.1-SNAPSHOT
[ERROR] version: '2.37.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:2.37.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:jar:2.37.1-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
79 changes: 4 additions & 75 deletions docs/versions/latest/Release.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,13 @@
[//]: # (You can utilize internal links /e.g. link to the upgrade procedure, link to the improvement|deprecation that introduced this/)



## Deprecations
[//]: # (### *Deprecation*)
[//]: # (Explain what is deprecated and suggest alternatives)



[//]: # (Features -> New Functionality)
## Features
[//]: # (### *Feature Name*)
Expand All @@ -23,6 +25,7 @@
[//]: # (#### Relevant Documentation:)



[//]: # (Improvements -> Bugfixes/hotfixes or general improvements)
## Improvements
[//]: # (### *Improvement Name* )
Expand All @@ -36,83 +39,9 @@
[//]: # (Optional But higlhy recommended Specify *NONE* if missing)
[//]: # (#### Relevant Documentation:)

### Fix on legacy archetype failing with vro:pull (when workflow folder path name contains special characters(&))

#### Previous Behaviour

When executing a vro:pull command on a legacy archetype, the command will fail without proper error if the workflow paths contains special characters such as '&'.

#### Current Behaviour

When executing a vro:pull command on a legacy archetype, if the workflows paths contains special character(&), the command will fail but will provide descriptive error message.

### Fix SSH Session methods type

#### Previous Behavior

When using SSH with typescript, the `error` and `state` methods has the type `void`. But technically, it returns a string. VSCode highlight it as an error and the complication failed. The same method is working in JS (obviously). Example from the built-in Workflow. Variable `error` and `state` has type `String`.

#### Current Behavior

Method `error` and `state` should return type `String` instead of type `void`


### Upgrade VCD archetype to support Angular 15
VMware Cloud Director v10.6 is going to drop support for Angular v9 or less.

#### Previous Behaviour
VMware Cloud Director archetype is using:
* node v12
* angular v8
* clarity v2
* rxjs v6
* webpack v4

The old archetype can still be bootstrapped with:
`mvn archetype:generate \
-DinteractiveMode=false \
-DarchetypeGroupId=com.vmware.pscoe.vcd.archetypes \
-DarchetypeArtifactId=package-vcd-ng-angular8-archetype \
-DgroupId=org.example \
-DartifactId=sample \
-DlicenseUrl= \
-DlicenseHeader= \
-DlicenseTechnicalPreview=false`

#### Current Behaviour
VMware Cloud Director archetype is using:
* node v16+
* angular v15
* clarity v15
* rxjs v7
* webpack v5

The new archetype can be bootstrapped with:
`mvn archetype:generate \
-DinteractiveMode=false \
-DarchetypeGroupId=com.vmware.pscoe.vcd.archetypes \
-DarchetypeArtifactId=package-vcd-ng-archetype \
-DgroupId=org.example \
-DartifactId=sample \
-DlicenseUrl= \
-DlicenseHeader= \
-DlicenseTechnicalPreview=false`


#### Related issue
<https://github.com/vmware/build-tools-for-vmware-aria/issues/180>

### Fix SSH Session additional methods type

#### Previous Behavior

When using SSH with typescript, the `cmd`, `pty`, `terminal` methods has the type `void`. But technically, it returns a string. VSCode highlight it as an error and the complication failed. The same method is working in JS (obviously). Example from the built-in Workflow. Variable `cmd`, `pty`, `terminal` has type `String`.

#### Current Behavior

Method `cmd`, `pty`, `terminal` should return type `String` instead of type `void`

## Upgrade procedure
## Upgrade procedure:
[//]: # (Explain in details if something needs to be done)

[//]: # (## Changelog:)
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# 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-vrealize--clean)
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 | No | Aria Automation does not support packaging |
| vrli | No | vRLI does not provide native package support |
| cs | No | Code Stream Services does not provide native support for packages |

### Usage

`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

Original file line number Diff line number Diff line change
@@ -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
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# 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.
- If the `platform.protocolType` is set to one of possible values `'Ssl3' | 'Tls' | 'Tls11' | 'Tls12' | 'Tls13'` all external modules(Added through Import-Module in the code) will be downloaded using the selected encryption protcol, otherwise the system default is used.

### 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

Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
[//]: # (Finish with some troubleshooting tips, when any error are encountered and fixed for future issues)
Original file line number Diff line number Diff line change
@@ -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`
Loading

0 comments on commit 4c31a4c

Please sign in to comment.