Skip to content

Cloud Foundry - Process Steps

Bind Service

This step binds a Cloud Foundry service instance onto a Cloud Foundry application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example, http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization where the application will be deployed, for example: some-spaceNo
Application NametextBoxThe name of the application to bind to the service.Yes
Service nametextBoxThe name of the service to be bound.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Create Domain

This step creates a domain in an organization.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example, http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.Yes
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-spaceNo
DomaintextBoxName of the domain owning the route.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Create Route

This step creates a URL route in a space.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example, http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
DomaintextBoxName of the domain owning the route.Yes
HostnametextBoxThe hostname within the domain for the URL route.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
CLI VersiontextBoxSpecify 7 if using version cli 7 else leave blank.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Create or Update User-Provided Service

This step creates or updates a user-provided service instance.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example, http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.Yes
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.Yes
User-Provided ServicetextBoxThe name of the user-provided service.Yes
CredentialstextAreaBoxCredentials, in JSON format, to be exposed in the VCAP_SERVICES environment variable for bound applications. A full file path may also be specified. Example: {"username":"admin", "password":"pa55woRD"} Windows users must escape each double quote with a backslash.Yes
Log Drain URLtextBoxThe URL to which logs for bound applications will be streamed.No
Route Service URLtextBoxThe URL to which requests for bound routes will be forwarded. Scheme for this URL must be https. Note: This feature was added in Cloud Foundry CLI v6.16.0.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Create Service

This setp creates a new Cloud Foundry Service.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Service nametextBoxThe name of the service.Yes
Service typetextBoxThe type of service.Yes
Service plantextBoxThe service plan.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Create Subdomain

This step creates a subdomain in an organization.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.Yes
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
SubdomaintextBoxThe name of the subdomain, as in: myapp of myapp.domain.org.Yes
DomaintextBoxThe name of the domain, as in: domain.org of subdomain myapp.domain.org.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Delete App

This step deletes an application.

NameTypeDescriptionRequired
APItextBoxA url of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Application nametextBoxThe name of the application.Yes
Delete mapped routescheckBoxAlso delete any mapped routes.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Delete Domain

Delete a domain.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
DomaintextBoxThe name of the domain to remove.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Delete Route

This step deletes a route.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
DomaintextBoxName of the domain owning the route.No
HostnametextBoxThe hostname within the domain for the URL route.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not ne performedNo
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Delete Service

This step deletes a Cloud Foundry Service.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Service nametextBoxThe name of the service.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Delete Subdomain

This step deletes a subdomain.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
SubdomaintextBoxThe name of the subdomain, as in: myapp of myapp.domain.org.Yes
DomaintextBoxThe name of the domain, as in: domain.org of myapp.domain.org.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Execute CF Script

This step executes a cf script. The context will be set up with the authenticated user and target space.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
ScripttextAreaBoxEach command needs to be on a new line.Yes
ArgumentstextBoxThese are the arguments to be passed to the script, separated by spaces.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Execute CF bash file

This step executes a bash file. The context will be set up with the authenticated user and target space. The sh command must be available from the command line.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
ScripttextBoxThe path to the cf.bash file.Yes
ArgumentstextBoxThese are the arguments to be passed to the script, separated by spaces.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Map Route

This step adds a URL route to an application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Application nametextBoxThe name of the application.Yes
DomaintextBoxThe domain to use, as in: example.com.Yes
HostnametextBoxThe hostname within the domain for the url route.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Push Application

