Skip to content
Browse files

Update minikube documentation and dev tooling to 1.12. (#895)

  • Loading branch information...
roberthbailey authored and markmandel committed Jul 11, 2019
1 parent 46a9383 commit ebc32a2e91e443b216195f01903e07f8752abb57
@@ -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) \
$(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; \
# 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

@@ -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.

# 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 %}}
@@ -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]( of your choice.

{{% feature expiryVersion="0.12.0" %}}
minikube start --kubernetes-version v1.11.0 --vm-driver virtualbox \

Continue to [Enabling creation of RBAC resources](#enabling-creation-of-rbac-resources)
{{% /feature %}}
{{% feature publishversion="0.12.0" %}}
minikube start --kubernetes-version v1.12.10 --vm-driver virtualbox
{{% /feature %}}

## Setting up an Amazon Web Services EKS cluster

@@ -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.
@@ -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

0 comments on commit ebc32a2

Please sign in to comment.
You can’t perform that action at this time.