Cloud Foundry plugin

9 minute readExtensibilityDeveloper productivity

Cloud Foundry is an open-source, multi-cloud application platform as a service.

Plugin Version 1.6.1.2020102201

Revised on May 19, 2020

CloudBees CD integration to cloud foundry

Plugin procedures

In the CloudBees CD UI, from the Home page, open the Main Menu, and click Admin > Plugins to open the Plugin Manager.
For all parameter descriptions below, required parameters are shown in bold italics.

Plugin configuration

Plugin configurations are sets of parameters that apply across some or all of the plugin’s procedures. They are intended to reduce repetition of common values, create predefined sets of parameters for end users, and to securely store credentials where needed. Each configuration is given a unique name that is entered in designated parameters on procedures that use them.

Plugin configurations are created by going to the CloudBees CD Administration  Plugins. On the right side of the line for the specific plugin, there is a Configure link, which opens the Configuration page.

Parameter Description

Configuration

Provide a unique name for the configuration, keeping in mind that you may need to create additional configurations over time.

Description

Provide some description for configuration.

API endpoint

Provide the API endpoint to your Cloud Foundry installation, e.g. api.mycloud.com.

Organization

Provide the name of the organization, e.g. myorg.

An org is a development account that an individual or multiple collaborators can own and use. All collaborators access an org with user accounts. Collaborators in an org share a resource quota plan, applications, services availability, and custom domains.

For more information, see Orgs.

Space

Provide the space name, e.g. test.

Every application and service are scoped to a space. Each org contains at least one space. A space provides users with access to a shared location for application development, deployment, and maintenance. Each space role applies only to a particular space.

For more info, see Spaces.

Username and password

Username: Provide the user name CloudBees CD uses to communicate with the Cloud Foundry server.

Password: Provide the password for the specified Username.

Retype Password: Retype the password specified.

Debug level

Provide the level of log messages verbosity. Info by default.

Create or update application

Creates a new application or recreates the existing one and pushes application content from the specified directory. If the application with the specified name exists, it will be deleted and created anew.

For more information, see Deploy an Application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be pushed.

Application path

Path to app directory or to a zip file of the contents of the app directory. E.g. /tmp/hello-spring-cloud/target/hello-spring-cloud-0.0.1.BUILD-SNAPSHOT.jar.

Hostname

Hostname (e.g. my-subdomain). Will be used for route creation.

Disk limit

Disk limit (e.g. 256M, 1024M, 1G).

Memory limit

Memory limit (e.g. 256M, 1024M, 1G).

Route path

Path for the route. E.g. my-sample-app.

Random route?

Create a random route for this app.

Instances

Number of instances.

Startup command

Startup command, set to null to reset to default start command.

Domain

Domain (e.g. example.com).

Buildpack

Custom buildpack by name (e.g. my-buildpack) or Git URL (e.g. 'https://github.com/cloudfoundry/java-buildpack.git') or Git URL with a branch or tag (e.g. 'https://github.com/cloudfoundry/java-buildpack.git#v3.3.0' for 'v3.3.0' tag).

Endpoint property name

Property name for saving application endpoint.

Start application?

If checked, the application will be started after the deployment.

Push application

Pushes application files to the server. This procedure does not delete the application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be pushed.

Application path

Path to app directory or to a zip file of the contents of the app directory

Hostname

Hostname (e.g. my-subdomain)

Disk limit

Disk limit (e.g. 256M, 1024M, 1G)

Memory limit

Memory limit (e.g. 256M, 1024M, 1G)

Route path

Path for the route

Random route?

Create a random route for this app

Instances

Number of instances

Startup command

Startup command, set to null to reset to default start command

Domain

Domain (e.g. example.com).

Buildpack

Custom buildpack by name (e.g. my-buildpack) or Git URL (e.g. 'https://github.com/cloudfoundry/java-buildpack.git') or Git URL with a branch or tag (e.g. 'https://github.com/cloudfoundry/java-buildpack.git#v3.3.0' for 'v3.3.0' tag). To use built-in buildpacks only, specify 'default' or 'null'

Endpoint property name

Property name for saving application endpoint.

Start application?

If checked, the application will be started after the deployment.

Blue-green deploy

Deploys and redeploys the application with reduced downtime. For this, a new application is created, then routes and services are bound to the new application, then the old application is deleted.

For more information about blue-green deploy, see Using Blue-Green Deployment to Reduce Downtime and Risk

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be pushed.

Application path

Path to app directory or to a zip file of the contents of the app directory

Hostname

Hostname (e.g. my-subdomain)

Disk limit

Disk limit (e.g. 256M, 1024M, 1G)

Memory limit

Memory limit (e.g. 256M, 1024M, 1G)

Route path

Path for the route

Random route?

Create a random route for this app

Instances

Number of instances

Startup command

Startup command, set to null to reset to default start command

Domain

Domain (e.g. example.com).

Buildpack

Custom buildpack by name (e.g. my-buildpack) or Git URL (e.g. 'https://github.com/cloudfoundry/java-buildpack.git') or Git URL with a branch or tag (e.g. 'https://github.com/cloudfoundry/java-buildpack.git#v3.3.0' for 'v3.3.0' tag). To use built-in buildpacks only, specify 'default' or 'null'

Endpoint property name

Property name for saving application endpoint.

Start application?

If checked, the application will be started after the deployment.

