Skip to content

Commit

Permalink
Update minikube documentation and dev tooling to 1.12. (#895)
Browse files Browse the repository at this point in the history
  • Loading branch information
roberthbailey authored and markmandel committed Jul 11, 2019
1 parent 46a9383 commit ebc32a2
Show file tree
Hide file tree
Showing 3 changed files with 33 additions and 6 deletions.
7 changes: 1 addition & 6 deletions build/includes/minikube.mk
Original file line number Diff line number Diff line change
Expand Up @@ -27,18 +27,13 @@
# (defaults virtualbox for Linux and macOS, hyperv for windows) if you so desire.
minikube-test-cluster: DOCKER_RUN_ARGS+=--network=host -v $(minikube_cert_mount)
minikube-test-cluster: $(ensure-build-image) minikube-agones-profile
# localkube bootstrapper fixes issues with profiles
$(MINIKUBE) start --kubernetes-version v1.11.5 --vm-driver $(MINIKUBE_DRIVER) \
--extra-config=apiserver.authorization-mode=RBAC
$(MINIKUBE) start --kubernetes-version v1.12.10 --vm-driver $(MINIKUBE_DRIVER)
# wait until the master is up
until docker run --rm $(common_mounts) $(DOCKER_RUN_ARGS) $(build_tag) kubectl cluster-info; \
do \
echo "Waiting for cluster to start..."; \
sleep 1; \
done
# this is needed for kubernetes component to work correctly while RBAC is enabled
-docker run --rm $(common_mounts) $(DOCKER_RUN_ARGS) $(build_tag) \
kubectl create clusterrolebinding cluster-admin-binding --clusterrole=cluster-admin --serviceaccount=kube-system:default
$(MAKE) setup-test-cluster DOCKER_RUN_ARGS="$(DOCKER_RUN_ARGS)"
$(MAKE) minikube-post-start

Expand Down
23 changes: 23 additions & 0 deletions site/content/en/docs/Guides/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,34 @@ A quick one liner to do this:

Once this is done, you can `kubectl delete gs --all` and clean everything up (if it's not gone already).


## I'm getting Forbidden errors when trying to install Agones

{{% feature expiryVersion="0.12.0" %}}
Some troubleshooting steps:

1. Run `kubectl describe clusterrolebinding | grep cluster-admin-binding- -A10` and make sure your email is in there. This may be
_case sensitive_ so you may need to compare it to the case you used.
1. In the [GKE tutorial]({{< ref "/docs/Installation#enabling-creation-of-rbac-resources" >}}) `gcloud config get-value accounts`
will return a lowercase email address, so if you are using a CamelCase email, you may want to type that in manually.
{{% /feature %}}

{{% feature publishVersion="0.12.0" %}}
Ensure that you are running Kubernetes 1.12 or later, which does not require any special
clusterrolebindings to install Agones.

If you want to install Agones on an older version of Kubernetes, you need to create a
clusterrolebinding to add your identity as a cluster admin, e.g.

```bash
# Kubernetes Engine
kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user `gcloud config get-value account`
# Minikube
kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole=cluster-admin --serviceaccount=kube-system:default
```

On GKE, `gcloud config get-value accounts` will return a lowercase email address, so if
you are using a CamelCase email, you may need to type it in manually.
{{% /feature %}}
9 changes: 9 additions & 0 deletions site/content/en/docs/Installation/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,12 +202,19 @@ minikube profile agones
The following command starts a local minikube cluster via virtualbox - but this can be
replaced by a [vm-driver](https://github.com/kubernetes/minikube#requirements) of your choice.
{{% feature expiryVersion="0.12.0" %}}
```bash
minikube start --kubernetes-version v1.11.0 --vm-driver virtualbox \
--extra-config=apiserver.authorization-mode=RBAC
```
Continue to [Enabling creation of RBAC resources](#enabling-creation-of-rbac-resources)
{{% /feature %}}
{{% feature publishversion="0.12.0" %}}
```bash
minikube start --kubernetes-version v1.12.10 --vm-driver virtualbox
```
{{% /feature %}}
## Setting up an Amazon Web Services EKS cluster
Expand Down Expand Up @@ -301,6 +308,7 @@ Nodes in AKS don't get a Public IP by default. To assign a Public IP to a Node,
Continue to [Installing Agones](#installing-agones).
{{% feature expiryVersion="0.12.0" %}}
## Enabling creation of RBAC resources
To install Agones, a service account needs permission to create some special RBAC resource types.
Expand All @@ -313,6 +321,7 @@ kubectl create clusterrolebinding cluster-admin-binding \
kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole=cluster-admin --serviceaccount=kube-system:default
```
{{% /feature %}}
## Installing Agones
Expand Down

0 comments on commit ebc32a2

Please sign in to comment.