Sample Exchange

 View Only

vRealize Automation 8.7 Extensibility Migration Guide Samples 

Mar 28, 2022 04:33 PM

These are the vRealize Orchestrator sample workflows that are used to illustrate the vRealize Automation Extensibility Migration Guide. 
These samples leverage the vRealize Automation plug-in REST client and the invententory and scripting objects.
This content was developped by different VMware contributors from engineering, PSO, PVE.

The goal is to provide code samples for educational purposes. Use at your own risk. VMware should not be held liable in case the use of this code result in data loss.

Requirements
    vRealize Automation >= 8.5.0 with vRealize Automation plug-in for vRealize Orchestrator 8.7 OR vRealize Automation 8.7 that has the same plug-in installed OOTB (The plug-in targets vRA 8.5 APIs)
    Account with credentials for vRA & vRO
    Installation
    Download and import the package
    Run the setup workflow "Set vRA Host" from Orchestrator designer
    Provide a username and a password for a user assigned with roles in Orchestrator, Assembly, Service Broker. Some workflows like the onboarding one expect admin roles and org owner
 

The workflow should fail in case you do not provide proper host name or credentials.

To test the functionality you can run the "Invoke VRA 8 REST Operation from swagger and display result" workflow. It should auto populate the vRA host and credentials and by submitting the default values the workflow should complete successful and display the project objects in the logs tab.

Content

    "Set vRA Host" : Setup workflow to create vRA REST host & default credentials
    REST Operations
        "Invoke VRA 8 REST Operation from swagger" : Allows to run REST operations on vRA host with listing the URL / operations for each vRA service
        "Invoke VRA 8 REST Operation from URL" : Free form of the previous workflow
    Event Broker
        "Event Broker Template" : Event Broker demonstrator workflow including:
            - Display the content of the payload
            - Display the content of metadatas
            - Call back vRA to get the properties of the objects provided as IDs in the payload (endpoint, organization, project, zone, ,event topic, events, deployment, resources, blueprint, catalog - Items, resource actions, network parameters, host placement...)
            - Provide example on converting payload IDs to vRO object to bind Operation workflow on the object (Convert to VC:VirtualMachine and output it)
            - Display the parameters that supports being changed via workflow outputs
            - Update custom properties
            - Update tags
            - Update VM names
            - Update Host Selection
            - Update Zone placement
            - Place holders to update network parameters
        "Create an event broker subscription" : To reuse in other workflows to create subscriptions programattically. Used by next workflow
        "Create sample  "Event Broker Template" subscriptions" : Create a subscription for each event type starting the event broker workflow
    Tag & Custom properties
        "Edit project tags"
        "Edit project custom properties"
        "Edit machine custom properties"
        "Get Network by tags"
    Deployment day 2 operations
        "Change deployment lease"
        "Change Machine boot disk size"
        "Change Machine CPU & Memory"
        "Edit deployment tags"
        "vSphere Machine operation template" 
            - Extract payload and get objects from ID
            - Tag deployment resource asynchronously to avoid conflicting with this day 2 workflow (tag will be set on the vRA machine)
            - Set vRA machine custom property
            - Get matching VC:VirtualMachine
        
    Organization onboarding
        "Create Cloud Account"
        "Create Zone"
        "Create Project"
        "Onboarding project"
        "Onboarding Organization including all the previous workflows"
    Request
        "Request Catalog Item (Service Broker Only)" : Request programmatically a acatalog item. This version is designed to be run from Service Broker and is incompatible with vRO ATM
    Approvals
        "Approve deployment" Approves or rejects a request pending for approval
    Types Conversions
        "Get vRA Machine from vCenter VM" : Get vRA machine using query service to avoid getting all vRA machines and iterating through them
    Dynamic Types
        Website sample : Example of a simple Dynamic Types scenario

    Workflows under "Inventory objects" folder leveraging inventory objects and plug-in workflows
        "Edit project custom properties"
        "Event Broker Template"
        "Organization Onboarding"
        "Project Onboarding"
        "Get networks ids by tags"

New in this version:

    Request catalog item and wait : Wait all children items to be deployed before completing

    Edit machine tags

    Wait request tracker is completed : Workflow monitoring the new requestTracker object. The following workflows are examples of using this workflow with machine operations 
        Delete Machine and wait
        Shut Down Machine and wait
        Reset Machine and wait
        Reboot Machine and wait
        Power On Machine and wait
        Power Off Machine and wait
        Create network and wait

    Check vRA version : Examples of using Polyglot based actions leveraging different scripting languages
        checkvRAVersionPython
        checkvRAVersionNode
        checkvRAVersionPowerShell


Updated in this version: 
    Invoke VRA 8 REST Operation from swagger and display result : updated IaaS API URL, added vRO Gateway API


#Apache2.0
#vRealizeOrchestrator
#vROPackage
#vRO
#plugin
#extensibility
#Sample

Statistics
0 Favorited
5 Views
1 Files
0 Shares
1 Downloads
Attachment(s)
package file
com.vmware.vra87.plug-in.rest.extensibility.samples.package   521 KB   1 version
Uploaded - Apr 09, 2024

Tags and Keywords

Related Entries and Links

No Related Resource entered.