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

2.4 KiB

title reviewers content_template
Install Service Catalog using SC
chenopis
templates/task

{{% capture overview %}} {{< glossary_definition term_id="service-catalog" length="all" prepend="Service Catalog is" >}}

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.

{{% /capture %}}

{{% 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>
    

{{% /capture %}}

{{% 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

{{% /capture %}}

{{% capture whatsnext %}}

{{% /capture %}}