DEV Community: Thomas Gotwig

Add initial testing to Camunda with Spring Boot 🍃

Thomas Gotwig — Sun, 05 Dec 2021 17:59:01 +0000

Let's add a test to our application so that we don't have to confirm things like the User Task manually! As well as some assertions to know what got executed and what not.

Here you can find the code for this chapter under the git tag chapter-2.

For doing the assertions we need:

<dependency>
  <groupId>org.camunda.bpm.assert</groupId>
  <artifactId>camunda-bpm-assert</artifactId>
  <version>8.0.0</version>
  <scope>test</scope>
</dependency>

And there is our final happyPath test which goes through all we did from the last article automatically! 🤗

@SpringBootTest
class MainDelegateTest {

    @Autowired private RuntimeService runtimeService;

    @Autowired private ManagementService managementService;

    ProcessInstance pi;

    @BeforeEach
    public void beforeEach() {
        pi = runtimeService.startProcessInstanceByKey(
                "loanApproval");
        assertThat(pi).hasPassed("StartEvent_1")
                .hasNotPassed("Task_0dfv74n")
                .isNotEnded();
    }

    @Test
    public void happyPath() {
        completeTask().hasPassed("Task_0dfv74n").isEnded();
    }

    private ProcessInstanceAssert completeTask() {
        complete(task());
        return assertThat(pi);
    }
}

loanApproval is from loanApproval.bpmn which you can find inside the Camunda Modeler when nothing is selected 🖼️

complete(task()) are two static functions which are doing the clicking on Complete part from the last article for you 🤖

Getting Started with Camunda & Spring Boot 🍃

Thomas Gotwig — Sat, 27 Nov 2021 08:39:38 +0000

This tutorial intends to gives you a quick and practical introduction to the open-source workflow and decision automation platform Camunda! 🦊

Here you can find the code for this chapter under the git tag chapter-1.

💿 Requirements

Java 8+
Maven
Camunda Modeler (you can install it on Linux by executing support/xdg_register.sh after extracting the archive)

🏃 Let's go!

The easiest way to get started is to download this sample project:

curl -L https://github.com/camunda/camunda-get-started-spring-boot/archive/Step-3.zip \
  | bsdtar -xvf - -C .

Which you can then execute with Maven:

cd camunda-get-started-spring-boot-Step-3 && mvn spring-boot:run

Now surf towards localhost:8080 and login via demo & demo:

🌐 Taking a closer look into the browser app

Now click on Tasklist:

From the second column you can see that you have a process running, which is on hold because of the User Task named Check the request, which requires that a user takes a look at it and allows further execution:

You can do so by clicking on Complete from within the first tab:

⚙️ Adding a Service Task to loanApproval.bpmn

One way to let Camunda execute a own Java function by creating a Service Task from within the Camunda Modeler, you should see the following view by opening loanApproval.bpmn with the modeler:

Within block #1 you can set ID and Name, block #2 is for pointing to your own Java function. It's most practical name ID like your Java function:

package org.camunda.bpm.getstarted.loanapproval.delegates;

import org.camunda.bpm.engine.delegate.DelegateExecution;
import org.springframework.stereotype.Component;

@Component
public class MainDelegate {

    public void validateTheRequest(DelegateExecution execution) {
        System.out.println("🚀 Executing MainDelegate.validateTheRequest");
    }
}

Now you should see a new item from within your browser:

Switch back to the first tab Form and click again on Complete, this time it should go through your own Java function, the Spring terminal proves it:

...
2021-11-26 20:19:49.855  INFO 2249 --- [nio-8080-exec-5] o.s.web.servlet.DispatcherServlet        : Completed initialization in 5 ms
🚀 Executing MainDelegate.validateTheRequest

Nice! 🥳🎉 I think I will add some testing for the next article, stay tuned and happy coding! 🤗

Executing Github Gist files from Linux Shell via cURL 🚀

Thomas Gotwig — Sat, 20 Nov 2021 09:54:11 +0000

We have two different URL options to fetch a Github Gist file via cURL:

gist.githubusercontent.com
api.github.com

The second one is a bit more work, but always instant up-to-date! 🌟

1️⃣ gist.githubusercontent.com

curl -s https://gist.githubusercontent.com/[user]/[gist_id]/raw/[gist_file]?_=$(uuidgen) \
| bash

🌍 Hello World!

But this can run a older version of the file 😖

2️⃣ api.github.com

🔧 Fix limitations of api.github.com

Using api.github.com comes with rate-limiting per hour:

curl -I -s https://api.github.com/users/[user] | grep x-ratelimit

x-ratelimit-limit: 60
x-ratelimit-remaining: 59
x-ratelimit-reset: 1636928776
x-ratelimit-resource: core
x-ratelimit-used: 1

However, we can get around this strong limitation by using a PAT:

