MicroPCF is an open source project for running a local version of Pivotal Cloud Foundry. It supports the CF CLI and runs using Vagrant on VirtualBox, VMware Fusion for Mac, VMware Workstation for Windows, and Amazon Web Services.
[ Website | Latest Release | Nightly Builds ]
A colocated deployment of microPCF can be launched locally with Vagrant. You will need:
- A microPCF Vagrantfile from the latest release or nightly builds
- Vagrant 1.7+ installed
Download the Vagrantfile into a new local folder, and open a prompt to that folder:
# download https://github.com/pivotal-cf/micropcf/releases/download/<VERSION>/Vagrantfile-<VERSION>.base
# mv Vagrantfile-<VERSION>.base Vagrantfile
vagrant up --provider virtualbox
By default, the cluster can be targeted at cf api api.local.micropcf.io --skip-ssl-validation
.
Unless you're attempting to develop microPCF itself, please download the Vagrantfile from Github Releases or Nightly Builds. There's no need to clone the repository in order to use microPCF.
These variables must be set during vagrant up.
MICROPCF_IP
- sets the IP address to bring up the VM onMICROPCF_DOMAIN
- sets an alternate alias for the system routes to be defined on
- defaults to
local.micropcf.io
, then$MICROPCF_IP.xip.io
VM_CORES
- number of CPU cores to allocate on the Guest VM (defaults to host # of logical CPUs)VM_MEMORY
- number of MB to allocate on the Guest VM (defaults to 25% of host memory)
More information is available on the Cloud Foundry CLI README or the Cloud Foundry CLI Releases page. Please install the appropriate binary for your architecture.
- Ubuntu 14.04 LTS does not install a compatible version of Vagrant by default. A compatible version can be found on the Vagrant Downloads page.
- Use an Administrator shell to deploy using VMware Workstation on Windows.
If you are interested in contributing to microPCF, please refer to the contributing guidelines and development instructions.
See LICENSE for details. Copyright (c) 2015 Pivotal Software, Inc.