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.