Start application

Starts the specified application.

The first time you deploy an application, cloud foundry uses the buildpack start command by default. To override these defaults, provide the Startup Command option.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be started.

Stop application

Stops the specified application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be stopped.

Restage application

Restage the specified application.

Restaging your application stops your application and restages it, by compiling a new droplet and starting it. Restage your application if you have changed the environment in a way that affects your staging process, such as setting an environment variable that the buildpack consumes. The staging process has access to environment variables, so the environment can affect the contents of the droplet.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be restaged.

Restart application

Restarts the specified application.

Restarting your application stops your application and restarts it with the already compiled droplet. A droplet is a tarball that includes:

  • stack

  • buildpack

  • application source code

The Diego cell unpacks, compiles, and runs a droplet on a container. Restart your application to refresh the application’s environment after actions such as binding a new service to the application or setting an environment variable that only the application consumes. However, if your environment variable is consumed by the buildpack in addition to the application, then you must restage the application for the change to take effect.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be restarted.

Set environment variables

Sets environment variables for the specified application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to set environment variables for.

Variables

Environment variables in JSON format, e.g. \{"MYVAR": "VALUE"}

Delete application

Deletes the specified application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application to be deleted.

Get application

Gets the info about the specified application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

A name for the application.

Property name

Property name for the retrieved application data.

List applications

Lists applications on the Cloud Foundry server.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Property name

Property name for saving applications list.

Create or update service

Creates a new Service Instance or updates the existing one.

Cloud Foundry offers a marketplace of services, from which users can provision reserved resources on-demand. Examples of resources services provide include databases on a shared or dedicated server, or accounts on a SaaS application. These resources are known as service instances and the systems that deliver and operate these resources are known as Services. Think of a service as a factory that delivers service instances.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Service name

A name for service to be created, e.g. APIConnect.

Service instance name

Service instance name, e.g. my service.

Service plan

Service plan, e.g. Silver.

Parameters as JSON

Optionally provide service-specific configuration parameters in a valid JSON object in-line.

Tags

List of tags, comma-separated.

Bind service

Depending on the service, binding a service instance to your application may deliver credentials for the service instance to the application. See the Delivering Service Credentials to an Application topic for more information. Binding a service instance to an application may also trigger application logs to be streamed to the service instance. For more information, see Streaming Application Logs to Log Management Services.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Service instance name

Service instance name.

Application name

Application name.

Unbind service

Unbinds the specified service instance from the application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Service instance name

Service instance name.

Application name

Application name.

Delete service

Deletes the specified service instance.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Service instance name

Service instance name.

Create route

Creates a new route.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Domain

Domain for the route.

Hostname

Hostname for the HTTP route (required for shared domains).

Path

Path for the HTTP route.

Port

Hostname for the HTTP route (required for shared domains).

Random port?

If checked, a random port will be created.

Map route

Maps a route to an application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

Application name

Domain

Domain for the route.

Hostname

Hostname for the HTTP route (required for shared domains).

Path

Path for the HTTP route.

Port

Hostname for the HTTP route (required for shared domains).

Random port?

If checked, a random port will be created.

Unmap route

Unmaps a route from an application.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Application name

Application name

Domain

Domain for the route.

Hostname

Hostname for the HTTP route (required for shared domains).

Path

Path for the HTTP route.

Port

Hostname for the HTTP route (required for shared domains).

Delete route

Deletes the specified route.

Parameter Description

Configuration name

Previously defined configuration name.

Space

A space provides users with access to a shared location for application development, deployment, and maintenance. Will be taken from the config, if defined.

Domain

Domain for the route.

Hostname

Hostname for the HTTP route (required for shared domains).

Path

Path for the HTTP route.

Port

Hostname for the HTTP route (required for shared domains).

Create space

Creates a new space.

Parameter Description

Configuration name

Previously defined configuration name.

Space name

A name for a space.

Organization

Organization for a space.

Quota

Quota to assign to the newly created space.

Delete space

Deletes the specified space.

Parameter Description

Configuration name

Previously defined configuration name.

Space name

A name for a space.

Release notes

EC-CloudFoundry 1.6.1

  • The documentation has been migrated to the main documentation site.

EC-CloudFoundry 1.6.0

  • Changed dependency delivery procedure.

  • Renaming to "CloudBees CD".

EC-CloudFoundry 1.5.1

  • Renaming fto "CloudBees"

EC-CloudFoundry 1.5.0

  • Plugin promotion time has been improved.

EC-CloudFoundry 1.4.2

  • Configurations can be created by users with "@" sign in a name.

EC-CloudFoundry 1.4.1

  • The plugin icon has been updated.

EC-CloudFoundry 1.4.0

  • New procedure "Set Environment Variables" was added.

EC-CloudFoundry 1.3.2

  • Blue-Green Deploy procedure has been added.

EC-CloudFoundry 1.3.1

  • Documentation has been refined.

EC-CloudFoundry 1.3.0

  • Space management procedures were added: Create Space and Update Space.

EC-CloudFoundry 1.2.1

  • A bug with Start Application checkbox was fixed in Create or Update Application procedure.

EC-CloudFoundry 1.2.0

  • List Application procedure was added.

  • Restage, Restart and Push Application procedures were added.

EC-CloudFoundry 1.0.1

  • Get Application procedure was added.

EC-CloudFoundry 1.0.0

  • First release.