Skip to content

Commit

Permalink
(release) v2.36.0
Browse files Browse the repository at this point in the history
  • Loading branch information
WWCoE CI admin committed Nov 16, 2023
1 parent 8f32223 commit f721600
Show file tree
Hide file tree
Showing 139 changed files with 2,699 additions and 129 deletions.
4 changes: 3 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
## v2.36.0 - 16 Nov 2023

### Fixes
* [artifact-manager] IAC-788 / Fix vRA Custom Forms not enabled with vRA Version prior 8.12.x.
* [artifact-manager] IAC-788 / Improved Handling of Empty vRA Blueprint Versions for vRA 8.12.x.
Expand Down Expand Up @@ -1123,4 +1125,4 @@
* 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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:ssh-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:ssh-maven-plugin:2.35.2-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:ssh-maven-plugin:jar:2.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:2.35.2-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.35.2-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.35.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:2.35.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.35.1-SNAPSHOT
[ERROR] version: '2.35.2-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:2.35.2-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.35.2-SNAPSHOT
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
Expand Down
71 changes: 5 additions & 66 deletions docs/versions/latest/Release.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,49 +10,21 @@
[//]: # (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)

### Deprecating SQLDatabaseManager.getDatabase() function

SQLDatabaseManager.getDatabase() function is removed in vRA 7.6 / Aria Automation 8 and above. The function uses name as parameter to retrieve a database. Use getDatabaseById() or getDatabases() and filter by name instead.

[//]: # (Features -> New Functionality)
## Features
[//]: # (### *Feature Name*)
[//]: # (Describe the feature)
[//]: # (Optional But higlhy recommended Specify *NONE* if missing)
[//]: # (#### Relevant Documentation)

### Setting Default Policy for vROPs 8.12.x

Added option for setting default policy for vROPs version 8.12.x by setting it in the default-policy configuration item in the content.yaml file.

#### Relevant Documentation
If in the content.yaml file for a vROPs project the following section is present:

```yaml
default-policy: Policy Name
```
[//]: # (#### Relevant Documentation:)

Then the 'Policy Name' will be set to the default policy in vROPs.

### Adding Aria Automation 8.x vRO Plugin Types
Developers can use on their TS projects the vRAHost type properties and functions
#### Relevant Documentation
NONE
#### Example
`example.ts`:
```typescript
export default function (vraHost:VraHost):VraGenericRestClient {
return vraHost.createRestClient();
}
```

[//]: # (Improvements -> Bugfixes/hotfixes or general improvements)
## Improvements
Expand All @@ -65,45 +37,12 @@ export default function (vraHost:VraHost):VraGenericRestClient {
[//]: # (#### New Behavior)
[//]: # (Explain how it behaves now, regarding to the change)
[//]: # (Optional But higlhy recommended Specify *NONE* if missing)
[//]: # (#### Relevant Documentation)

### vRA Custom Form not Enabled with vRA Version 8.11.2

#### Previous Behaviour
When pushing vRA custom forms to vRA version 8.11.2 they are not get enabled by default, thus not visible in the blueprint section.

#### Current Behaviour
When pushing vRA custom forms to vRA version 8.11.2 they are get enabled by default and visible in the blueprint section.

### Improved Handling of Empty vRA Blueprint Versions for vRA 8.12.x

#### Previous Behaviour
If the vRA returns an empty versions array when fetching of latest vRA blueprint version would throw a null pointer exception.

#### Current Behaviour
If the vRA returns an empty versions array when fetching of latest vRA blueprint version it would not throw null pointer exception and add an empty string in the blueprint version string.

### Update Deprecated Policy APIs for vROPs 8.12.x

#### Previous Behaviour
When pushing vROPs policies to vROPs 8.12.0 and above the deprecated internal policy API in vROPs is used.

#### Current Behaviour
When pushing vROPs policies to vROPs 8.12.0 and above the new public policy API in vROPs is used. The older versions of vROPs is also supported.

### Fix SSH Session exitCode type

#### Previous Behaviour
When using SSH with typescript, the `exitCode` method has the type `void`. But technically, it returns an integer. 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 `exitCode` has type `Number`.
[//]: # (#### Relevant Documentation:)

#### Current Behaviour
Method `.exitCode` should return type `Number` instead of type `void`

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

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

[//]: # (## Changelog)
[//]: # (## Changelog:)
[//]: # (Pull request links)
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)
Loading

0 comments on commit f721600

Please sign in to comment.