Skip to content

Latest commit

 

History

History
57 lines (45 loc) · 2.77 KB

introduction.md

File metadata and controls

57 lines (45 loc) · 2.77 KB
Raw

Service Catalog Introduction

The Kubernetes Service Catalog provides a Kubernetes-native interface to one or more Open Service Broker API compatible service brokers.

Concepts

The service catalog API has five main concepts:

  • Open Service Broker API Server: A server that acts as a service broker and conforms to the Open Service Broker API specification. This software could be hosted within your own Kubernetes cluster or elsewhere.

The remaining four concepts all map directly to new Kubernetes resource types that are provided by the service catalog API.

  • ClusterServiceBroker: An in-cluster representation of a broker server. A resource of this type encapsulates connection details for that broker server. These are created and managed by cluster operators who wish to use that broker server to make new types of managed services available within their cluster.
  • ClusterServiceClass: A type of managed service offered by a particular broker. Each time a new ClusterServiceBroker resource is added to the cluster, the service catalog controller connects to the corresponding broker server to obtain a list of service offerings. A new ClusterServiceClass resource will automatically be created for each.
  • ServiceInstance: A provisioned instance of a ClusterServiceClass. These are created by cluster users who wish to make a new concrete instance of some type of managed service to make that available for use by one or more in-cluster applications. When a new ServiceInstance resource is created, the service catalog controller will connect to the appropriate broker server and instruct it to provision the service instance.
  • ServiceBinding: Expresses intent to use a ServiceInstance. These are created by cluster users who wish for their applications to make use of a ServiceInstance. Upon creation, the service catalog controller will create a Kubernetes Secret containing connection details and credentials for the service represented by the ServiceInstance. Such Secrets can be used like any other-- mounted into a container's file system or injected into a container as environment variables.

These concepts and resources are the building blocks of the service catalog.

Installation

Service Catalog installs into a Kubernetes cluster and runs behind the Kubernetes API Aggregator.

Kubernetes 1.7 and Above

We strongly recommend that you run Service Catalog on Kubernetes version 1.7 or higher. Running on 1.6 works, but with so many compromises required that it is not officially supported.