Contents

Using Harbor with the VMware Event Broker Appliance

The vCenter Event Broker Appliance (VEBA) is still one of my favorite open source projects these days and it is evolving rapidly and continuously through the great work of the two main contributors Michael Gasch and William Lam as well as through the valuable feedback from the community. I´m very proud to be part of the “inner circle” of folks who meet on a regular basis to discuss everything #VEBA and the keyword here is also feedback.

Version 0.3 was recently with big updates announced which can be viewed via the following link: Big updates to the vCenter Event Broker Appliance (VEBA) Fling

Just to name a few updates:

  • VMware Event Router implementation
  • AWS EventBridge support
  • New event playload structure - cloudevents.io

Pulling images from Harbor fails

I was still testing the new version in my lab but this time I wanted to add another great open source project as a playmate to the round, the enterprise container image registry Harbor. VEBA ist using OpenFaaS® as the built-in event processor and you define the function configuration in a YAML file, the stack.yml.

/img/posts/202003_veba_harbor/CapturFiles-20200323_120502.jpg
Figure I: Original repository, image name and tag

A closer look into the stack.yml file shows us that the official VMware repository is used. We only see the repository name vmware/, the image name veba-powercli-tagging as well as the tag :latest. This means that when no registry is configured at this point, the Docker default applies, which is then Docker Hub.

Instead of pulling the appropriate image(s) from Docker Hub, I wanted to use Harbor this time. In order to implement this, I have to replace the original image specification in the stack.yml and point to my Harbor instance, the corresponding project and the image with tag.

/img/posts/202003_veba_harbor/CapturFiles-20200323_120429.jpg
Figure II: Modified repository, image name and tag

Create a project in Harbor

Before we continue with the deployment of a function and what I´ve observed when VEBA is trying to pull the images from Harbor, I´d like to give you a short intoduction “How to create a project in Harbor”.

  1. Login with admin, select Projects and give it a name.
/img/posts/202003_veba_harbor/CapturFiles-20200323_113744.jpg
Figure III: New project
  1. Go to Members and add a new User to the project.
/img/posts/202003_veba_harbor/CapturFiles-20200323_113818.jpg
Figure IV: Add a user
  1. The last step for now is to mark the project as Public so it is accessible to everyone and no docker login is required before. I also enable the Automatically scan image on push option, to let Clair immediately scan images when they are pushed.
/img/posts/202003_veba_harbor/CapturFiles-20200322_061632.jpg
Figure V: Project configuration page

Optional: Authentiction with LDAP

The following settings are not required but I wanted to authenticate Active-Directory users and groups to my project(s). I think it could be helpful to see a working configuration.

/img/posts/202003_veba_harbor/CapturFiles-20200323_044947.jpg
Figure VI: Harbor LDAP Authentication configuration

If everything is configured correctly, you should be able to add one or more AD groups to your project.

/img/posts/202003_veba_harbor/CapturFiles-20200323_044925.jpg
Figure VII: Harbor LDAP Authentication configuration

Push an image to Harbor

For this demonstration I´m going to pick the vSphere Tagging Function example. Let´s create the veba-powercli-tagging image from the Dockerfile which is located in the following directory: vcenter-event-broker-appliance/examples/powercli/tagging/template/powercli/.

We can build, tag and push the image in two ways:

The Docker way - docker cli

Change into the directory were the Dockerfile is located, create a fresh new image out of it and directly assign it with a tag subsequently:

1
2
3
4
5
6
7
cd ~/vcenter-event-broker-appliance/examples/powercli/tagging/template/powercli/

docker build -t harbor.jarvis.lab/veba/veba-powercli-tagging:latest .

docker images
REPOSITORY                                     TAG                 IMAGE ID            CREATED             SIZE
harbor.jarvis.lab/veba/veba-powercli-tagging   latest              ab7d0277d326        15 seconds ago      368MB

Login into Harbor with an assigned user or a user of an assigned group:

1
docker login -u rguske harbor.jarvis.lab/veba

After a successful login, push the image to your project:

1
docker push harbor.jarvis.lab/veba/veba-powercli-tagging:latest

The OpenFaaS way - faas-cli

