Skip to content
This repository was archived by the owner on May 6, 2022. It is now read-only.

Commit

Permalink
Update documentation (v0.2) (#2693)
Browse files Browse the repository at this point in the history
  • Loading branch information
adamwalach authored and mszostok committed Aug 26, 2019
1 parent 309ba89 commit c654175
Show file tree
Hide file tree
Showing 4 changed files with 19 additions and 25 deletions.
2 changes: 1 addition & 1 deletion docs/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ Catalog API server to get the list of `ClusterServiceBroker` resources.

The current version of all Service Catalog API resources is `v1beta1`.
You can see the structure of each resource in detail at
[`pkg/apis/servicecatalog/v1beta1/types.go`](https://github.com/kubernetes-sigs/service-catalog/blob/master/pkg/apis/servicecatalog/v1beta1/types.go).
[`pkg/apis/servicecatalog/v1beta1/types.go`](https://github.com/kubernetes-sigs/service-catalog/blob/v0.2/pkg/apis/servicecatalog/v1beta1/types.go).

### Controller

Expand Down
4 changes: 2 additions & 2 deletions docs/devguide.md
Original file line number Diff line number Diff line change
Expand Up @@ -345,7 +345,7 @@ functionality or introduce instability. See [FeatureGates](feature-gates.md)
for more details.

When adding a FeatureGate to Helm charts, define the variable
`fooEnabled` with a value of `false` in [values.yaml](https://github.com/kubernetes-sigs/service-catalog/blob/master/charts/catalog-v0.2/values.yaml). In the [API Server](https://github.com/kubernetes-sigs/service-catalog/blob/master/charts/catalog-v0.2/templates/apiserver-deployment.yaml) and [Controller](https://github.com/kubernetes-sigs/service-catalog/blob/master/charts/catalog-v0.2/templates/controller-manager-deployment.yaml)
`fooEnabled` with a value of `false` in [values.yaml](https://github.com/kubernetes-sigs/service-catalog/blob/v0.2/charts/catalog-v0.2/values.yaml). In the [API Server](https://github.com/kubernetes-sigs/service-catalog/blob/v0.2/charts/catalog-v0.2/templates/apiserver-deployment.yaml) and [Controller](https://github.com/kubernetes-sigs/service-catalog/blob/v0.2/charts/catalog-v0.2/templates/controller-manager-deployment.yaml)
templates, add the new FeatureGate:
{% raw %}
```yaml
Expand All @@ -355,7 +355,7 @@ templates, add the new FeatureGate:
{% endraw %}
When the feature has had enough testing and the community agrees to change the
default to true, update [features.go](https://github.com/kubernetes-sigs/service-catalog/blob/master/pkg/features/features.go) and `values.yaml` changing the default for
default to true, update [features.go](https://github.com/kubernetes-sigs/service-catalog/blob/v0.2/pkg/features/features.go) and `values.yaml` changing the default for
feature foo to `true`. And lastly update the appropriate information in the
[FeatureGates doc](feature-gates.md).

Expand Down
36 changes: 15 additions & 21 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,9 @@ helm search service-catalog
You should see the following output:

```console
NAME VERSION DESCRIPTION
svc-cat/catalog x,y.z service-catalog API server and controller-manag...
NAME VERSION DESCRIPTION
svc-cat-kyma/catalog 0.3.X service-catalog
svc-cat-kyma/catalog-v0.2 0.2.X service-catalog API server ...
```

## RBAC
Expand Down Expand Up @@ -167,7 +168,7 @@ Now that your cluster and Helm are configured properly, installing
Service Catalog is simple:

```console
helm install svc-cat/catalog \
helm install svc-cat/catalog-v0.2 \
--name catalog --namespace catalog
```

Expand All @@ -177,26 +178,19 @@ Follow the appropriate instructions for your operating system to install svcat.
can be used by itself, or as a kubectl plugin.

The snippets below install the latest version of svcat. We also publish binaries for
our canary (master) builds, and tags using the following prefixes:
our canary (v0.2) builds, and tags using the following prefixes:

* Latest release: https://download.svcat.sh/cli/latest
* Latest release: https://download.svcat.sh/cli/latest-v0.2
* Tagged releases: https://download.svcat.sh/cli/VERSION
where `VERSION` is the release, for example `v0.1.20`.
* Canary builds: https://download.svcat.sh/cli/canary
where `VERSION` is the release, for example `v0.2.3`.
* Canary builds: https://download.svcat.sh/cli/canary-v0.2
* Previous canary builds: https://download.svcat.sh/cli/VERSION-GITDESCRIBE
where `GITDESCRIBE` is the result of calling `git describe --tags`, for example `v0.1.20-1-g203c8ad`.

## MacOS with Homebrew

```
brew update
brew install kubernetes-service-catalog-client
```
where `GITDESCRIBE` is the result of calling `git describe --tags`, for example `v0.2.3-1-g203c8ad`.

## MacOS

```
curl -sLO https://download.svcat.sh/cli/latest/darwin/amd64/svcat
curl -sLO https://download.svcat.sh/cli/latest-v0.2/darwin/amd64/svcat
chmod +x ./svcat
mv ./svcat /usr/local/bin/
svcat version --client
Expand All @@ -205,7 +199,7 @@ svcat version --client
## Linux

```
curl -sLO https://download.svcat.sh/cli/latest/linux/amd64/svcat
curl -sLO https://download.svcat.sh/cli/latest-v0.2/linux/amd64/svcat
chmod +x ./svcat
mv ./svcat /usr/local/bin/
svcat version --client
Expand All @@ -217,7 +211,7 @@ The PowerShell snippet below adds a directory to your PATH for the current sessi
You will need to find a permanent location for it and add it to your PATH.

```
iwr 'https://download.svcat.sh/cli/latest/windows/amd64/svcat.exe' -UseBasicParsing -OutFile svcat.exe
iwr 'https://download.svcat.sh/cli/latest-v0.2/windows/amd64/svcat.exe' -UseBasicParsing -OutFile svcat.exe
mkdir -f ~\bin
Move-Item -Path svcat.exe -Destination ~\bin
$env:PATH += ";${pwd}\bin"
Expand All @@ -226,9 +220,9 @@ svcat version --client

## Manual
1. Download the appropriate binary for your operating system:
* macOS: https://download.svcat.sh/cli/latest/darwin/amd64/svcat
* Windows: https://download.svcat.sh/cli/latest/windows/amd64/svcat.exe
* Linux: https://download.svcat.sh/cli/latest/linux/amd64/svcat
* macOS: https://download.svcat.sh/cli/latest-v0.2/darwin/amd64/svcat
* Windows: https://download.svcat.sh/cli/latest-v0.2/windows/amd64/svcat.exe
* Linux: https://download.svcat.sh/cli/latest-v0.2/linux/amd64/svcat
1. Make the binary executable.
1. Move the binary to a directory on your PATH.

Expand Down
2 changes: 1 addition & 1 deletion docs/resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ The Service Catalog resource model specifies all the behaviors that
Service Catalog supports. This document details each resource.

All of these resources are also defined in Go code at
[`pkg/apis/servicecatalog/v1beta1/types.go`](https://github.com/kubernetes-sigs/service-catalog/blob/master/pkg/apis/servicecatalog/v1beta1/types.go).
[`pkg/apis/servicecatalog/v1beta1/types.go`](https://github.com/kubernetes-sigs/service-catalog/blob/v0.2/pkg/apis/servicecatalog/v1beta1/types.go).


## Service Brokers
Expand Down

0 comments on commit c654175

Please sign in to comment.