.. _ansible-kubernetes:

Installing kubernetes for a demo installation (on a single virtual machine)
============================================================================


How to set up your hosts.ini file
-------------------------------------

Assuming a single virtual machine with a public IP address running Ubuntu 18.04, with at least 5 CPU cores and at least 8 GB of memory.

Move to ``wire-server-deploy/ansible``:

.. code:: shell

  cd ansible/

Then:

.. code:: shell

  cp inventory/demo/hosts.example.ini inventory/demo/hosts.ini

Open hosts.ini and replace `X.X.X.X` with the IP address of your virtual machine that you use for ssh access.  You can try using: 

.. code:: shell

  sed -i 's/X.X.X.X/1.2.3.4/g' inventory/demo/hosts.ini


How to install kubernetes
--------------------------

From ``wire-server-deploy/ansible``::

   ansible-playbook -i inventory/demo/hosts.ini kubernetes.yml -vv

When the playbook finishes correctly (which can take up to 20 minutes), you should have a folder ``artifacts`` containing a file ``admin.conf``. Copy this file::

  mkdir -p ~/.kube
  cp artifacts/admin.conf ~/.kube/config
  KUBECONFIG=~/.kube/config

Make sure you can reach the server::

  kubectl version

should give output similar to this::

  Client Version: version.Info{Major:"1", Minor:"14", GitVersion:"v1.14.2", GitCommit:"66049e3b21efe110454d67df4fa62b08ea79a19b", GitTreeState:"clean", BuildDate:"2019-05-16T16:23:09Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}
  Server Version: version.Info{Major:"1", Minor:"14", GitVersion:"v1.14.2", GitCommit:"66049e3b21efe110454d67df4fa62b08ea79a19b", GitTreeState:"clean", BuildDate:"2019-05-16T16:14:56Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}