test: add mysql-schema sample (devservices)

README.md

@@ -4,7 +4,7 @@
 [![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
-See [samples](samples/README.md) to get quickly started using an example
+See [samples](samples) to get quickly started using an example
 
 ## [Documentation](https://quarkiverse.github.io/quarkiverse-docs/quarkus-operator-sdk/dev/index.html)
 

build-parent/pom.xml

@@ -18,6 +18,7 @@
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <quarkus.version>2.7.1.Final</quarkus.version>
+    <surefire-plugin.version>3.0.0-M5</surefire-plugin.version>
   </properties>
   <dependencyManagement>
     <dependencies>
@@ -52,6 +53,10 @@
           <artifactId>maven-compiler-plugin</artifactId>
           <version>${compiler-plugin.version}</version>
         </plugin>
+        <plugin>
+          <artifactId>maven-surefire-plugin</artifactId>
+          <version>${surefire-plugin.version}</version>
+        </plugin>
       </plugins>
     </pluginManagement>
   </build>

samples/joke/pom.xml

@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <parent>
+    <artifactId>sample-operators</artifactId>
+    <groupId>io.quarkiverse.operatorsdk</groupId>
+    <version>3.0.4-SNAPSHOT</version>
+  </parent>
+  <modelVersion>4.0.0</modelVersion>
+
+  <artifactId>joke</artifactId>
+  <name>Quarkus - Operator SDK - Samples - Joke</name>
+  <packaging>jar</packaging>
+
+  <properties>
+    <maven.compiler.parameters>true</maven.compiler.parameters>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>io.quarkiverse.operatorsdk</groupId>
+      <artifactId>quarkus-operator-sdk</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkiverse.operatorsdk</groupId>
+      <artifactId>quarkus-operator-sdk-csv-generator</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-resteasy-reactive-jackson</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-rest-client-reactive-jackson</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-openshift</artifactId>
+    </dependency>
+    <!--  This dependency is needed only to ensure proper building order so that this module is build after the CSV extension -->
+    <dependency>
+      <groupId>io.quarkiverse.operatorsdk</groupId>
+      <artifactId>quarkus-operator-sdk-csv-generator-deployment</artifactId>
+      <scope>provided</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-junit5</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-junit5-mockito</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-test-kubernetes-client</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.awaitility</groupId>
+      <artifactId>awaitility</artifactId>
+      <version>4.1.1</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>io.quarkus</groupId>
+        <artifactId>quarkus-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <goals>
+              <goal>build</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+
+  <profiles>
+    <profile>
+      <id>native</id>
+      <properties>
+        <quarkus.package.type>native</quarkus.package.type>
+      </properties>
+    </profile>
+  </profiles>
+</project>

samples/mysql-schema/README.md

@@ -0,0 +1,57 @@
+# MySQL Schema Operator
+
+This example shows how an operator can control resources outside of the Kubernetes cluster. In this case it will be
+managing MySQL schemas in an existing database server. This is a common scenario in many organizations where developers
+need to create schemas for different applications and environments, but the database server itself is managed by a 
+different team. Using this operator a dev team can create a CR in their namespace and have a schema provisioned automatically.
+Access to the MySQL server is configured in the configuration of the operator, so admin access is restricted. 
+
+This is an example input:
+```yaml
+apiVersion: "mysql.sample.javaoperatorsdk/v1"
+kind: MySQLSchema
+metadata:
+  name: mydb
+spec:
+  encoding: utf8
+```
+
+Creating this custom resource will prompt the operator to create a schema named `mydb` in the MySQL server and update
+the resource status with its URL. Once the resource is deleted, the operator will delete the schema. Obviously don't
+use it as is with real databases. 
+
+### Quick start
+
+To quickly test your operator (and develop it), no need to create an image and deploy it to the
+cluster. You can just follow the steps below to get started quickly:
+
+- Connect to your cluster of choice using `kubectl/oc`, select the appropriate namespace/project.
+  The operator will automatically connect to that cluster/namespace combination when started.
+- Run `mvn install` on the parent directory to build the project locally.
+- Run `mvn package` to build the operator. This will automatically generate several resources for
+  you, in particular the CRDs associated with the custom resources we will be dealing with. These
+  CRDs are generated in `target/kubernetes`.
+- Deploy the CRDs to your cluster (requires cluster admin privileges, while this shouldn't be an
+  issue for most "testing" clusters such as `minikube` or `kind`, you might need to log in to your
+  OpenShift clusters with an admin account):
+  ```sh
+  kubectl apply -f target/kubernetes/mysqlschemas.mysql.sample.javaoperatorsdk-v1.yml
+  ```           
+- If you look at the application.properties, you will notice this is where the access to the MySQL server is configured.
+  In dev mode, such a server is provided by [Quarkus DevService](https://quarkus.io/guides/dev-services).
+- Launch the app in dev mode: `mvn quarkus:dev`
+- Deploy the test schema (or your own): `kubectl apply -f src/main/resources/mydb.yml`
+- The operator will take your request and attempt to create the schema. If everything
+  went well, a database and user will be created on your mysql server.
+- Clean up the database server by deleting the schema : `kubectl delete -f src/main/resources/mydb.yml`
+
+### Cluster deployment
+
+The extension is configured with the Quarkus [Kubernetes](https://quarkus.io/guides/deploying-to-kubernetes) and [Jib container image](https://quarkus.io/guides/container-image#jib) extensions so it
+automatically generates deployment descriptors and image to deploy your operator on your cluster.
+These files are found in their regular spots (`target/kubernetes` for the descriptors).
+
+### Native binary
+
+To build a native binary for your platform, just run: `mvn package -Pnative`. The binary will be
+found in the `target` directory.

samples/mysql-schema/pom.xml

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>io.quarkiverse.operatorsdk</groupId>
+    <artifactId>sample-operators</artifactId>
+    <version>3.0.4-SNAPSHOT</version>
+  </parent>
+  <artifactId>mysql-schema</artifactId>
+  <name>Quarkus - Operator SDK - Samples - MySQL Schema</name>
+  <description>Provisions Schemas in a MySQL database</description>
+  <properties>
+    <maven.compiler.parameters>true</maven.compiler.parameters>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>io.quarkiverse.operatorsdk</groupId>
+      <artifactId>quarkus-operator-sdk</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkiverse.operatorsdk</groupId>
+      <artifactId>quarkus-operator-sdk-csv-generator</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-openshift</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-container-image-jib</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>org.apache.commons</groupId>
+      <artifactId>commons-lang3</artifactId>
+      <version>3.12.0</version>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkiverse.operatorsdk</groupId>
+      <artifactId>quarkus-operator-sdk-csv-generator-deployment</artifactId>
+      <scope>provided</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-agroal</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-jdbc-mysql</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-junit5</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-junit5-mockito</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.quarkus</groupId>
+      <artifactId>quarkus-test-kubernetes-client</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.awaitility</groupId>
+      <artifactId>awaitility</artifactId>
+      <version>4.1.1</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>io.quarkus</groupId>
+        <artifactId>quarkus-maven-plugin</artifactId>
+        <executions>
+          <execution>
+            <goals>
+              <goal>build</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+
+  <profiles>
+    <profile>
+      <id>native</id>
+      <properties>
+        <quarkus.package.type>native</quarkus.package.type>
+      </properties>
+    </profile>
+  </profiles>
+</project>

samples/mysql-schema/src/main/java/io/quarkiverse/operatorsdk/samples/mysqlschema/MySQLSchema.java

@@ -0,0 +1,11 @@
+package io.quarkiverse.operatorsdk.samples.mysqlschema;
+
+import io.fabric8.kubernetes.api.model.Namespaced;
+import io.fabric8.kubernetes.client.CustomResource;
+import io.fabric8.kubernetes.model.annotation.Group;
+import io.fabric8.kubernetes.model.annotation.Version;
+
+@Group("mysql.sample.javaoperatorsdk")
+@Version("v1")
+public class MySQLSchema extends CustomResource<SchemaSpec, SchemaStatus> implements Namespaced {
+}