Illumio Install, Configure, and Upgrade Guide 24.2.20

Log into the PCE as a user with Global Organization Owner privileges.

From the PCE web console menu, choose Infrastructure > Container Clusters.

Click Add.

1. Enter a Name.

2. Save the Container Cluster.

You will see a summary page of the new Container Cluster. Copy the values of the Cluster ID and Cluster Token found under the Cluster Pairing Token section.

Once you have the values, you can exit the Container Cluster page.

ssh to the master node.

Open the kubelink secret YAML file and modify the stringData.

1. ilo_server = the PCE URL and port. Example: https://mypce.example.com:8443

2. ilo_cluster_uuid = Cluster ID value from previous step. Example: dc1ecbf9-f481-44a7-a4b7-fb028b1b4ece

3. ilo_cluster_token = Cluster Token from previous step. Example: 1_d37ea3dcd34ae8ae2a78fb33f4e159cc4003e95cc4babe0d992062127a21dab4

4. ignore_cert = SSL verification. The value is boolean and is recommended to be set to false so that Kubelink requires PCE certificate verification. Example: 'false'

5. log_level = Log level where '0' for debug, '1' for info, '2' for warn, or '3' for error. Example: '1'

SSL Verification

Illumio does not recommend turning off SSL verification (ignore_cert: 'true'); however, this is an option for deployments in which the PCE uses a self-signed certificate.

Contents of a modified illumio-kubelink-secret.yml file are shown below.

#
# Copyright 2013-2020 Illumio, Inc. All Rights Reserved.
#
 
apiVersion: v2
kind: Secret
metadata:
  name: illumio-kubelink-config
  namespace: kube-system
type: Opaque
stringData:
  ilo_server: https://mypce.example.com:8443 # Example: https://mypce.example.com:8443
  ilo_cluster_uuid: dc1ecbf9-f481-44a7-a4b7-fb028b1b4ece # Example: cc4997c1-408b-4f1d-a72b-91495c24c6a0
  ilo_cluster_token: 1_d37ea3dcd34ae8ae2a78fb33f4e159cc4003e95cc4babe0d992062127a21dab4 # Example: 170b8aa3dd6d8aa3c284e9ea016e8653f7b51cb4b0431d8cbdba11508763f3a3
  ignore_cert: 'false' # Set to 'true' to ignore the PCE certificate
  log_level: '1' # Default log level is info

Save the changes.

Create the Kubelink secret using the file.

oc create -f illumio-kubelink-secret.yml

Edit the Kubelink configuration YAML file. For OpenShift clusters, the file name will be illumio-kubelink-openshift.yml.

1. Inside the YAML you will find the spec: > template: > spec: > containers: section. Paste the image link in the image: attribute. The string should be wrapped in single quotes as shown in the example below.

Save the changes.

Below is a snippet from an example of the Kubelink configuration for OpenShift to illustrate the image location.

apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: illumio-kubelink
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      app: illumio-kubelink
  template:
    metadata:
      labels:
        app: illumio-kubelink
    spec:
#      nodeSelector:
#        node-role.kubernetes.io/master: ""
      serviceAccountName: illumio-kubelink
      tolerations:
      - key: node-role.kubernetes.io/master
        effect: NoSchedule
      containers:
      - name: illumio-kubelink
        image: 'registry.example.com:443/illumio/illumio-kubelink:<version#>'
        imagePullPolicy: Always
        env:
          - name: ILO_SERVER
            valueFrom:
              secretKeyRef:
                name: illumio-kubelink-config
                key: ilo_server

(Optional) If you're using a private PKI to sign the PCE certificate, make sure you add the references to the root CA certificate that signed the PCE certificate. For more details, see Implement Kubelink with a Private PKI.

To deploy Kubelink, run the following command:

oc apply -f illumio-kubelink-openshift.yml