Merge ~athos-ribeiro/ubuntu-docker-images/+git/kafka:3.1-22.04-examples into ~ubuntu-docker-images/ubuntu-docker-images/+git/kafka:3.1-22.04

[Athos Ribeiro]

Following the pattern of the other OCI images, this MP introduces the docker-compose and the k8s examples on using the new Kafka OCI.

[Sergio Durigan Junior (sergiodj)]

Thanks for the MP, Athos.

LGTM, +1.

review: Approve

[Athos Ribeiro (athos-ribeiro)]

Thanks, Sergio.

Merged

diff --git a/examples/README.md b/examples/README.md
 new file mode 100644
index 0000000..0ea1490
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,55 @@
+# Running the examples
+
+## docker-compose
+
+Install `docker-compose` from the Ubuntu archive:
+
+```
+$ sudo apt install -y docker-compose
+```
+
+Call `docker-compose` from the examples directory:
+
+```
+$ docker-compose up -d
+```
+
+You can now access your service on the network used by your docker-compose
+setup. The default should be `$DIRNAME_default`. If you are in the `examples`
+directory, you could use this service with:
+
+```
+docker run  --rm -it \
+  --network=examples_default \
+  ubuntu/kafka:edge \
+  SOME_KAFKA_BINARY_AND_OPTIONS
+```
+
+and use `kafka:9092` as your kafka server parameter.
+
+To stop `docker-compose`, run:
+
+```
+$ docker-compose down
+```
+
+# Microk8s
+
+Install microk8s from snap:
+
+```
+$ snap install microk8s --classic
+```
+
+Apply the `kafka-deployment.yml`:
+
+```
+$ microk8s kubectl apply -f kafka-deployment.yml
+```
+
+You can now try your Kafka setup within microk8s. For instance, you could
+use some of the Kafka shipped binaries with
+
+`microk8s kubectl run -it --rm  kafka-client --restart=Never --image ubuntu/kafka:edge -- SOME_KAFKA_BINARY_AND_OPTIONS`
+
+and use `kafka-service:9092` as your kafka server parameter.
diff --git a/examples/docker-compose.yml b/examples/docker-compose.yml
 new file mode 100644
index 0000000..2ff529b
--- /dev/null
+++ b/examples/docker-compose.yml
@@ -0,0 +1,15 @@
+version: '2'
+
+services:
+  kafka:
+    image: ubuntu/kafka:edge
+    command: kafka-server-start.sh /etc/kafka/server.properties --override zookeeper.connect=zookeeper:2181
+    ports:
+      - '9092:9092'
+    depends_on:
+      - zookeeper
+  zookeeper:
+    image: ubuntu/kafka:edge
+    command: zookeeper-server-start.sh /etc/kafka/zookeeper.properties
+    ports:
+      - '2181:2181'
diff --git a/examples/kafka-deployment.yml b/examples/kafka-deployment.yml
 new file mode 100644
index 0000000..44dc71b
--- /dev/null
+++ b/examples/kafka-deployment.yml
@@ -0,0 +1,70 @@
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: kafka-service
+  labels:
+    app: kafka
+spec:
+  ports:
+  - port: 9092
+  selector:
+    app: kafka
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: kafka-deployment
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: kafka
+  template:
+    metadata:
+      labels:
+        app: kafka
+    spec:
+      containers:
+      - name: kafka
+        image: ubuntu/kafka:edge
+        args: ["kafka-server-start.sh", "/etc/kafka/server.properties", "--override", "zookeeper.connect=zookeeper-service:2181", "--override", "advertised.listeners=PLAINTEXT://kafka-service:9092"]
+        ports:
+        - containerPort: 9092
+          name: kafka
+          protocol: TCP
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: zookeeper-service
+  labels:
+    app: zookeeper
+spec:
+  ports:
+  - port: 2181
+  selector:
+    app: zookeeper
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: zookeeper-deployment
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: zookeeper
+  template:
+    metadata:
+      labels:
+        app: zookeeper
+    spec:
+      containers:
+      - name: zookeeper
+        image: ubuntu/kafka:edge
+        args: ["zookeeper-server-start.sh", "/etc/kafka/zookeeper.properties"]
+        ports:
+        - containerPort: 2181
+          name: zookeeper
+          protocol: TCP