slogan-generator

This is a simple slogan text or image generator. I wanted to replace the one I used to have on my homepage, since it doesn't support https, and I also wanted the new Raspberry Pi k8s cluster that I've set up to have something to do. Also, it's my first day of vacation, so why not. :)

Using the slogan generator

The slogan generator is up and running at https://api.hirt.se/slogans. It is available and ready to use.

The api is described here:
https://api.hirt.se/slogans/swagger-ui/

Or in openapi format here:
https://api.hirt.se/slogans/openapi/

Here's an example on how to get a simple slogan text for OpenJDK:
https://api.hirt.se/slogans/text?item=OpenJDK

Here is an example of how I use it on my homepage https://hirt.se:

<img src="https://api.hirt.se/slogans/image?item=JDK+Mission+Control&background=random&textColor=%23FFFFFF" border="0" width="460" height="50"/>

The slogan generator creates images like like these:

Here are some examples: https://api.hirt.se/slogans/test

Running the application in dev mode

You can run the application in dev mode that enables live coding using:

./mvnw compile quarkus:dev

Browse to localhost:8080/test to try it out.

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

Packaging and running the application

The application can be packaged using:

./mvnw package

It produces the quarkus-run.jar file in the target/quarkus-app/ directory.
Be aware that it’s not an über-jar as the dependencies are copied into the target/quarkus-app/lib/ directory.

The application is now runnable using java -jar target/quarkus-app/quarkus-run.jar.

If you want to build an über-jar, execute the following command:

./mvnw package -Dquarkus.package.jar.type=uber-jar

The application, packaged as an über-jar, is now runnable using java -jar target/*-runner.jar.

Creating a native executable

You can create a native executable using:

./mvnw package -Dnative

Or, if you don't have GraalVM installed, you can run the native executable build in a container using:

./mvnw package -Dnative -Dquarkus.native.container-build=true

You can then execute your native executable with: ./target/slogan-generator-(version)-SNAPSHOT-runner

Creating the docker image

You can create a docker image using:

mvnw clean package -Dquarkus.native.container-build=true -Dquarkus.container-image.build=true

To create one with a native image:

mvnw clean package -Pnative -Dquarkus.native.container-build=true -Dquarkus.container-image.build=true

Run the image using:

docker run -i --rm -p 8080:8080 greystone/slogan-generator:latest

Publishing images (for maintainers)

To create docker images for multiple platforms and push them to Docker hub:

./release.sh