Skip to main content

HyperCloud™ Plugins

Permanently deleted user
  • Updated

Overview

 

Note
Among various Blueprint types, only VMs support Plugins.

The HyperCloud™ Platform (HCP) lets you create and execute scripts on Virtual Machines (VMs.) These scripts are called Plugins on the HCP portal. The HCP portal supports these interpreters:

  • Bash

  • Python

  • Perl

  • Ruby

  • PowerShell

  • Puppet

To run a Plugin on a VM, you’ll need to install the HCP agent. You can install the HCP agent on the VM using a Blueprint or the Free-from wizard.

Refer to these sections to:

  • Create your Plugin
  • Run your plugin on-demand
  • Add Plugin to a Blueprint using parameters
  • Add Plugin to a blueprint without using parameters

Create your Plugin

Plugins are Docker containers that perform pre-defined tasks. These tasks are executed as steps in your HCP pipeline. You can use Plugins to deploy code, publish artifacts, send notifications, etcetera.
Follow these steps to create a Plugin:

  1. Log in to your HCP portal account.

  2. Click Service Orchestration and navigate to Appstore > Plugins > Click New > Select the Plugin Type from the drop-down list.

  3. Enter these details in your Script Plugin dialog:

    1. Provide a Name for your Plugin.

    2. Click +Advance Configuration and enter these details:

      1. Enter a plugin Version.

      2. Enter a brief description of your new Script Plugin.

      3. Select the License from the drop-down list.

      4. Enter the Timeout for your Plugin in seconds.

      5. Enter the following in the Scripts text-box:
        #!/bin/bash
        [1] Use the script below to update your packages:

         
        1echo "Updating OS packages" 2sudo apt-get update && sudo apt-get upgrade -y || yum update -y 3echo "Ping Test to Google DNS Server" 4ping $IP_ADDRESS -c 8|

      6. If you want to add conditions for your Script Plugin run:

        1. Click Arguments+

        2. Enter the argument Key and its Value.
          Example:
          Key: IP_ADDRESS Value: 8.8.8.8

    3. To entitle users to your Plugin, select: 

      • Only Me: if you do not want anyone to access your Plugin.

      • Everyone: if you want to share your Plugin with everyone.

      • Groups & Users: if you want to share the Plugin with specific users or groups.

        1. Enter the first three alphabets of the username in the Users drop-down and select the username.

        2. Type the first three alphabets of the Group Name in the Groups drop-down and select the group name.

  4. Click Save Changes.

  5. Once you create your Plugin, the HCP portal will create a unique REFERENCE ID for the same.
    Example: Q5G9A

 

Note

  • [1] The HCP portal will replace all occurrences of:

    • $IP_ADDRESS in the Plugin with the value 8.8.8.8

  • The HCP portal will ignore all occurrences of:

    • ${IP_ADDRESS} in the Plugin

Run your plugin on-demand

Follow these steps to run your plugins on-demand on an existing VM without having to connect to the VM: [1]

  1. Log in to your HCP portal account.

  2. Click on Service Orchestration and navigate to Services > VM > Click open your VM > Click Plugins.

c8308d4f-d398-401e-8fd2-c39d850b3ddd.png

3. From the Add Plugins drop-down, select your Plugin. [2]

    1. To add more plugins, click Add Plugins and select your Plugin from the drop-down list.

    2. You can provide conditional arguments for each Plugin under +Advance Configuration. Enter the following details under +Advance Configuration:

      1. Valid Exit Codes: when you state a valid exit code, the HCP portal will ignore these codes. If you do not provide an exit code, the HCP portal will substitute it with the default value, which is 0.

      2. Order: this lets you define the sequence for the Order of executing the Plugin. [3]

4. Click Run Plugin.

5. Click Timeline Tab and wait for a few minutes to see the status of your run.

Note

  • [1] You’ll need to install the HyperCloud™ Agent on the VM before running a plugin.

    • The Agent Status must be Connected.

  • [2] If your Plugin has conditional arguments, you can view the same under +Advanced Configuration.

  • [3] If you do not provide the Order for executing a plugin, all plugins added to the VM will run simultaneously.

Add Plugin to a Blueprint using parameters

You can use parameters in blueprints to pass or override the default plugin values. You can add a plugin to different blueprints and customize your deployments using parameters. Follow these steps to add parameters to your Plugin for an existing blueprint:

  1. Log in to the HCP portal account.

  2. Click Service Orchestration and navigate to AppStore > Plugins > Copy the REFERENCE ID of your Plugin.

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

  4. Enter the following details in your Machine Compose Blueprint dialog:

    1. Enter a Name for the new Machine Compose Blueprint.

    2. Enter the brief description of your Machine Compose Blueprint.

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

    4. Enter the plugin snippet in the YAML text-box as shown below:

