Integrate Software AG Products Using Digital Event Services 10.4 | Integrate Software AG Products Using Digital Event Services | API Gateway Configuration Guide | Docker Configuration | Building the Docker Image for an API Gateway Instance
 
Building the Docker Image for an API Gateway Instance
The API Gateway Docker image provides an API Gateway installation. Depending on the existing installation the image provides a standard API Gateway or an advanced API Gateway. When running the image the API Gateway is started. The API Gateway image is created on top of an Integration Server image.
* To build a Docker image for an API Gateway instance
1. Create a docker file for the Integration Server (IS) instance by running the following command:
./is_container.sh createDockerfile [optional arguments]
Argument
Description
-Dinstance.name
Optional. IS instance name to include in the image.
Default: default
-Dport.list
Optional. Comma-separated list of the ports on the instance to expose in the image.
Default: 5555,9999
-Dpackage.list
Optional. Comma-separated list of Wm packages on the instance to include in the image.
Default: all (this includes all of the Wm packages and the Default package)
-Dinclude.jdk
Optional. Whether to include the Integration Server JDK (true) or JRE (false) in the image.
Default: true
-Dfile.name
Optional. File name for the generated docker file.
Default: Dockerfile_IS
2. Build the IS Docker image using the Docker file Dockerfile_IS by running the following command:
./is_container.sh build [optional arguments]
Argument
Description
-Dfile.name
Optional. File name of the Docker file to use to build the Docker image.
Default: Dockerfile_IS
-Dimage.name
Optional. Name for the generated Docker image.
Default: is:micro
3. Create a Docker file for the API Gateway instance from the IS image is:micro by running the following command:
./apigw_container.sh createDockerfile [optional arguments]
Argument
Description
instance.name
Optional. API Gateway instance to include in the image.
Default: default
port.list
Comma-separated list of the ports on the instance to expose in the image.
Default: 9072
base.image
Name of the base Integration Server image upon which this image should be built..
Default: is:micro
file.name
Optional. File name for the generated Docker file.
Default: Dockerfile_IS_APIGW
The Docker file is created under the root Integration Server installation directory.
4. Build the API Gateway Docker image using the core Docker file Dockerfile_IS_APIGW by running the following command:
./apigw_container.sh build [optional arguments]
Argument
Description
instance.name
Optional. API Gateway instance to include in the image.
Default: default
file.name
File name of the Docker file to use to build the Docker image.
Default: Dockerfile_IS_APIGW
image.name
Optional. Name for the generated Docker image that contains the custom packages.
Default: is:apigw
The image is stored on the Docker host. To check the image run the command $ docker images
Example
A sample shell script for creating and an API Gateway looks as follows:
echo "is createDockerfile ======================================================="
./is_container.sh createDockerfile
status=$?

if [ $status -ne 0 ]
then
echo "Failed! status: $status"
exit $status
fi

echo "is build =================================================================="
./is_container.sh build
status=$?

if [ $status -ne 0 ]
then
echo "Failed! status: $status"
exit $status
fi

echo "apigw createDockerfile =================================================="
./apigw_container.sh createDockerfile
status=$?

if [ $status -ne 0 ]
then
echo "Failed! status: $status"
exit $status
fi

echo "apigw build ============================================================="
./apigw_container.sh build
status=$?

if [ $status -ne 0 ]
then
echo "Failed! status: $status"
exit $status
fi
After running the steps the created images can be listed using the Docker images command: docker images
REPOSITORY TAG IMAGEID CREATED SIZE
is apigw af29373fc98a 15 hours ago 1.3GB
is micro 06e7c0de4807 15 hours ago 1.1GB
centos 7 36540f359ca3 12 days ago 193MB
Note: The is:micro and therefore also the is:apigw images are based on the centos:7 image, which is available from the official CentOS repository
The Docker images resulting from Docker files created using the createDockerFile command feature the following:
*Docker logging.
API Gateway Docker containers log to stdout and stderr. The API Gateway logs can be fetched with Docker logs.
*Docker health check.
API Gateway Docker containers perform health checks. You can use wget request against the API Gateway REST API to check the health status of API Gateway.
The following wget request shows a curl invocation sending a request against the HTTP port. If API Gateway exposes an HTTPS port only the wget is created accordingly. The option --no-check-certificate is used to avoid any failure due to certificate problems.
HEALTHCHECK CMD curl --no-check-certificate
http://localhost:5555/rest/apigateway/health
The wget checks the API Gateway availability by sending requests to the API Gateway REST health resource. If the wget is successful API Gateway is considered healthy.
*Graceful shutdown.
Docker stop issues a SIGTERM to the running API Gateway.

Copyright © 2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release