PCF Dev is a new distribution of Cloud Foundry designed to run on a developer’s laptop or workstation. PCF Dev gives application developers the full Cloud Foundry experience in a lightweight, easy to install package. PCF Dev is intended for application developers who wish to develop and debug their application locally on a full-featured Cloud Foundry. PCF Dev is also an excellent getting started environment for developers interested in learning and exploring Cloud Foundry.
More information about the project can be found on the FAQ.
This repository contains source code that allows developers to build an open source version of PCF Dev that only contains the Elastic Runtime. The binary distribution of PCF Dev that is available on the Pivotal Network contains other PCF components (such as the MySQL, Redis, and RabbitMQ marketplace services) that are not available in this repository.
However, we encourage you to leave any feedback or issues you may encounter regarding the full, binary distribution of PCF Dev in this repository's Github issues.
- Download the latest
pcfdev-VERSION-PLATFORM.zip
from the Pivotal Network. - Unzip the zip file and navigate to its containing folder using PowerShell or a Unix terminal.
- Run the extracted binary.
- Run
cf dev start
.
Check out the documentation for more information. Running
cf dev help
will display an overview of PCF Dev VM management commands.
- CF CLI
- VirtualBox: 5.0+
- Internet connection (or Dnsmasq or Acrylic) required for wildcard DNS resolution
Follow the instructions provided at the end of cf dev start
to connect to PCF Dev:
Downloading VM...
Progress: |====================>| 100%
VM downloaded
Importing VM...
Starting VM...
Provisioning VM...
Waiting for services to start...
49 out of 49 running
_______ _______ _______ ______ _______ __ __
| || || | | | | || | | |
| _ || || ___| | _ || ___|| |_| |
| |_| || || |___ | | | || |___ | |
| ___|| _|| ___| | |_| || ___|| |
| | | |_ | | | || |___ | |
|___| |_______||___| |______| |_______| |___|
is now running.
To begin using PCF Dev, please run:
cf login -a https://api.local.pcfdev.io --skip-ssl-validation
Admin user => Email: admin / Password: admin
Regular user => Email: user / Password: pass
The
local.pcfdev.io
domain may differ slightly for your PCF Dev instance.
To stage a simple app on PCF Dev, cd
into the app directory and run cf push <APP_NAME>
.
See cf documentation for information on deploying apps and attaching services.
To temporarily stop PCF Dev run cf dev stop
.
To destroy your PCF Dev VM run cf dev destroy
.
To uninstall the PCF Dev cf CLI plugin run cf uninstall-plugin pcfdev
If you are interested in contributing to PCF Dev, please refer to the contributing guidelines and development instructions.
See LICENSE for details. Copyright (c) 2016 Pivotal Software, Inc.
PCF Dev uses a version of Monit that can be found here, under the GPLv3 license.