Add VMware vCenter Cloud Provider Resource

This article explains how to configure a vCenter cloud provider resource. The VMware vCenter cloud provider is provided with CloudShell 7.0 (and above) and enables the deployment of virtual machines from vCenter templates, images, clones (existing vCenter VMs) and linked clones (snapshots of existing vCenter VMs). Each deployment type includes the required settings, attributes, and commands. For a video tutorial on how to set up the resource, watch the video at the bottom of the article.

Important: vCenter elements created by CloudShell should not be altered as this may cause unexpected behavior.

Notes:
  • The supported versions are vSphere 5.5 - 6.5, 6.7 (7 is supported in the vCenter 2nd Gen Shell).
  • We also have a 2nd Gen version of the vCenter shell that is based on Python 3.7 and provides support for vSphere 7, VM Customization Specifications, standard vSwitch connectivity, the option to display the VM's web console directly from vCenter, the capability to customize the VM's technical specs (storage size, memory, CPU) and view cluster usage stats directly from the sandbox. The VMware vCenter Cloud Provider Shell 2G shell can be downloaded here.

To add a vCenter cloud provider resource:

  1. Log in to the CloudShell domain in which this resource will reside. This will enable the Apps based on this cloud provider resource to be usable in this domain.
  2. In the Inventory dashboard, in the Resources tab, click the folder in which you want to create the resource.
  3. Click + Add New.
  4. In the Create New Resource dialog box, select the vCenter cloud provider template.
  5. Enter a Name for the vCenter resource.

    Note: The resource's name has a limit of 100 characters and can only contain alpha-numeric characters, spaces, and the following characters: | . - _ ] [

  6. Enter the IP Address of the vCenter server that will be used to deploy the virtual machines.
  7. Click Create.

    The Resource dialog box is displayed.

  8. Enter the required information. Unless specified differently, paths are relative to the datacenter so for example, to specify VM storage "datastore cluster" that is under datacenter "QualiSB", enter "datastore cluster" in the VM Storage field. For guidance on finding each element in your vCenter server, see vCenter cheetsheet for versions 5.5-6.5 or vCenter cheetsheet for version 6.7 and above.

    Note: All vCenter elements must be located under the same data center.

    Address IP address of the vCenter server
    User

    User on the vCenter server.

    The user must be assigned to the root level of the vCenter server with the necessary permissions. For details, see Required vCenter User Permissions per Deployment Type.

    Password vCenter user's password

    Password must not include a # character.

    Default Datacenter Datacenter within the vCenter that will be used for virtual machine deployment. All other settings of this vCenter resource should refer to entities associated with this datacenter.
    VM Storage vCenter storage in which the VMs will be created. The storage can be either a datastore or a datastore cluster. For example: datastore1

    Note: To use a specific datastore that resides inside a cluster, specify the cluster name and the datastore name. For example: clustername/storage1

    Holding Network Default network to be used for the VM’s vNICs when disconnecting them from another network. A distributed port group can also be specified.

    Specify a network under the specified dvSwitch. Do not include the dvSwitch name in the path.

    Note: Only VNICs in this holding network will be used when connecting Apps based on this cloud provider resource in the sandbox.

    VM Location

    Folder in the vSphere datacenter (defined in the VM Storage attribute) in which the VM will be created. Default is Qualisystems.

    From CloudShell version 9.0, two folders are created within this folder, as needed: Deployed Apps and Saved Sandboxes. The Deployed Apps folder holds the deployed VM Apps and, if you have saved a sandbox as part of the Save and Restore paid add-on, the Saved Sandboxes folder is created to hold the VM artifacts created when a user saves a sandbox.

    Default dvSwitch

    (Optional if connectivity is not required) Default vCenter dvSwitch to be used when configuring virtual machine connectivity

    Important: CloudShell needs to create port groups in the dvSwitch in order to use Apps. Therefore, make sure you have an appropriate VMWare license that provides this capability.

    VM Cluster

    vCenter cluster or host to use when deploying a virtual machine. To specify a host instead of a cluster, use: Cluster Name/Host IP.

    Notes:
    • If the cluster is in Under Maintenance mode, the deployment may fail.
    • Discovery of the resource will fail if your vCenter server has a datastore cluster folder with the same name as the specified VM cluster.
    VM Resource Pool

    Resource pool in which the virtual machine is created. Specify a resource pool under the specified VM Cluster. Do not include the VM Cluster name in the path. Leave this field empty if you specified a specific host name in the VM Cluster field or if you don't want to use a resource pool.

    Shutdown Method

    Shutdown method to be used when powering off the VM. Options are Hard and Soft.

    • Hard: Shuts down the virtual machine without shutting down any running applications
    • Soft: Shuts down all running applications on the virtual machine before shutting down the virtual machine.

      Note: Soft shutdowns require VMware Tools to be installed on the VM.

    Execution Server Selector

    (Optional) This attribute points to a pre-defined group of execution servers (grouped by a common Execution Server Selector value). To make the association, enter the same value you specified on the execution server.

    For additional information on managing App deployments per domains, see Managing Private Cloud Apps in Domains.

    Note: App deployment requires a minimum number of slots to be available. See Number of execution slots for VM deployments.

    OVF Tool Path

    (Relevant when deploying vCenter VM from an image) Path to the OVF tool installation. Use the same path for all execution servers.

    Note: This path must be accessible to all execution servers that will be used to deploy Apps.

    Reserved Networks (Optional) Comma-separated list of reserved networks. vNICs configured to these networks will not be used for VM connectivity.

    Behavior During Save (optional)

    (Applies to the Save and Restore paid add-on) The VM's state while the sandbox is being saved. Options are Remain Powered On and Power Off.

    • Remain Powered On: The VM will remain powered on during the saving state.
    • Power Off: If the VM was powered on before the sandbox entered the saving state, the VM will shut down (power off) for the duration of the save.

    Note: After save has ended, the VM returns to its state prior to saving, regardless of the behavior during the save.

    If this field is left empty, the default value is Remain Powered On.

    Saved Sandbox Storage

    (Applies to the Save and Restore paid add-on) During the saving process, CloudShell creates a clone of the sandbox's App VMs in this vCenter storage, which CloudShell will later use to restore the VM when the user restores the saved sandbox. See Save a Sandbox for more information.

    For storage purposes, these VM clones can be stored in a different data storage than the one configured in the VM Storage attribute defined on the vCenter cloud provider resource. The storage can be either a datastore or a datastore cluster. For example: datastore1 or clustername/datastore1.

    If this field is left empty, the default is the value configured in VM Storage.

    Promiscuous Mode (Optional) Configures the port groups on the virtual switch to allow all incoming traffic. This setting is enabled by default.
  9. Click Start Discovery to validate the vCenter settings.

    When the discovery process completes, a confirmation message is displayed. The resource is displayed in the Inventory dashboard in CloudShell Portal and in Resource Manager.

    Apps can now be added using the vCenter resource. For additional information, see Adding App templates.

    To customize the App deployment types and publish App orchestration parameters, see Customizing App Deployment Types.

Related Topics