Creating the TIBCO BusinessWorks Container Edition Base Docker Image for Linux Containers

Before you begin
  • Download the TIBCO BusinessWorks Container Edition runtime zip file, bwce-runtime-<version>.zip, from http://edelivery.tibco.com.

    To download this file,

    1. Select Container from the Operating Systems drop down list.
    2. Read and Accept the TIBCO End User License Agreement.
    3. Select the radio button for Individual file Download.
    4. Click the + sign to view the individual components and select bwce-runtime-<version>.zip.
  • An installation of Docker.
Note: TIBCO ActiveMatrix BuisnessWorks does not ship docker folder or scripts with it, because the scripts can be pulled directly from GitHub without installing TIBCO BusinessWorks Container Edition separately.
    Procedure
  1. Navigate to the TIBCO_HOME/bwce/<version>/docker directory.
  2. Copy the bwce-runtime-<version>.zip file to the TIBCO_HOME/bwce/<version>/docker/resources/bwce-runtime folder.
  3. Open a command terminal and execute the following command from the TIBCO_HOME/bwce/<version>/docker folder: 
    docker build -t TAG-NAME .

    For example, 

    docker build -t tibco/bwce:latest .

    By default, the debian:buster-slim image is used to create base docker image for TIBCO BusinessWorks Container Edition. You can also change the image with the following dockerfile content.

    • Dockerfile content for openSUSE: 
      FROM opensuse/leap
LABEL maintainer="Cloud Software Group, Inc."
ADD . /
RUN chmod 755 /scripts/*.sh && zypper -n update && zypper -n refresh && \
zypper -n in unzip openssh net-tools 
      RUN groupadd -g 2001bwce \
      && useradd -m -d /home/bwce -r -u 2001 -g bwce bwce
      USER bwce
      ENTRYPOINT ["/scripts/start.sh"]
    • Dockerfile content for CentOS 7: 
      FROM centos:7
LABEL maintainer="Cloud Software Group, Inc."
ADD . /
RUN chmod 755 /scripts/*.sh && yum -y update && yum -y install unzip ssh net-tools
ENTRYPOINT ["/scripts/start.sh"]
    • Dockerfile content for openjdk:8-jdk-alpine 
      FROM openjdk:8-jdk-alpine
LABEL maintainer="Cloud Software Group, Inc."
ADD . /
RUN chmod 755 /scripts/*.sh && apk update && apk add unzip openssh net-tools
      RUN apk add --no-cache bash
      RUN addgroup -S bwcegroup && adduser -S bwce -G bwcegroup
      USER bwce
      ENTRYPOINT ["/scripts/start.sh"]
      Note: To remove TIBCO JRE from openjdk:8-jdk-alpine based container image, navigate to https://github.com/TIBCOSoftware/bwce-docker/tree/openjdk-alpine and clone the 'openjdk-alpine' repository to your local machine.
      For more information to create the base Docker image for Linux container, see "Creating the TIBCO BusinessWorks Container Edition Base Docker Image for Linux Containers".
    • Dockerfile content for rhel7-minimal 
      FROM registry.access.redhat.com/rhel7-minimal
LABEL maintainer="Cloud Software Group, Inc."
ADD . /
RUN chmod 777 scripts/*.sh && microdnf install unzip net-tools --enablerepo=rhel-7-server-rpms && \
microdnf update; microdnf clean all
ENTRYPOINT ["/scripts/start.sh"]
      Note: Ensure that you have valid Red Hat subscription for using rhel7-minimal.
    • Dockerfile content for Redhat Standard OS: 
      FROM registry.access.redhat.com/rhel7/rhel
LABEL maintainer="Cloud Software Group, Inc."
ADD . /
RUN chmod 777 scripts/*.sh && yum install -y unzip ssh net-tools && \
yum update -y; yum clean all
ENTRYPOINT ["/scripts/start.sh"]
    • Dockerfile content for AmazonLinux 2 OS: 
      FROM amazonlinux:2
LABEL maintainer="Cloud Software Group, Inc."
ADD . /
      RUN chmod 777 scripts/*.sh && yum install -y unzip ssh net-tools && \
yum update -y; yum clean all
      RUN groupadd -g 2001 bwce \
      && useradd -m -d /home/bwce -r -u 2001 -g bwce bwce
      USER bwce
      ENV LANG C.UTF-8
      ENV LC_ALL C.UTF-8
      
ENTRYPOINT ["/scripts/start.sh"]

ResultThe TIBCO BusinessWorks Container Edition base docker image is now created. This base docker image can now be used to create docker application images.

 

Support for stopping container gracefully.

To stop container gracefully in TIBCO Business Studio for BusinessWorks, run the following commands:

For Docker:

docker stop -t <timeout period in sec> <conainer name/ID>

By default, the timeout is 10 sec.It waits for seconds to stop before killing the container forcefully.

For Kubernetes:

You can customize the grace period by setting the terminationGracePeriodSeconds at the pod spec level, which defaults to 30 seconds.

spec:
containers:
	name: test
	image: ...
	terminationGracePeriodSeconds: 60