Add install instructions for various K8s vendors/distributions

[tirumaraiselvan]

Gitkube runs on most Kubernetes distributions/vendors as per the install instructions in README. But in some cases, there may be more configuration required to correctly setup for e.g. exposing the gitkubed service may require configuring a Loadbalancer manually.

We need to document the instructions (docs/install.md) covering various vendors like GKE, Rancher, kops based installations, etc. In most cases, the instructions should be default instructions as provided in the README and in other cases the additional steps should be mentioned.

Please use this issue to mention any distribution which is not covered by the installation instructions.

[adrianog]

Any particular word of advice for openshift?

[coco98]

@adrianog Well these are the commands that you would need to run on openshift? Do you foresee that they would run as is on an openshift kubernetes cluster?

kubectl create -f https://raw.githubusercontent.com/hasura/gitkube/master/manifests/gitkube-setup.yaml

This command will create k8s objects in the kube-system namespace.

$ kubectl --namespace kube-system expose deployment gitkubed --type=LoadBalancer --name=gitkubed

This command will expose the deployment on a public IP.

If you can do these 2 things, things should work for you. If you can try them out, please let us know if it works or doesn't and then we can add docs for how to on openshift!

[disha94]

Trying to setup gitkube with minikube, but while creating the remote, I am getting this error:
Error from server (Timeout): error when creating "remote.yaml": Timeout: request did not complete within allowed duration

[disha94]

Sorted, It was Kubernetes version issue.

[tirumaraiselvan]

@disha94 which version did you have the issue with and which issue fixed it for you? We have docs/minikube.md where we can mention this.

[disha94]

@tirumaraiselvan So I think it was from my side, gitkube support is only after v1.8.7 of kubernetes and I had a older version (1.8.0) in my minikube. Upgrading the kubernetes version in minikube fixed the problem.

[sunfmin]

In README

kubectl create -f https://storage.googleapis.com/gitkube/gitkube-setup-stable.yaml

https://storage.googleapis.com/gitkube/gitkube-setup-stable.yaml seems not accessible.

[arvi3411301]

@sunfmin https://storage.googleapis.com/gitkube/gitkube-setup-stable.yaml was not publicly accessible. I have added the correct permissions. Can you try again?

[sunfmin]

@arvi3411301 Yes it works. I tried gitkube successfully on my local Docker for desktop kubernetes. It works great.

[mandarku]

I am seeing these errors..

Error from server (BadRequest): error when creating "https://storage.googleapis.com/gitkube/gitkube-setup-stable.yaml": ClusterRoleBinding in version "v1" cannot be handled as a ClusterRoleBinding: no kind "ClusterRoleBinding" is registered for version "rbac.authorization.k8s.io/v1"

unable to recognize "https://storage.googleapis.com/gitkube/gitkube-setup-stable.yaml": no matches for apiextensions.k8s.io/, Kind=CustomResourceDefinition

[tirumaraiselvan]

@mandarku Could you please specify additional details like which Kubernetes version, which provider (if any), etc. You may want to open a new issue just for this.