Installation

Overview

How much of CSE you need to install varies on the user type and what part of CSE and Kubernetes you will interact with. Here’s a short table to help decide what to install.

User Type Task(s)
Kubernetes user Install kubectl on laptop or workstation
Org admin managing K8s clusters Install CSE and configure CSE client on laptop or VM
Cloud admin installing CSE in VCD Install CSE on server host

Naturally a cloud admin may install the CSE client to test cluster creation after CSE server setup. Similarly a tenant org administrator may install kubectl to check Kubernetes clusters or perform administrative tasks.

Install Kubectl

Install kubectl using directions from the Kubernetes web site.

Install CSE Software

Install python 3.7.3 or greater. Please note that python 3.8.0 and above is not supported. See python installation instructions and downloads at https://www.python.org or consult the vcd-cli install procedure. Pip, python’s package manager is present by default in every python installation.

Verify python and pip installation:

$ python3 --version
Python 3.7.4

$ pip3 --version
pip 19.2.3 from /usr/local/lib/python3.7/site-packages/pip (python 3.7)

Install and verify CSE:

$ pip3 install container-service-extension
...

$ cse version
CSE, Container Service Extension for VMware vCloud Director, version 2.5.0

Alternatively, a specific version of CSE can be installed from GitHub as follows:

> pip3 install git+https://github.com/vmware/container-service-extension.git@1.2.4

To discover available CSE source versions on GitHub see the following URL: https://github.com/vmware/container-service-extension/tags

Enable CSE Client

After initial installation of CSE, if you try running vcd cse commands, you’ll probably notice an error like the the following:

> vcd cse version
Error: No such command "cse".

This means that the CSE client is not enabled in vcd-cli. To enable CSE client in vcd-cli, edit ~/.vcd-cli/profiles.yaml to include the following (at the end of the file):

extensions:
- container_service_extension.client.cse

Save the file and try again. vcd cse commands should now work.