Cloud Foundry

Spinnaker supports deploying applications to Cloud Foundry.

In Cloud Foundry (CF), an Account maps to a user account on a CF foundation (a BOSH Director and all the VMs it deploys). You can add multiple accounts for one or more CF foundations.

Prerequisites

Your CF foundations’ API endpoints must be reachable from your installation of Spinnaker.

Add an account

First, make sure that the provider is enabled:

hal config provider cloudfoundry enable

Next, run the following hal command (replacing placeholders with actual values) to add an account named my-cf-account to your list of Cloud Foundry accounts:

hal config provider cloudfoundry account add my-cf-account \
  --api-host=[api.sys.endpoint.for.foundation] \
  --user=[user-account] \
  --password=[user-password] \
  --environment=[dev,prod,...] \
  --apps-manager-url=[http://apps.sys.endpoint.for.foundation] \
  --metrics-url=[http://metrics.sys.endpoint.for.foundation] \
  --skip-ssl-validation=[true|false] (optional, default: false)

NOTE:

1. --skip-ssl-validation=true may be necessary when adding an account with a CF API endpoint using a self-signed SSL certificate or a certificate issued by an internal certificate authority. Turning this on will generate a warning.

As part of the command execution, Halyard will attempt to connect to the Cloud Foundry instance. Halyard will return an error if this attempt fails.

To see the current accounts configured for the provider, you can run:

hal config provider cloudfoundry account list

To see details about any account for the provider, you can run:

hal config provider cloudfoundry account get [account-name]

Finally, apply your changes:

$ hal deploy apply

Within a few minutes after applying your changes, you should be able to view the CF instance’s existing applications from your installation of Spinnaker.

Next steps

Optionally, you can set up another cloud provider , but otherwise you’re ready to choose an environment in which to install Spinnaker.

Last modified August 25, 2020: wip setup section frontmatter cleanup (3199a8c)