-
Notifications
You must be signed in to change notification settings - Fork 22
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
WWCoE CI admin
committed
Sep 29, 2023
1 parent
1696d58
commit 7497b7a
Showing
138 changed files
with
2,693 additions
and
95 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/abx-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/actions-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/bsc-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/cs-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/polyglot-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/ssh-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/typescript-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/vcd-ng-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/vra-ng-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/vra-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/vrealize-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/vrli-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/vrops-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 changes: 1 addition & 1 deletion
2
docs/versions/latest/General/Cheatsheets/xml-plugin-arguments.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,47 +1,48 @@ | ||
| ## Breaking Changes | ||
|
|
||
|
|
||
| ## Deprecations | ||
|
|
||
|
|
||
| ## Features | ||
|
|
||
| [//]: # (VERSION_PLACEHOLDER DO NOT DELETE) | ||
| [//]: # (Used when working on a new release. Placed together with the Version.md) | ||
| [//]: # (Nothing here is optional. If a step must not be performed, it must be said so) | ||
| [//]: # (Do not fill the version, it will be done automatically) | ||
| [//]: # (Quick Intro to what is the focus of this release) | ||
|
|
||
| ## Improvements | ||
|
|
||
| ### Fixed importing of vRA content items on vRA 8.13.x | ||
|
|
||
| #### Previous Behavior | ||
|
|
||
| When pushing vRA content items to vRA 8.13.x the pushing fails with the following error: | ||
| Cannot invoke "com.vmware.pscoe.iac.artifact.model.vrang.VraNgCatalogItemType.getId()" because "this.type" is null | ||
| When the content item naming case in the content.yaml file is different from the file names that are in the content-items directory | ||
| they are not pushed to the target environment (skipped). | ||
| ## Breaking Changes | ||
| [//]: # (### *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/) | ||
|
|
||
| #### New Behavior | ||
|
|
||
| When pushing the vRA content items to vRA 8.13.x it no longer fails. The content naming in the content.yaml is no longer case sensitive | ||
| againist the file names in the content-items directory, thus the content-items names in the content.yaml file are no longer case sensitive. | ||
|
|
||
| ### Fixed the compiled SAGA workflow crashes when no imports are defined in saga yaml | ||
| ## Deprecations | ||
| [//]: # (### *Deprecation*) | ||
| [//]: # (Explain what is deprecated and suggest alternatives) | ||
|
|
||
| #### Previous Behaviour | ||
|
|
||
| When no imports were defined in typescript SAGA workflow file format, the compiled vRO workflow failed when being executied in vRO on Initilize scriptable task | ||
| with null object error. | ||
|
|
||
| #### New Behaviour | ||
| [//]: # (Features -> New Functionality) | ||
| ## Features | ||
| [//]: # (### *Feature Name*) | ||
| [//]: # (Describe the feature) | ||
| [//]: # (Optional But higlhy recommended Specify *NONE* if missing) | ||
| [//]: # (#### Relevant Documentation:) | ||
|
|
||
| When no imports are defined in typescript SAGA workflow file format, the compiled vRO workflow runs successfully. | ||
|
|
||
| ### Fixed push to vCD failing if API version is >= 38.0 | ||
|
|
||
| #### Previous Behaviour | ||
| [//]: # (Improvements -> Bugfixes/hotfixes or general improvements) | ||
| ## Improvements | ||
| [//]: # (### *Improvement Name* ) | ||
| [//]: # (Talk ONLY regarding the improvement) | ||
| [//]: # (Optional But higlhy recommended) | ||
| [//]: # (#### Previous Behavior) | ||
| [//]: # (Explain how it used to behave, regarding to the change) | ||
| [//]: # (Optional But higlhy recommended) | ||
| [//]: # (#### New Behavior) | ||
| [//]: # (Explain how it behaves now, regarding to the change) | ||
| [//]: # (Optional But higlhy recommended Specify *NONE* if missing) | ||
| [//]: # (#### Relevant Documentation:) | ||
|
|
||
| When using vCD 10.5 there is a breaking change affecting the way authentication works and as a consequence the push to vCD is failing. | ||
|
|
||
| #### New Behaviour | ||
|
|
||
| This introduces a quick fix to the problem: if API version 38.0 or later is detected, simply use 37.0 which we know works as expected. | ||
| ## Upgrade procedure: | ||
| [//]: # (Explain in details if something needs to be done) | ||
|
|
||
| ## Upgrade procedure | ||
| [//]: # (## Changelog:) | ||
| [//]: # (Pull request links) |
34 changes: 34 additions & 0 deletions
34
docs/versions/v2.35.1/Components/Archetypes/General/Goals/Vrealize Clean.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 | ||
|
|
31 changes: 31 additions & 0 deletions
31
docs/versions/v2.35.1/Components/Archetypes/Polyglot/General/New Project.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 | ||
| ``` |
50 changes: 50 additions & 0 deletions
50
docs/versions/v2.35.1/Components/Archetypes/Polyglot/General/Project Structure.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 | ||
|
|
1 change: 1 addition & 0 deletions
1
docs/versions/v2.35.1/Components/Archetypes/Polyglot/General/Troubleshooting.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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) |
11 changes: 11 additions & 0 deletions
11
docs/versions/v2.35.1/Components/Archetypes/Polyglot/General/Usage.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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` |
Oops, something went wrong.