Deploying Cloud Foundry

Page last updated:

This topic describes the process for deploying Cloud Foundry using BOSH. It assumes you have already targeted your BOSH Director, created a Cloud Foundry manifest, and set it as your deployment.

Upload a Stemcell

A stemcell is a versioned image of a bare-minimum OS skeleton, wrapped with IaaS-specific packaging. Deploying Cloud Foundry starts with specifying a stemcell, which BOSH installs on each component VM.

  1. Open in a web browser to view the current list of publicly available BOSH stemcells.

  2. Choose a BOSH stemcell for your IaaS and click the build number to download it to your computer. The stemcell downloads as a gzipped tar archive which you should not unzip.

  3. In a terminal window, run bosh upload stemcell STEMCELL-PATH to upload your stemcell to the BOSH Director, where STEMCELL-PATH is the location of your downloaded stemcell file.

    bosh upload stemcell ~/downloads/light-bosh-stemcell-3202-aws-xen-hvm-ubuntu-trusty-go_agent.tgz

Build the Cloud Foundry Release

Use bosh create release to create a Cloud Foundry release.

$ bosh create release

After some processing, this command prompts you for a development release name. The release names correspond to the files in cf-release/releases.

Upload the Cloud Foundry Release

Use bosh upload release to upload the generated release to the BOSH Director.

$ bosh upload release


Use bosh deploy to deploy the uploaded Cloud Foundry release.

$ bosh deploy

Verify the Deployment

  1. Run bosh vms. This command provides an overview of the virtual machines that BOSH manages as part of the current deployment. The state of every VM should show as running.

  2. Use curl to test the API endpoint of your Cloud Foundry installation at api.YOUR-SYSTEM-DOMAIN/info.

    $ curl api.INCORRECT-SYSTEM-DOMAIN/info
    404 Not Found: Requested route ('') does not exist.
    $ curl api.YOUR-SYSTEM-DOMAIN
     "code": 10000,
     "description": "Unknown request",
     "error_code": "CF-NotFound"
    $ curl api.YOUR-SYSTEM-DOMAIN/info
    {"name":"vcap","build":"2222","version":2,"description":"Cloud Foundry","authorization_endpoint":"https://login.YOUR-SYSTEM-DOMAIN","token_endpoint":"https://uaa.YOUR-SYSTEM-DOMAIN","allow_debug":true}

    If curl succeeds, it should return specific JSON-formatted information about your deployment. If curl does not succeed, check your networking and make sure your domain has an NS record for your subdomain.

    If you do not know YOUR-SYSTEM-DOMAIN for your Cloud Foundry installation, examine the system_domain property in your deployment manifest.

  3. You should be able to target your Cloud Foundry installation with the Cloud Foundry Command Line Interface (cf CLI) and log in as an administrator. The username is admin and the password is specified in the deployment manifest:

          - admin|ADMIN_PASSWORD|...

For more information about managing organizations, spaces, users, and applications, refer to the cf CLI topic.

Update Cloud Foundry

  • If you make change to your manifest, run bosh deploy to update your Cloud Foundry deployment with these changes.

  • If you make changes to the cf-release directory, run the following commands to update your Cloud Foundry deployment with these changes:

    $ bosh create release && bosh upload release && bosh deploy

Create a pull request or raise an issue on the source for this page in GitHub