20e90f37-e790-4745-9904-ed1f29f9d0b0.png

  1. Select the Resource Pool from the drop-down list

  2. Click Customizable Params + and enter the following details: 

    • Enter the internal reference to the Plugin.
      Example: Machine.plugins.Q5G9A.arguments.IP_ADDRESS 
      The HCP portal will use this reference to run the Plugin on your VM using the YAML blueprint parameter values.

    • Enter the Host in the Key text-box. The Key is visible to your HCP user.

    • Enter the Value for your Key. If you do not enter a value for your Key, the HCP portal will default the value to 8.8.8.8.

    • Select the Mandatory check-box to make it compulsory for your HCP users to provide a Key-Value before creating a VM. [2]

    • Select the Password check-box to ensure that your sensitive data is masked during input and execution.

e77cda5d-f4df-4624-b797-1de54d7fd6ba.png

  •   Click Save Changes

3. To use these parameters in your blueprint:

    • Click open your blueprint.

    • Click Request Params.

    • Enter the Host value that you provided in Step-f above.

 

Notes

  • If your parameters are marked mandatory, you’ll need to enter a Key-value before you can create a VM.

  • If you haven’t made your parameters mandatory, the HCP portal will:

    1. Create a VM and,

    2. Execute the Plugin using the default value 8.8.8.8

[1] Sample YAML

 
1Machine:
2region: westus
3group: hg-poc
4image: Canonical:UbuntuServer:16.04-LTS
5instanceType: Standard_D13_v2
6resourceGroup: hg-dojo-rg
7network: hg-dojo-vnet1
8subnet: hg-dojo-vnet1-subnet1
9securityGroup: hg-dojo-nsg
10skipAgentInstall: false
11assignFloatingIP: true
12publicIPSku: basic
13password: "{{credentials | 2c9180876f0dbccb016f4f9d87a66886 }}"
14count: 1
15terminationProtection: DISABLED
16  plugins:
17  -!plugin
18  # Install Packages
19  id: Q5G9A
20  order: 1
21  -!plugin
22  # Download & Install Security Agent
23  id: P5H7K
24  order: 2

Add Plugin to a blueprint without using parameters

You can add a plugin to a blueprint by appending the plugin YAML values to the blueprint YAML. To add a plugin to an existing MACHINE_COMPOSE Blueprint YAML:

  1. Log in to your HCP portal account.

  2. Click Service Orchestration and navigate to AppStore > Plugins > Copy your plugin REFERENCE ID.

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

  4. Enter the following details in the Machine Compose Blueprint dialog:

    1. Enter a Name for your new Machine Compose Blueprint.

    2. Enter a brief Description of your Machine Compose Blueprint.

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

    4. Enter the plugin snippet in the YAML text-box. [1]

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

    6. Select the Cost Profile.

    7. To entitle users to your blueprint, select: 

      • Only Me: if you do not want anyone to access your blueprint.

      • Everyone: if you want to share your blueprint with everyone.

      • Groups & Users: if you want to share the blueprint with specific users or groups.

        1. Enter the first three alphabets of the username in the Users drop-down and select the username.

        2. Type the first three alphabets of the Group Name in the Groups drop-down and select the group name.

        3. If you are a Cloud Administrator, you can select All Tenants to share your template with all the HCP tenants.

    8. Click Save Changes.

  5. Once you’ve configured your plugin parameters, you can create your VM. Follow these steps to create your VM:

    1. Click open your blueprint.

    2. Click Create Machine.

  6. Once your VM is provisioned:

    1. The HyperCloudTM Agent will be automatically installed and,

    2. All the plugins in the blueprint are executed in the Order defined in the Blueprint YAML.

[1] Sample YAML

 
1Machine:
2region: westus
3group: hg-poc
4image: Canonical:UbuntuServer:16.04-LTS
5instanceType: Standard_D13_v2
6resourceGroup: hg-dojo-rg
7network: hg-dojo-vnet1
8subnet: hg-dojo-vnet1-subnet1
9securityGroup: hg-dojo-nsg
10skipAgentInstall: false
11assignFloatingIP: true
12publicIPSku: basic
13password: "{{credentials | 2c9180876f0dbccb016f4f9d87a66886 }}"
14count: 1
15terminationProtection: DISABLED
16
17  plugins:
18  -!plugin
19  # Install Packages
20  id: Q5G9A
21  order: 1
22  -!plugin
23  # Download & Install Security Agent
24  id: P5H7K
25  order: 2

Comments

0 comments

Please sign in to leave a comment.