Valid since:
XL Deploy 8.0.0

Introduction to the XL Deploy Cloud Foundry plugin

The XL Deploy Cloud Foundry plugin supports:

  • Creating spaces
  • Deploying Cloud Foundry applications
  • Creating routes for a Cloud Foundry application
  • Binding services with a Cloud Foundry application
  • Creating Cloud Foundry services
  • Deploying Cloud Foundry application using a manifest file

For more information about the XL Deploy Cloud Foundry plugin requirements and the configuration items (CIs) that the plugin supports, refer to the Cloud Foundry Plugin Reference.

Using the XL Deploy Cloud Foundry plugin

The XL Deploy Cloud Foundry plugin can push and remove applications on a Cloud Foundry organization. To use the plugin:

  1. Download the XL Deploy Cloud Foundry plugin ZIP from the distribution site.
  2. Unpack the plugin inside the XL_DEPLOY_SERVER_HOME/plugins/ directory.
  3. Restart XL Deploy.

Create the Cloud Foundry organization

To create a Cloud Foundry organization in XL Deploy:

  1. Under Infrastructure, create a cloudFoundry.Organization CI.
  2. Specify the following properties:
    • Organization Name: Organization name on the Cloud Foundry server.
    • API Endpoint: API endpoint of Cloud Foundry server (for example, api.run.pivotal.io).
    • Username: User name to use for authentication.
    • Password: Password to use for authentication.

Provision a Cloud Foundry space

To provision a new Cloud Foundry space:

  1. Under Applications, create an application (udm.Application) and deployment package (udm.DeploymentPackage).
  2. Under the deployment package, create a cloudFoundry.SpaceSpec CI.
  3. Specify the Space Name to use. If not provided, the CI name will be used as the space name.

Alternatively, you can use a space that already exists in Cloud Foundry by creating a cloudFoundry.Space CI under the cloudFoundry.Organization CI (in Infrastructure).

Push an application to Cloud Foundry

To push an application to Cloud Foundry:

  1. Under Applications, create an application (udm.Application) and deployment package (udm.DeploymentPackage).
  2. Under the deployment package, create a cloudFoundry.AppSpec CI. Specify the following required properties:
    • App Name: Application name to use.
    • Build Pack: Build pack to use (for example, Java, Go, Binary, and so on). To specify a custom build pack, fill in the Custom Build Pack URL property instead.

Configure Cloud Foundry services

To configure Cloud Foundry services:

  1. Under Applications, create an application (udm.Application) and deployment package (udm.DeploymentPackage).
  2. Under the deployment package, create a cloudFoundry.Services CI.
  3. Specify the Service Type.

Push an application to Cloud Foundry using a manifest

To push an application to Cloud Foundry:

  1. Under Applications, create an application (udm.Application) and deployment package (udm.DeploymentPackage).
  2. Under the deployment package, create a cloudFoundry.ManifestModuleSpec CI.
  3. In the File property, specify a ZIP file that contains the manifest file and artifacts required to create the application.