doc/install/arvados-on-kubernetes-GKE.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: installguide
   4 title: Arvados on Kubernetes - Google Kubernetes Engine
   5 ...
   6 {% comment %}
   7 Copyright (C) The Arvados Authors. All rights reserved.
   8
   9 SPDX-License-Identifier: CC-BY-SA-3.0
  10 {% endcomment %}
  11
  12 This page documents the setup of the prerequisites to run the "Arvados on Kubernetes":/install/arvados-on-kubernetes.html @Helm@ chart on @Google Kubernetes Engine@ (GKE).
  13
  14 h3. Install tooling
  15
  16 Install @gcloud@:
  17
  18 * Follow the instructions at "https://cloud.google.com/sdk/downloads":https://cloud.google.com/sdk/downloads
  19
  20 Install @kubectl@:
  21
  22 <pre>
  23 $ gcloud components install kubectl
  24 </pre>
  25
  26 Install @helm@:
  27
  28 * Follow the instructions at "https://docs.helm.sh/using_helm/#installing-helm":https://docs.helm.sh/using_helm/#installing-helm
  29
  30 h3. Boot the GKE cluster
  31
  32 This can be done via the "cloud console":https://console.cloud.google.com/kubernetes/ or via the command line:
  33
  34 <pre>
  35 $ gcloud container clusters create <CLUSTERNAME> --zone us-central1-a --machine-type n1-standard-2 --cluster-version 1.10
  36 </pre>
  37
  38 It takes a few minutes for the cluster to be initialized.
  39
  40 h3. Reserve a static IP
  41
  42 Reserve a "static IP":https://console.cloud.google.com/networking/addresses in GCE. Make sure the IP is in the same region as your GKE cluster, and is of the "Regional" type.
  43
  44 h3. Connect to the GKE cluster.
  45
  46 Via the web:
  47 * Click the "Connect" button next to your "GKE cluster"https://console.cloud.google.com/kubernetes/.
  48 * Execute the "Command-line access" command on your development machine.
  49
  50 Alternatively, use this command:
  51
  52 <pre>
  53 $ gcloud container clusters get-credentials <CLUSTERNAME> --zone us-central1-a --project <YOUR-PROJECT>
  54 </pre>
  55
  56 Test the connection:
  57
  58 <pre>
  59 $ kubectl get nodes
  60 </pre>
  61
  62 Now proceed to the "Initialize helm on the Kubernetes cluster":/install/arvados-on-kubernetes.html#helm section.