/cf-for-k8s

Install CF on Kubernetes (experimental)

Primary LanguageGoApache License 2.0Apache-2.0

This is a highly experimental project to deploy the new CF Kubernetes-centric components on Kubernetes. It is not meant for use in production and is subject to change in the future.

Please direct all questions to #release-integration slack channel and ping @interrupt

Deploying CF for K8s

Prerequisites

You need the following CLIs on your system to be able to run the script:

In addition, you will also probably want kubectl for your own debugging and inspection of the system.

Make sure that your Kubernetes config (e.g, ~/.kube/config) is pointing to the cluster you intend to deploy CF for K8s to. This cluster should be on an IaaS that supports load balancer services (e.g., GKE, AKS, etc.).

Steps to deploy

  1. Git clone this repository and cd into this directory.
  2. Update the submodules of this repository: git submodule update --init --recursive.
  3. Deploy a database that can be used for the Cloud Controller's DB.
  • For example:
helm repo add stable https://kubernetes-charts.storage.googleapis.com
helm upgrade --install capi-database stable/postgresql -n default -f <(cat <<EOF
initdbScripts:
setup_db.sql: |
  CREATE DATABASE cloud_controller;
  CREATE ROLE cloud_controller LOGIN PASSWORD 'cloud_controller';
hello_world.sh: |
  #!/bin/bash
  echo "hello, world!"
  psql -U postgres -f /docker-entrypoint-initdb.d/setup_db.sql
  psql -U postgres -d cloud_controller -c "CREATE EXTENSION citext"
  psql -U postgres -d cloud_controller -c "create sequence bobby"
EOF
)
  1. Create a file called cf-install-values.yml. You can use sample-cf-install-values.yml in this directory as a starting point.
  2. From this directory, run bin/install-cf.sh <path to your cf-install-values.yml file>
  3. Configure DNS on your IaaS provider to point the wildcard subdomain of your system domain and the wildcard subdomain of all apps domains to point to external IP of the Istio Ingress Gateway service. You can retrieve the external IP of this service by running kubectl get svc -n istio-system istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[*].ip}'