Page Comparison

...

1. Log in to your HCP portal account.

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

   Image RemovedImage Added

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.

...

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: ^[1]
      

      Image RemovedImage Added

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

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

      1. 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.

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

      3. Enterthe 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.

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

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

         

   7. Click Save Changes

5. To use these parameters in your blueprint:

   1. Click open your blueprint.

   2. Click Request Params.

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

...

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 HyperCloud^TM Agent will be automatically installed and,

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

Table number 1.1^[1] Sample YAML

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:
  -!plugin
  # Install Packages
  id: Q5G9A
  order: 1
  -!plugin
  # Download & Install Security Agent
  id: P5H7K
  order: 2

...