The use of the faas-cli makes the above described steps a little bit more comfortable and by the end, the faas-cli is using the native docker commands as well. To build as well as to tag the image, we just need to execute faas-cli build -f stack.yml. This command will pick the image specification from the stack.yml and will hand it over automatically.

Same result here:

1
2
REPOSITORY                                     TAG                 IMAGE ID            CREATED             SIZE
harbor.jarvis.lab/veba/veba-powercli-tagging   latest              3520bc9c8b85        32 seconds ago      368MB

You still need to login to Harbor if you want to execute the push command, otherwise you will receive the following error:

1
2
3
4
denied: requested access to the resource is denied
unauthorized: authentication required

2020/03/23 17:48:45 ERROR - Could not execute command: [docker push harbor.jarvis.lab/veba/veba-powercli-tagging:latest]

Login and execute faas-cli push -f stack.yml. The image will be pushed into your project.

/img/posts/202003_veba_harbor/CapturFiles-20200323_031023.jpg
Figure VIII: Pushed image to the new project

Deploy a function to VEBA

I don´t need to stress this topic in detail here because everything you need to be ready for take off 🚀 with VEBA is well documented on the Github page and if you miss something or need a more comprehensive insight on VEBA, visit this blog series by Patrick Kraemer. Assuming the corresponding image is available in Harbor and the stack.yml is adapted accordingly (see Figure II), you can proceed with the steps provided on Github (LINK). Update the stack.yml and the vc-tag-config.json with your environment information.

I´m curious and therefore I established a ssh connection to my VEBA appliance. By executing kubectl -n openfaas-fn get pods, I can see how the deployment of the pod runs and the following is not what we want to see as a result:

1
2
3
4
5
NAME                            READY   STATUS             RESTARTS   AGE
powercli-tag-5ff88775fb-6g92k   0/1     ImagePullBackOff   0          28s

NAME                            READY   STATUS         RESTARTS   AGE
powercli-tag-5ff88775fb-6g92k   0/1     ErrImagePull   0          64s

I validated this behavior by executing docker images and observed that no image has been downloaded from Harbor. Troubleshooting often means, if an automatic process fails, go the manual way step by step. Consequently, the next step is to download the image manually.

1
2
docker pull harbor.jarvis.lab/veba/veba-powercli-tagging:latest
Error response from daemon: Get https://harbor.jarvis.lab/v2/: x509: certificate signed by unknown authority

Interesting!

Failure
“certificate signed by unknown authority”

This is not based on the fact that I have not done a docker login before, as this is not necessary since we have made our project publicly available.

Following the official Docker documentation, this behavior is expected: Verify repository client with certificates

In order to retrieve the needed certificate information you can simply run the following openssl command:

1
export REGISTRY=harbor.jarvis.tanzu
1
echo | openssl s_client -connect $REGISTRY:443 -showcerts

I´ve also created a little script which downloads the root certificate from Harbor, creates the relevant directories, puts the certificate into them and restarts the docker service.

You can download the script HERE and copy it via scp into your VEBA appliance.

1
scp ~/Downloads/docker_harbor_cert.sh root@veba030:/

Make it executable with chmod +x docker_harbor_cert.sh and run it. The other option without using scp is, to establish a ssh connection and to copy and execute the neccessary lines directly.

The script

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
#! /bin/bash

set -euo pipefail

# Ask for the Harbor FQDN
echo "Enter the FQDN (e.g. harbor.domain.com) of your Harbor registry:"

read REGISTRY

# Create folder for custom certificate as described in Docker docs https://docs.docker.com/engine/security/certificates/
mkdir -p /etc/docker/certs.d/$REGISTRY

# Download Registry Root Certificate
wget -O /etc/docker/certs.d/$REGISTRY/ca.crt https://$REGISTRY/api/v2.0/systeminfo/getcert --no-check-certificate

# Restart Docker service
systemctl restart docker

VEBA is now able to pull and run the image from Harbor.

1
2
3
4
kubectl -n openfaas-fn get pods

NAME                            READY   STATUS    RESTARTS   AGE
powercli-tag-5ff88775fb-wqqqf   1/1     Running   0          84s

Thanks for reading.