This step pushes the application with or without a manifest file. If a manifest file is found, then properties are used as overrides.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Application NametextBoxThe name of the application to use when deployed. Application Name is required, if not using a manifest.No
Application PathtextBoxThe name of zip file or other file to push. If this file isn't in your working directory, you must specify a full file path. (Otherwise just the name of the file e.g. 'myApp.zip')No
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Manifest filetextBoxThe name of the manifest file. If this file isn't in your working directory, you must specify a full file path. (Otherwise, just specify the name of the file, for example: 'manifest.xml')No
DomaintextBoxSet a custom domain to be used when deploying the application.No
Sub-domaintextBoxDefine a subdomain for your application. This is useful to ensure that the URL route for the application is unique within the domain.No
Number of instancestextBoxThe number of instances of the application that will be created.No
Memory limittextBoxThe memory limit, for example: 256M, 1024M, 1G.No
Disk limittextBoxThe disk limit, for example: 256M, 1024M, 1G.No
Custom buildpacktextBoxThe name of the custom buildpack, for example: my-buildpack, or the Git URL, for example: https://github.com/heroku/heroku-buildpack-play.git).No
StacktextBoxThe stack to use (a stack is a prebuilt file system, including an operating system, that can run applications).No
TimeouttextBoxThe maximum time (in seconds) to wait for application start. Other server side timeouts may apply.No
No startcheckBoxDoes not start the application, if selected.No
No routecheckBoxDoes not create a URL route for the application, if selected. Manually create and map a route later.No
No manifestcheckBoxIgnore the manifest file, if one exists.No
No hostnamecheckBoxMap the root domain to this application.No
Random routecheckBoxCreate a random route for this application.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
StrategycheckBoxIf checked, Deployment strategy, either rolling or null.No
EndpointtextBoxValid path on the app for an HTTP health check.No
No WaitcheckBoxIf checked, Exit when the first instance of the web process is healthy.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
CLI VersiontextBoxSpecify 7 if using version cli 7 else leave blank.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Restart App

This step restarts an application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, sfor example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Application nametextBoxThe name of the application.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Start App

This step starts an application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Application nametextBoxThe name of the application.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plugin but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Stop App

This step stops an application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for exaple: some-space.No
Application nametextBoxThe name of the application.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Unbind Service

This step unbinds a Cloud Foundry Service from a cf.application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Application nametextBoxThe name of the application.Yes
Service nametextBoxThe name of the service.Yes
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

Unmap Route

This step removes a url route to an application.

NameTypeDescriptionRequired
APItextBoxA URL of the target Cloud Foundry system, for example: http://api.ng.bluemix.net.Yes
Cloud Foundry UsertextBoxThe user name of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
Cloud Foundry PasswordsecureBoxThe password of the account that will interact with the Cloud Foundry system. Property is required, unless authenticated outside of UrbanCode Deploy.Yes
OrganizationtextBoxThe name of the organization where the application will be deployed.No
SpacetextBoxThe name of the space within the organization that the application will be deployed, for example: some-space.No
Application nametextBoxThe name of the application.Yes
DomaintextBoxThe domain to use, as in: example.com.Yes
HostnametextBoxThe hostname within the domain for the URL route.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No
CF_HOMEtextBoxSet the CF_HOME variable to explicitly define the location of the config.json file. A new CF_HOME will be used for each step, if not specified.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Use Shell InterpreterselectBoxUse a shell to interpret cf commands. This provides backward compatibility with the community plug-in, but does not escape special characters.No
Environment VariablestextAreaBoxSet environment variables using the following syntax: name=value. Separate each pair with a new line or comma.No

CF Auto-Configure

This step discovers and configures all organizations and spaces for each organization into a resource tree in UrbanCode Deploy.

NameTypeDescriptionRequired
Cloud Foundry APItextBoxThe URL of the Cloud Foundry API endpoint.No
Cloud Foundry CLI PathtextBoxThe path to the cf command line script.No
Cloud Foundry UsernametextBoxThe username to authenticate with the Cloud Foundry server.Yes
Cloud Foundry PasswordtextBoxThe password to authenticate with the Cloud Foundry server.Yes
ResourcetextBoxThe Resource being configured.No
Skip SSL ValidationcheckBoxIf checked, SSL validation will not be performed.No

CF Discovery

This step will discover if Cloud Foundry is on an agent, by checking common installation paths. If Cloud Foundry is on the agent, UrbanCode Deploy will assign the role to the resource and set the command path property.

NameTypeDescriptionRequired
ResourcetextBoxThe Resource being configured.No
Override CF CLI PathtextBoxProvide the full path to the cf executable file to override the auto discovery path.No
CF_HOME DirectorytextBoxFull path to your CF_HOME directory for installation verification. Not required if the property is a system environment variable.No
API EndpointtextBoxProvide the API endpoint if the config.json file does not exist or is not configured correctly on the agent to be used during discovery.No