curl -I -s -u <user>:<pat> \
    https://api.github.com/users/[user] | grep x-ratelimit

x-ratelimit-limit: 5000
x-ratelimit-remaining: 4999
x-ratelimit-reset: 1636928894
x-ratelimit-used: 1
x-ratelimit-resource: core

🚀 Executing the Gist file!

curl -s -u <user>:<pat> \
    "https://api.github.com/gists/[gist_id]?_=$(uuidgen)" \
    | jq --raw-output '.files."<GIST_FILE>".content' | bash

🌍 Hello World!

Until now it was always up-to-date! 😊

Host your Swagger files with Github Pages & Swagger UI 🦜

Thomas Gotwig — Sat, 13 Nov 2021 16:35:16 +0000

Get some Swagger files like from the tmforum ProductOrder specification.

Create index.html at root level:



<html>
  <head>
    <script src="https://unpkg.com/swagger-ui-dist@3/swagger-ui-bundle.js"></script>
    <script src="https://unpkg.com/swagger-ui-dist@3/swagger-ui-standalone-preset.js"></script>
    <link rel="stylesheet" type="text/css" href="https://unpkg.com/swagger-ui-dist@3/swagger-ui.css" />
    <title>TMF622_ProductOrder</title>
  </head>
  <body>
    <div id="swagger-ui"></div>
    <script defer>
      window.onload = function () {
        const ui = SwaggerUIBundle({
          urls: [
            {
              name: "TMF622-ProductOrder-v4.0.0",
              url: "TMF622-ProductOrder-v4.0.0.swagger.json",
            },
            {
              name: "Product_Ordering_Management.regular",
              url: "Product_Ordering_Management.regular.swagger.json",
            },
          ],
          dom_id: "#swagger-ui",
          deepLinking: true,
          presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
          plugins: [SwaggerUIBundle.plugins.DownloadUrl],
          layout: "StandaloneLayout",
        });
        window.ui = ui;
      };
    </script>
    <style>
      .swagger-ui .topbar .download-url-wrapper input[type="text"] {
        border: 2px solid #77889a;
      }
      .swagger-ui .topbar .download-url-wrapper .download-url-button {
        background: #77889a;
      }
      .swagger-ui img {
        display: none;
      }
      .swagger-ui .topbar {
        background-color: #ededed;
        border-bottom: 2px solid #c1c1c1;
      }
      .swagger-ui .topbar .download-url-wrapper .select-label {
        color: #3b4151;
      }
    </style>
  </body>
</html>

Enable Github Pages:

That's all! 😀🎉

Load-Balanced MEAN-Stack by AWS CloudFormation & Docker 🐳

Thomas Gotwig — Sun, 07 Nov 2021 16:54:15 +0000

In this short article I will show how to deploy a Mean-Stack app by AWS-CLI and CloudFormation using a v1 load-balancer 😃

All the code regarding our deployment you can also find here:
https://github.com/TGotwig/devops

We take usage of an very nice and simple MEAN-Stack project which comes from Brad Traversy 🤗

Download the sample repo and cd into it:

git clone git@github.com:TGotwig/devops.git
cd aws-cloudformation/solutions/advanced/mean-stack

⚙️ Setup awscli

Install the awscli from somewhere and login:

aws configure --profile <YOUR_AWS_ACCOUNT_NAME>

You will be asked for two IDs, you can get them through:

⚙️ Setup ssh

Create a file called parameters.json:

[
  {
    "ParameterKey": "KeyName",
    "ParameterValue": "<KeyName>"
  }
]

Replace <KeyName> by your SSH key under EC2 / Key Pairs:

⚙️ Setup Makefile

Create a file called .env for the Makefile:

stack-name=simple-mean-stack
profile=<YOUR_AWS_ACCOUNT_NAME>
region=<YOUR_AWS_REGION>

🚀 Run it!

Start it by running make up, an EC2 machine should boot up:

After some time we can reach the app, run make getUrl to get the url:

After refreshing the page few times you should see another IP:

You can remove the entire stack by running make rm! 🔥

Awesome! Now we have finished our load-balanced Mean-Stack app 😎🎉

Flash USB stick for Windows from Ubuntu 🚀

Thomas Gotwig — Wed, 27 Oct 2021 19:26:14 +0000

This article will should you how to create a bootable USB stick for installing Windows 10 / 11 from MacOS, here you can find ISO images for Windows.

🧹 Format your USB stick to NTFS

Install gparted to format your USB stick:

sudo apt-get install -y gparted

Select your USB device in the top right corner.
Delete all your partitions so that you have only one (if you cant delete a partition then unmount it first by selecting that option through the context menu of that table item).
Create the NTFS partition.

💿 Installing & opening unetbootin

sudo add-apt-repository -y ppa:gezakovacs/ppa
sudo apt-get update
sudo apt-get install -y unetbootin

