• This repository has been archived on 28/Jul/2020
  • Stars
    star
    227
  • Rank 175,900 (Top 4 %)
  • Language
    Go
  • License
    Apache License 2.0
  • Created about 7 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A fast and easy local Cloud Foundry experience on native hypervisors, powered by LinuxKit with VPNKit

Update on CF Dev

This repository is no longer receiving updates.


CF Dev

start


CF Dev is a distribution of Cloud Foundry designed to run on a developerโ€™s laptop or workstation using native hypervisors and a fully functional BOSH Director. CF Dev gives application developers the full Cloud Foundry experience in a lightweight, easy to install package. CF Dev is intended for application developers who wish to develop and debug their application locally on a full-featured Cloud Foundry. CF Dev is also an excellent getting started environment for developers interested in learning and exploring Cloud Foundry.

Recommended system requirements

  • Operating system: MacOS 10.12+/Windows 10+/Linux (Note: Only the Ubuntu distro is currently suppported)
  • CPU: 2 Cores or more
  • Memory: 8 Gigabytes available memory
  • Disk: 60GB flash storage
  • Dependencies: QEMU and Libvirt for Linux
    • Ubuntu: sudo apt install qemu-kvm libvirt-bin libvirt-doc

Getting Started

Install

  1. Install the CF CLI
  2. Install the CF Dev plugin cf install-plugin -r CF-Community cfdev
  3. Run CF Dev cf dev start

Note: For more installation and configuration options, please see the FAQ.

Use BOSH

  1. Install BOSH CLI v2.
  2. Set environment variables to point BOSH to your CF Dev instance
    • Unix: eval "$(cf dev bosh env)"
    • Windows: cf dev bosh env | Invoke-Expression
  3. Run BOSH bosh <command you want to run>

Uninstall

To stop CF Dev run cf dev stop. This will completely stop and destroy the CF Dev VM.

To uninstall the CF Dev cf CLI plugin run cf uninstall-plugin cfdev.

To reclaim consumed disk space, delete your CF Dev directory:

  • Unix: rm -rf ~/.cfdev
  • Windows Remove-Item -Recurse ~/.cfdev

Features

  • Insecure Docker Registries: Invoke cf dev start with the -r flag to specify a comma separated list of insecure docker registries that will be available for use during the cf push process.

  • Proxy Support: Export HTTP_PROXY, HTTPS_PROXY, NO_PROXY environment variables during your terminal session to have them respected during the start process and within your CF Dev virtual machine. Not yet supported on the Linux platform.

  • Host Access: Access the host machine from within application containers using the host.cfdev.sh domain name.

  • TCP Routing: You can learn more about TCP Routing from within the Cloud Foundry platform here.

Telemetry

Here on the CF Dev team, we use telemetry to help us understand how our tool is being used. We value our users privacy, therefore all telemetry is completely anonymous. There is no way for anyone with the telemetry to identify who is using the CF Dev tool. In an effort to make our data as transparent as possible, we will be publishing aggregated anonymous usage data to this page periodically to help our user community understand how the tool is being used.

In addition to making this data completely anonymous, we require users to opt-in to allowing us to collect telemetry from their tool. Upon running $ cf dev start for the first time, we will prompt the user to opt-in to capturing analytics. Any time after that you can turn on/off telemetry by running $ cf dev telemetry --on/off.

You can learn more about what we do with telemetry here

Development

See Docs.

Community

FAQ

See FAQ.

More Repositories

1

vcap

Cloud Foundry - the open platform as a service project
Ruby
1,324
star
2

lattice-release

Lattice
Go
747
star
3

cf-release

Deprecated: Cloud Foundry Release
Shell
576
star
4

vmc

The command line client for Cloud Foundry - the open platform as a service project
Ruby
377
star
5

bosh-lite

A lite development env for BOSH
Shell
319
star
6

warden

Cloud Foundry - the open platform as a service project
Ruby
281
star
7

vcap-services

Cloud Foundry - the open platform as a service project
Ruby
276
star
8

oss-docs

Documentation for the Cloud Foundry Platform as a Service
Shell
139
star
9

cf-abacus

CF usage metering and aggregation
JavaScript
98
star
10

vblob

JavaScript
64
star
11

bosh-notes

Collection of proposals for BOSH
Ruby
51
star
12

cf-docs

A well lit place for docs
CSS
46
star
13

garden-linux

Garden with a linux backend
Go
44
star
14

eclipse-integration-cloudfoundry

Cloud Foundry Integration for Eclipse
Java
41
star
15

hm9000

Go
40
star
16

jibber_jabber

Cross Platform locale detection for Golang
Go
39
star
17

dea_ng

Droplet Execution Agent for Cloud Foundry v2
Ruby
34
star
18

login-server

Cloud Foundry Login Server
Java
32
star
19

health_manager

Cloud Foundry - the open platform as a service project
Ruby
32
star
20

bosh-init

bosh-init is a tool used to create and update the Director VM
Go
31
star
21

istio-release

DEPRECATED: Istio + Cloud Foundry
Shell
29
star
22

vcap-test-assets

Cloud Foundry - the open platform as a service project
Ruby
24
star
23

garden-windows

Garden with a windows backend
C#
24
star
24

router

Cloud Foundry - the open platform as a service project
Ruby
23
star
25

bosh-workspace

Gem for managing your bosh workspace
Ruby
22
star
26

cf-openstack-validator

This repository is UNMAINTAINED.
Ruby
21
star
27

cf-networking-examples

Go
21
star
28

cf-swagger

Collection of Swagger descriptions and applications for CloudFoundry BOSH
Go
21
star
29

