website/docs/tasks/service-catalog/install-service-catalog-usi...

2.4 KiB

title approvers
Install Service Catalog using SC
chenopis

{% capture overview %} {% glossary_definition term_id="service-catalog" length="long" %}

Use the Service Catalog Installer tool to easily install or uninstall Service Catalog on your Kubernetes cluster. This CLI tool is installed as sc in your local environment.

{% endcapture %}

{% capture prerequisites %}

  • Understand the key concepts of Service Catalog.

  • Install Go 1.6+ and set the GOPATH.

  • Install the cfssl tool needed for generating SSL artifacts.

  • Service Catalog requires Kubernetes version 1.7+.

  • Install and setup kubectl so that it is configured to connect to a Kubernetes v1.7+ cluster.

  • The kubectl user must be bound to the cluster-admin role for it to install Service Catalog. To ensure that this is true, run the following command:

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

{% endcapture %}

{% capture steps %}

Install sc in your local environment

Install the sc CLI tool using the go get command:

go get github.com/GoogleCloudPlatform/k8s-service-catalog/installer/cmd/sc

After running the above command, sc should be installed in your GOPATH/bin directory.

Install Service Catalog in your Kubernetes cluster

First, verify that all dependencies have been installed. Run:

sc check

If the check is successful, it should return:

Dependency check passed. You are good to go.

Next, run the install command and specify the storageclass that you want to use for the backup:

sc install --etcd-backup-storageclass "standard"

Uninstall Service Catalog

If you would like to uninstall Service Catalog from your Kubernetes cluster using the sc tool, run:

sc uninstall

{% endcapture %}

{% capture whatsnext %}

{% endcapture %}

{% include templates/task.md %}