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

Update minikube documentation and dev tooling to 1.12 #895

Merged
merged 2 commits into from
Jul 11, 2019
Merged
Show file tree
Hide file tree
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
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