cf-mysql-broker

CSS
20
star
30

gonit

gonit
Go
19
star
31

cf

The Cloud Foundry command-line interface
Ruby
19
star
32

cf-dotnet-sdk

Cloud Foundry .NET SDK
C#
18
star
33

cloud_controller

Ruby
18
star
34

bosh-ext-cli

CLI that includes additional set of commands for interacting with BOSH and release authoring
Go
18
star
35

micro

Micro Cloud Foundry
Ruby
17
star
36

cf-docs-cn

Chinese translation of V1 docs
CSS
17
star
37

caldecott

Ruby
16
star
38

gonats

A Go NATS Client
Go
16
star
39

Diego-Enabler

A CF CLI plugin to help you migrate apps from the DEA to Diego runtime
Go
15
star
40

vcap-yeti

Cloud Foundry - the open platform as a service project
Ruby
15
star
41

dea

Ruby
14
star
42

mega-ci

Scripts, templates, and configuration for the CF Infrastructure team's CI pipelines
Shell
13
star
43

networking-release

CF-BOSH Release containing several jobs to configure VM networking
Shell
13
star
44

vcap-node

Cloud Foundry - the open platform as a service project
JavaScript
13
star
45

vcap-tools

Java
12
star
46

multi-buildpack

Cloud Foundry buildpack for running multiple buildpacks
Go
12
star
47

cf-app-sd-release

Service Discovery for CloudFoundry
Go
12
star
48

cf-docs-deprecated

JavaScript
12
star
49

mssql-server-broker

Cloud Foundry service broker for Microsoft SQL Server
Java
12
star
50

vcap-staging

Cloud Foundry - the open platform as a service project
Ruby
12
star
51

cfoundry

Cloud Foundry REST API gem
Ruby
12
star
52

acm

Ruby
11
star
53

bosh-openstack-environment-templates

This repository is UNMAINTAINED, please consider https://github.com/cloudfoundry/bosh-bootloader to deploy BOSH on OpenStack
HCL
11
star
54

IronFrame

Windows Container library
C#
11
star
55

wats

Windows Acceptance Tests
Go
10
star
56

cf-logmon

Kotlin
10
star
57

cf-vs-extension

Cloud Foundry Visual Studio Extension
C#
10
star
58

firehose-plugin

Cloud Foundry CLI plugin to connect to the firehose
Go
10
star
59

consul-release

This is a BOSH release for consul.
Go
10
star
60

brooklyn-plugin

A CLI Plugin for Cloud Foundry for use with Brooklyn Service Broker
Go
10
star
61

cephfs-bosh-release

Shell
10
star
62

scalable-syslog

Go
10
star
63

common

Ruby
10
star
64

vcap-services-base

Ruby
9
star
65

cf-windows-prison

A library that aims to faciliate a multi-tenant secure environment on Microsoft Windows Server.
C#
9
star
66

cf-riak-cs-release

A BOSH release for riak and riak-cs
Shell
9
star
67

stac2

Load test system for cloudfoundry
JavaScript
9
star
68

apache-brooklyn-service-broker

A Cloud Foundry Service Broker for Apache Brooklyn
Java
9
star
69

vcap-ruby

Ruby
9
star
70

cf-deployment-transition

This repository is deprecated - no longer accepting PR's or Issues
Shell
9
star
71

datadog-firehose-nozzle

OBSOLETE CF component to forward metrics from the Loggregator Firehose to DataDog
Go
9
star
72

receptor

restful api facade for diego
Go
8
star
73

cf-mssql-broker

A Go broker for MSSQL Service
Go
8
star
74

cf-networking-notes

HTML
8
star
75

oss-release

Shell
8
star
76

tools-cf-plugin

Ruby
8
star
77

cloudfoundry.org

CSS
8
star
78

windows_app_lifecycle

C#
8
star
79

storeadapter

Golang interface for ETCd/zookeeper style datastores
Go
8
star
80

gonatsd

Go
7
star
81

cf_canaries

A gem for installing canary apps in a CloudFoundry installation
Ruby
7
star
82

cloudfoundry-buildpack-clr

Cloud Foundry buildpack for CLR frameworks like ASP.NET and .NET standalone apps
Ruby
6
star
83

stager

Cloud Foundry - the open platform as a service project
Ruby
6
star
84

bosh-photon-cpi-release

Go
6
star
85

loggregator-k8s-deployment

A deployment of loggregator on kubernetes
Shell
6
star
86

vmc-lib

Cloud Foundry - the open platform as a service project
Ruby
6
star
87

stager-client

Cloud Foundry - the open platform as a service project
Ruby
6
star
88

nyet

not yeti
Ruby
5
star
89

bosh-packer-templates

Shell
5
star
90

collector

(DEPRECATED) Cloud Foundry Metric Collector
Ruby
5
star
91

errors

Shared error codes and messages for Cloud Foundry
5
star
92

oss-tools

Ruby
5
star
93

vcap-concurrency

Ruby
5
star
94

gamble

A go wrapper around libyaml
C
5
star
95

go_cfmessagebus

Wrapper to Message Bus for CF, currently NATS.
Go
5
star
96

diego-cli-plugin

Go
5
star
97

api-deprecated

Experimental CF API server written in GO
C
5
star
98

dea-hm-workspace

This is a go workspace for the health manager and its dependencies
Shell
5
star
99

cf-abacus-broker

A broker for the CF-Abacus project with associated UI and other artifacts
JavaScript
5
star
100

cf-mongodb-example-app

MongoDB Example Application
Ruby
5
star