sudo mkdir /media/hdd1
sudo mount -t ntfs-3g /dev/sda1 /media/hdd1
sudo unetbootin installtype=USB targetdrive=/dev/sda1

🚀 Flash it!

Select your Windows ISO image and flash it 🙌

Flash USB stick for Windows from MacOS 🚀

Thomas Gotwig — Sat, 23 Oct 2021 11:29:46 +0000

This article will should you how to create a bootable USB stick for installing Windows 10 / 11 from MacOS, here you can find ISO images for Windows.

🧹 Format your USB stick to NTFS

Format your USB stick to Microsoft NTFS, to do so install ntfs-mac, this will install a ntfs driver for MacOS, now this format should be available for you inside of Disk Utility, erase the USB stick:

💿 Installing & opening unetbootin

Install unetbootin with brew:

brew install --cask unetbootin

Open it and allow it through System Preferences / Security & Privacy:

For me unetbootin didn't recognize my usb device, but it worked by selecting it through the command line:

/Applications/unetbootin.app/Contents/MacOS/unetbootin installtype=USB targetdrive=/dev/disk2s1

Replace /dev/disk2s1 with yours, you can find it out by diskutil list:

/dev/disk2 (external, physical):
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:     FDisk_partition_scheme                        *31.5 GB    disk2
   1:               Windows_NTFS WIN                     31.5 GB    disk2s1

🚀 Flash it!

Select your Windows ISO image and flash it 🙌

Publish a simple executable from Rust on Chocolatey 🍫

Thomas Gotwig — Fri, 04 Sep 2020 06:51:00 +0000

The most comfortable way to install software on Windows is thorugh Chocolatey 🍫 And in this guide you will learn how to do that! 🤩 At least for simple executables 🐣

I successfully published my Rust app vidmerger in that way! 🎞✨

🐣 Initializing

First of all install the cli-tool for Chocolatey:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

Then run choco new my-app to generate a folder called my-app with the following content:

my-app
├── ReadMe.md
├── _TODO.txt
├── my-app.nuspec
└── tools
    ├── LICENSE.txt
    ├── VERIFICATION.txt
    ├── chocolateybeforemodify.ps1
    ├── chocolateyinstall.ps1
    └── chocolateyuninstall.ps1

The minimal setup for publishing would look like:

my-app
├── my-app.nuspec
└── tools
    ├── LICENSE.txt
    └── VERIFICATION.txt

The *.ps1 files are basically for defining shell commands which run on beforemodify, install and uninstall. We don't really need them for publishing a simple executable.

Put your *.exe file from Rust or whatever into the tools folder 🦀

⚙️ Modifying

I think I'll just show you here my three modified files from my Rust app vidmerger, modify them accordingly 👇

🎴 my-app.nuspec

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2015/06/nuspec.xsd">
  <metadata>
    <id>vidmerger</id>
    <version>0.1.2</version>
    <title>vidmerger</title>
    <authors>Thomas Gotwig</authors>
    <projectUrl>https://github.com/tgotwig/vidmerger</projectUrl>
    <tags>video cli</tags>
    <summary>A wrapper around ffmpeg which simplifies merging multiple videos 🎞</summary>
    <description>Vidmerger is a command-line-tool which uses `ffmpeg` to merge multiple video-files with the same file-extension together into one file called `output.FORMAT`. It includes a usage help which you can print out by `vidmerger --help` 😃</description>
  </metadata>
  <files>
    <file src="tools\**" target="tools" />
  </files>
</package>

🎴 LICENSE.txt

Copyright 2020 Thomas Gotwig

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🎴 VERIFICATION.txt

Generated by `CertUtil -hashfile vidmerger.exe SHA256`:

1268967539be0449126438887170c779aaea6fdbf4d835e529c77d4c56a7f75d

Think on updating the hash inside of VERIFICATION.txt before pushing 🧐

🚀 Pushing

Before you can push something, you'll need to login on your choco-cli first, to do so, go on https://chocolatey.org/account, do a login there and click on Show API Key, run that listed commands in your console.

Finally lets push it to Chocolatey! 😃

choco pack
Get-ChildItem *.nupkg | ren -NewName vidmerger.nupkg
choco push vidmerger.nupkg --source https://push.chocolatey.org
Remove-Item vidmerger.nupkg

That's all! 😊🍫

Simple MEAN-Stack deployment by AWS CloudFormation & Docker 🐳

Thomas Gotwig — Sat, 15 Aug 2020 11:06:03 +0000

Deploying AWS apps mainly over the AWS homepage takes much time, we can reduce this time a lot by using code-as-infrastructure principles by using the great AWS-CLI and AWS CloudFormation! 🚀

This guide is mainly for beginners which wants a quick & simple overview 🙂 All the code regarding our deployment you can also find here:
https://github.com/TGotwig/devops