...

Add Plugins to an existing Blueprint

...

Parameters can be used in blueprints to pass or override the default values in a plugin. This allows sharing the same plugin with different blueprints and allows users to customize their deployments as per their choice of parameters.

Configure Your Blueprints to Customize Parameters

...

To configure Blueprints to customize parameters used by the plugins:

1. Login to the HyperCloud™ Platform with your credentials.

2. Click on Services Orchestration >Select AppStore:

   1. Click on Plugins > Locate the plugin and copy the REFERENCE ID for e.g. Q5G9A

3. Click on AppStore > Click on New > Select the Machine Compose Blueprint from the drop-down list

4. Enter the following details in your Machine Compose Blueprint

   1. Enter the name for new Machine compose blueprint.

   2. Enter the brief description to your machine compose blueprint.

   3. Select the blueprint type from the drop-down list.

   4. Add the plugins in the YAML Text box as shown below:

   5. Select the Resource pool from the drop-down list

5. Click on Services Orchestration  > Select AppStore > Click on the Blueprints > Click on Edit.

6. Refer the YAML Syntax below beginning with plugins:
   Machine:
   region: westus
   group: hg-poc
   image: Canonical:UbuntuServer:16.04-LTS
   instanceType: Standard_D13_v2
   resourceGroup: hg-dojo-rg
   network: hg-dojo-vnet1
   subnet: hg-dojo-vnet1-subnet1
   securityGroup: hg-dojo-nsg
   skipAgentInstall: false
   assignFloatingIP: true
   publicIPSku: basic
   password: "{{credentials

   2c9180876f0dbccb016f4f9d87a66886 }}"
   count: 1
   terminationProtection: DISABLED
   plugins:

   1. Install Packages

   • !plugin
     id: Q5G9A
     order: 1

   • !plugin

   1. Download & Install Security Agent
      id: P5H7K
      order: 2|

7. Copy the plugin ID from the Blueprint below for e.g. Q5G9A

8. Click on the Customizable Params + located under the YAML section or the resource pool as shown below:

   Image Added

    

9. The internal reference to the plugin i.e. Machine.plugins.Q5G9A. arguments.IP_ADDRESS will be used to run the plugin on the VM with the value from the blueprint parameters.

10. The external value key Host will visible to the end-user when provisioning the blueprint:

    1. Mandatory Checkbox: User is forced to enter a value before creating a VM

    2. Password Checkbox: Ensure that sensitive data like password field is masked during input and execution.

    3. Value Text Box : 8.8.8.8 will be a default value if parameter is left unmodified i.e. If the mandatory checkbox is not selected and user creates a VM, then the plugin will get executed with the default value of 8.8.8.8

11. Click Save Changes

12. Click on the Blueprint Click on Request Params

...

This completes the steps to provision a VM using blueprints and use plugins to run automation once the VM is deployed successfully.