Building an Image Containing an Application to use with Visual COBOL Development Hub

This topic outlines the steps that a Dockerfile must carry out to create an image that contains a COBOL application that can be run under Visual COBOL Development Hub.

Before you follow the steps in this topic you must have built a base image for Visual COBOL Development Hub. For information on creating a base image for Visual COBOL Development Hub see Building a Base Image Containing Visual COBOL Development Hub.

Note: Remember that Visual COBOL is a development and test environment so not for use in production situations. If you want to run COBOL applications in containers in a production environment you must use containers that contain COBOL Server.

Before building an image containing an application to use with Visual COBOL Development Hub you need to ensure that you have available the following:

A base image for Visual COBOL Development Hub. If you have not yet built such an image, see Building a Base Image Containing Visual COBOL Development Hub for information on how to build one.

To build an image that includes an application to use with Visual COBOL Development Hub your Dockerfile needs to perform the following steps:

Specify a base image to work from. This should be an image containing only Visual COBOL Development Hub. See Building a Base Image Containing Visual COBOL Development Hub for more information.
Create a new user under which the application will run.
Create a folder to hold the application files then copy the application files into it. If you are using SUSE Linux you will need to change ownership to specify the new user as the owner of this new folder.
Specify the user name to use when the image is run.
Specify the name of the executable to run when the image is run.

Note: You might also want to create an image that you can log in to and execute shell or Visual COBOL commands. This option is useful if you are not adding any application files to a base image but want to be able to use Visual COBOL commands from it.

All of the Docker demonstrations offer the option to create such a login image, and those images are tagged with the suffix "_login". See Running the Docker Demonstration for the Visual COBOL Base Image for information on how to specify that you want to create a _login image. For details on the commands required to build such an image, see the bld.sh script in any of the Docker demonstrations.

The above process is used by the Docker demonstrations that create images for applications that you can use with Visual COBOL Development Hub. For more information on one of those demonstrations, including information on all the files it contains and a detailed description of the Dockerfiles it contains, see The Hello World Docker Demonstration.