Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve formatting of Docker Desktop instructions #2669

Merged
merged 1 commit into from
May 21, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 27 additions & 11 deletions DEVELOPMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,25 +88,41 @@ configuring Kubernetes resources.

## Kubernetes cluster

Docker for Desktop using an edge version has been proven to work for both
developing and running Pipelines. The recommended configuration is:
The recommended configuration is:

- Kubernetes version 1.15 or later
- 4 vCPU nodes (`n1-standard-4`)
- Node autoscaling, up to 3 nodes
- API scopes for cloud-platform

To setup a cluster with Docker on Desktop:
### To setup a cluster with Docker Desktop:

To use minikube: `bash minikube start eval $(minikube docker-env)`
Docker Desktop using an edge version has been proven to work for both developing
and running Pipelines.

To use the Kubernetes that comes with Docker for Desktop: 1. First go into the
Docker For Desktop preferences. Under the resource tabs ensure that you have at
least 4 CPUs, 8.0 GiB Memory, and 1.0 GiB Swap. 1. Under the Kubernetes tab,
enable Kubernetes. 1. Click the Apply and Restart button to save the
preferences. 1. Switch the proper `kubectl` config context: `bash kubectl config
get-contexts # You should see docker-for-desktop in the previous command output
kubectl config use-context docker-for-desktop` To setup a cluster with GKE:
To use minikube:

```bash
minikube start eval $(minikube docker-env)`
```

To use the Kubernetes that comes with Docker Desktop:

1. First go into the Docker Desktop preferences. Under the resource tabs ensure
that you have at least 4 CPUs, 8.0 GiB Memory, and 1.0 GiB Swap.

1. Under the Kubernetes tab, enable Kubernetes.

1. Click the Apply and Restart button to save the preferences.

1. Switch the proper `kubectl` config context:

```bash
kubectl config get-contexts # You should see docker-for-desktop in the previous command output
kubectl config use-context docker-for-desktop
```

### To setup a cluster with GKE:

1. [Install required tools and setup GCP project](https://knative.dev/v0.12-docs/install/knative-with-gke/)
(You may find it useful to save the ID of the project in an environment
Expand Down