Skip to content

Using EKC

Getting started

  1. Register and log in to ICE Connect.
  2. Go to the ICE Connect Rancher web interface and choose Log In with Keycloak.

Launching apps

Click on the icekube cluster (left red circle), and open your project, here johank.

Select project

Click on Apps -> Launch, then follow the instructions for each app. When you launch an app you are required to create a Namespace.

Start app

Projects and namespaces

One project can contain many namespaces which are groups of apps, containers, volumes, and other resources.

When you create a namespace, you need to use your project name as a prefix.

You also have to set the namespace quotas. The sum of all namespace quotas cannot exceed the project quota.

Namespace names,

  1. Must begin with the username, e.g. johank-mynamespace
  2. Can only contain alphanumerics and dashes -
  3. Cannot be empty

Add namespace

Managing quotas

Your project is limited in computational resources and storage capacity, managed by Kubernetes Resource Quotas. You can view limits when clicking Add Namespace in Rancher.

Rancher quota

If you launch multiple apps and use different namespaces for some, you may have to adjust their Resource Quotas.

CPU resources are measured in milli-CPUs, where for example 500m is one-half CPU core of reserved performance.

Some apps and charts do not define requests and limits for resource usage. In this case, you can set it using Container Default Resource Limit.

Credentials file

The ~/.kube/config YAML file tells local applications such as kubectl and Visual Studio Code how to access the Kubernetes cluster icekube.

  1. In Rancher, click on Cluster Name icekube
  2. Click on the Kubeconfig File button.
  3. Copy and paste the contents to ~/.kube/config
  4. Set permissions chmod 600 ~/.kube/config

kube config

Connecting with SSH

You can connect to any Kubernetes app/container that has an SSH server through a randomized NodePort. After starting an app, for example, Jupyter Node, find the NodePort to connect to.

NodePort in Rancher

Connect from a terminal with

ssh -p 30423

Visual Studio Code

Kubernetes Tools

Visual Studio Code can be used for many of the same functions as Rancher

  1. Install Visual Studio Code Kubernetes Tools extension.
  2. You should see icekube listed among clusters. If not, Set Kubeconfig to ~/.kube/config.
  3. Open Command Palette (Ctrl+Shift+P) and choose Kubernetes: Use namespace.

This will give you among other things

  • Log, debug, delete containers, and view the YAML specification.
  • Read Secrets and Config Maps.
  • Native Terminal for container shell access.
  • Attach Visual Studio Code to a Kubernetes container.


Connect to containers over SSH NodePort using the Visual Studio Code extension Remote - SSH, to develop and compile code directly inside a container.

Open the Command Palette (Ctrl+Shift+P) and choose Remote SSH: Connect to Host... then e.g.

Last update: 2023-04-09
Created: 2022-12-22