Integration Guides

Clouds

Deployment

Service Discovery

Consul

Morpheus can integrate with Consul to automatically install the Consul Agent in Client Mode on Instances and configure communication with the Consul host.

Add Consul Integration

  1. Navigate to Administration -> Integrations and select + New Integration

  2. Select Integration Type Consul Service Registry

  3. Populate the following fields:

    Name

    Name of the Consul Integration in Morpheus

    Enabled

    Enabled by default

    Consul Host

    IP or Url of the Consul Host

    Consul Http Port

    Http port of the Consul Host

    Username

    Consul Host User

    Password

    Consul Host User Password

    Datacenter ID

    Validator key for the organization

  4. Save Changes

The added Consul Integration is now available for use in Morpheus , but must be scoped to a Cloud or Group to automatically install the Consul Agent while provisioning.

Scope Consul Integration to a Cloud

  1. Navigate to Infrastructure -> Clouds
  2. Edit the target Cloud
  3. Expand the Advanced Options section
  4. In the Service Registry dropdown, select the Consul Integration.
  5. Save Changes

Scope Consul Integration to a Group

  1. Navigate to Infrastructure -> Groups
  2. Edit the target Group
  3. Expand the Advanced Options section
  4. In the Service Registry dropdown, select the Consul Integration.
  5. Save Changes

And that’s it. After your integration is set up, all containers deployed within the Group or Cloud integrated will provision with the Consul Agent in Client Mode, gossiping to your Consul Server!

vCloud Director

How to create vCloud Director templates for Morpheus

To create a Windows Template

Create a new machine in VMware vCenter and install a base version of your preferred Windows build.

  1. Apply any service packs / updates to the operating system.
  2. Set the Network location to Private the below PowerShell will set the location.
- Get-NetConnectionProfile | Set-NetconnectionProfile -NetworkCategory private
  1. Configure WinRM to allow remote management and open the firewall.

    • To do this, under local computer Administrator, open a command prompt and run winrm quickconfig
  2. Install VMware tools

  3. Install .Net at least 4.5

  4. Enable remote PowerShell this can be done in PowerShell.

    - Enable-PSremoting
    
  5. Shutdown the virtual machine and convert to a template.

Note

Do not run sysprep

To create a Linux template

Create a new machine in VMware vCenter and install a base version of your preferred Linux distro build. If you are using cloud init as part of your image you will need to ensure your virtual machine has a cdrom.

  1. Before installing the operating system setup a single ext or xfs partition without a swap disk (This is so that growpart can extend the disk. growpart currently does not support lvm)
  2. Install the distro and apply any updates to the operating system and security updates
  3. Install cloud-init
  4. Install cloud-utils-growpart
  5. Install vmware tools
  6. Install git
  7. epel-release (This is for centos only)
  8. selinux set to permissive (enforced can cause problems with cloud-init)

We also recommend disabling network manager and setting the network adapter to eth0 rather than the automatically assigned name. https://support.morpheusdata.com/hc/en-us/articles/115002881228-Creating-a-CentOS-7-Morpheus-VMware-Image

To import your template into vCloud director you will need to login as either an administrator or organisation administrator.

Once logged into vCloud director you will then need select Manage Organizations and then select your organization.

From within the organisation click on Catalogues > select an existing catalogue or create a new catalogue.

Note

Please note once you connect Morpheus to your vCD environment, it will create a catalogue called Auto Morpheus. This is a working catalogue and is ignored by Morpheus when searching for images, so any images in the catalogue will not be synced into Morpheus

Open the catalogue and select the import template from vCenter and then browse the data stores for your templates. Select your template and the type in a new name and description then check the copy template into vCloud director.

Once you click ok the import process will begin. When the import has completed the template will appear in Morpheus within Provisioning > Virtual Images

If the image does not appear within the virtual images you may need to use the filters to filter the virtual images by the vmware ( vmdk / ovf / ova) type.

You may also need to refresh the cloud. To do this go to Infrastructure > Clouds > select the vCloud Director cloud > select Refresh.

Integrations List

Public Clouds

  • Amazon Web Services
  • Azure
  • Softlayer
  • Google Cloud
  • Digital Ocean
  • vCloud Air
  • Alibaba
  • Oracle Public Cloud
  • AWS GovCloud

Private Clouds

  • VMware
  • VMware ESXi
  • Openstack
  • Hyper-V
  • Azure Stack
  • Nutanix
  • Oracle
  • XenServer
  • VMware Fusion
  • metacloud
  • KVM
  • Cisco UCS
  • MacStadium

Automation

  • Chef
  • Puppet
  • Ansible
  • SaltStack
  • Terraform
  • Azure Resource Manager

Identity Management

  • Microsoft Active Directory
  • LDAP
  • OKTA
  • JumpCloud
  • OneLogin
  • SAML
  • Custom External
  • Custom API

Load Balancers

  • F5
  • AVI
  • A10
  • Citrix
  • HAProxy
  • Amazon ELB
  • Amazon ALB
  • Azure LB

DNS

  • Microsoft DNS
  • Power DNS
  • Amazon Route53

Storage

  • Amazon S3
  • Azure Storage
  • Swift
  • Rackspace
  • CIFS
  • NFS
  • 3Par

Networking

  • Morpheus IPAM Internal
  • Infoblox
  • Bluecat
  • Cisco ACI
  • phpIPAM

Backups

  • Morpheus Backups Internal
  • Veeam
  • Commvault

Monitoring

  • Morpheus Monitoring Internal
  • App Dynamics
  • New Relic
  • ServiceNow
  • Slack Webhook

Keys and Certifications

  • Venafi

Logs

  • Morpheus Internal Logs
  • LogRhythm
  • Splunk
  • Syslog

Service Discovery

  • Consul

ITSM

  • ServiveNow ITSM

Containers

  • Docker
  • Docker Swarm
  • Kubernetes

Deployments

  • Git
  • Jenkins