GoogleCloudPlatform/k8s-service-catalog

Name: k8s-service-catalog

Owner: Google Cloud Platform

Description: Commandline tool to manage Service Catalog lifecycle and GCP Service Broker atop Kubernetes Cluster

Created: 2017-09-13 22:10:55.0

Updated: 2018-05-24 01:23:03.0

Pushed: 2018-05-18 00:03:29.0

Homepage:

Size: 3506

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Service Catalog Installer

Service Catalog Installer is a CLI tool to manage Service Catalog and Google Cloud Platform Service Broker atop Kubernetes Cluster.

• Intro
• Requirements
• Installation
• Usage
• Build
• Basic Tutorial
• Contribution

Intro

Service Catalog Installer sc lets you do the following:

• Install Service Catalog
• Uninstall Service Catalog
• Install the Service Broker
• Uninstall the Service Broker

Requirements

Before installing Service Catalog atop Kubernetes cluster, you need to ensure following requirements are met.

• cfssl tools are needed for generating SSL artifacts. Install cfssl using following command

  et -u github.com/cloudflare/cfssl/cmd/...
  h cfssl
  e/sunil/go/bin/cfssl
  h cfssljson
  e/sunil/go/bin/cfssljson
  

• Service Catalog requires Kubernetes version 1.7 onwards.
• Kubectl installed and configured to connect to a Kubernetes v1.7+ cluster.
• Kubectl user should have cluster-admin role to be able to install Service Catalog. Run following command to ensure that:

  ctl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --user=<user-name>
  

• gcloud should be installed and configured with following commands in order to be used by the sc to configure the Service Broker.

  ud components install beta
  ud auth login
  ud auth application-default login
  

Installation

sc is written in Go and can be installed using go get.

et -u github.com/GoogleCloudPlatform/k8s-service-catalog/installer/cmd/sc

After running the above command, sc should get installed in your GOPATH/bin dir.

Usage

• To print usage instructions, run

  -help
  

• To check if all the dependencies are installed, run

  heck
  ndency check passed. You are good to go.
  

• To install Service Catalog in Kubernetes cluster, run install help. If you are running on a non-GCP environment, specify the storageclass that you want to use for the backup.

  nstall --help
  alls Service Catalog in Kubernetes cluster.
  mes kubectl is configured to connect to the Kubernetes cluster.
  
  e:
  nstall [flags]
  
  s:
  --etcd-backup-storageclass string   Etcd Backup StorageClass (default "standard")
  --etcd-cluster-size int32           Etcd cluster size (default 3)
  --help                              help for install
  
  al Flags:
  --alsologtostderr                  log to standard error as well as files
  --log_backtrace_at traceLocation   when logging hits line file:N, emit a stack trace (default :0)
  --log_dir string                   If non-empty, write log files in this directory
  --logtostderr                      log to standard error instead of files
  --stderrthreshold severity         logs at or above this threshold go to stderr (default 2)
  --v Level                          log level for V logs
  --vmodule moduleSpec               comma-separated list of pattern=N settings for file-filtered logging
  

• To uninstall Service Catalog in Kubernetes cluster, run

  ninstall
  

• To add the Service Broker to the Service Catalog, run

  dd-gcp-broker
  

• To remove the Service Broker from the Service Catalog, run

  emove-gcp-broker
  

Build

If you want to build the installer yourself, here are the instructions to do so.

stall [Go Dep](https://github.com/golang/dep) for dependency management using `go get`
et -u github.com/golang/dep/cmd/dep

stall `go-bindata` using `go get`
et -u github.com/jteeuwen/go-bindata/...

 build `sc` binary, run

u should `sc` binary created in output/bin directory.

Tutorial

Once you have Service Catalog installed and the Service Broker added to the cluster, follow this basic tutorial to get started with Service Catalog.

Contribution

We are always looking for contributors, so if you want to contribute to the installer codebase, please follow the workflow instructions.