Go HTML Ruby Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Cloud Foundry Container Runtime

A BOSH release for Kubernetes. Formerly named kubo.

Prerequisites

  • A BOSH Director configured with UAA, Credhub, and BOSH DNS.
  • kubo-release
  • kubo-deployment
  • Cloud Config with
    • vm_types named minimal, small, and small-highmem (See cf-deployment for reference)
    • network named default
    • There are three availability zones azs, and they are named z1,z2,z3
    • note: the cloud-config properties can be customized by applying ops-files. See manifests/ops-files for some examples

Deploying CFCR

Single Master

  1. Upload the latest Xenial stemcell to the director.
  2. Upload the latest kubo-release to the director.
    bosh upload-release https://bosh.io/d/github.com/cloudfoundry-incubator/kubo-release
    
  3. Deploy
    cd kubo-deployment
    
    bosh deploy -d cfcr manifests/cfcr.yml \
      -o manifests/ops-files/misc/single-master.yml
    
  4. Add kubernetes system components
    bosh -d cfcr run-errand apply-specs
    
  5. Run the following to confirm the cluster is operational
    bosh -d cfcr run-errand smoke-tests
    

Three Masters

  1. Upload the latest Xenial stemcell to the director.
  2. Upload the latest kubo-release to the director.
    bosh upload-release https://bosh.io/d/github.com/cloudfoundry-incubator/kubo-release
    
  3. Deploy
    cd kubo-deployment
    
    bosh deploy -d cfcr manifests/cfcr.yml
    
  4. Add kubernetes system components
    bosh -d cfcr run-errand apply-specs
    
  5. Run the following to confirm the cluster is operational
    bosh -d cfcr run-errand smoke-tests
    

BOSH Lite

CFCR clusters on BOSH Lite are intended for development. We run the deploy_cfcr_lite script to provision a cluster with the latest stemcell and master of kubo-release.

cd kubo-deployment
./bin/deploy_cfcr_lite

Accessing the CFCR Cluster with kubectl

Without Load Balancer

  1. Login to the Credhub Server that stores the cluster's credentials:
    credhub login
    
  2. Find the IP address of one master node by running
    bosh -d cfcr vms
    
  3. Configure the kubeconfig for your kubectl client:
    cd kubo-deployment
    
    ./bin/set_kubeconfig <DIRECTOR_NAME>/cfcr https://<master_node_IP_address>:8443
    

Deprecations

CFCR Docs

We are no longer supporting the following documentation for deploying BOSH and CFCR

The deploy_bosh and deploy_k8s scripts in the kubo-deployment repository are now deprecated.

Heapster

K8s 1.11 release kicked off the deprecation timeline for the Heapster component, see here for more info. As a result, we're in the process of replacing Heapster with Metrics Server in the upcoming releases of kubo-release.