Creating Container Images

#### Search Results

Search

# Creating Container Images

This section describes how to create your own container images if you do not want to use the official pre-built container images.

- Adabas Docker Creation Scripts

- Building a Docker Image

## Adabas Docker Creation Scripts

The installation directory/Adabas/docker/Adabas directory contains scripts to create Docker-compatible packages from the Adabas installation. A prerequisite to use the scripts is to use the Software AG Installer for the installation of Adabas.

Use the scripts to generate a package for:

- a single Adabas instance without add-ons.

- a single Adabas instance with Adabas RESTful Administration. The installation must contain the Adabas RESTful Administration component.

The Adabas RESTful Administration allows you to administer and monitor an Adabas Docker container through a REST server port instead of using the `docker attach` command. Software GmbH provides a batch tool to connect to the container through a REST server port. For more information about administering Adabas through REST, see Adabas REST Administration.

## Building a Docker Image

To create a Docker image, you need temporary and prepared files from an Adabas installation for your local instance. These temporary files can be removed after the desired container images are created.

You can use the `createAdabasSAGtar.sh` script inside the corresponding product directory (Adabas or Adabas-RestAdministration) to perform this specific task. Run the script for your desired use case (Adabas or Adabas with RESTful administration service) to create the temporary files in the same directory.

For example, to create the necessary files for a single Adabas instance without add-ons:

1. In a terminal window, go to installation directory/Adabas/docker/Adabas.

2. Execute the following command:

       ./createAdabasSAGtar.sh installation directory

   where `installation directory` is the directory containing your Adabas installation.

The files now created under installation directory/Adabas/docker/Adabas/tmp contain the configuration of the Adabas installation and any custom scripts required for your container environment. You must generate new temporary files every time a configuration change occurs.

Before you build the Docker image, you can specify the values for user ID and group ID in the Dockerfile for your desired `sag` user inside the container. Docker creates the `sag` user and group during the image creation. This user requires a unique user ID and a group ID to create files in the persistent volume, located at /data.

To build the container image with the default user ID and group ID of 1724, enter:

    docker build --tag name:tag .

If you want to change the default values, add the `--build-arg` parameter to your build command:

    docker build --tag name:tag –-build-arg sag_user_id=XXXX --build-arg group_id=XXXX .

### On this page

- Adabas Docker Creation Scripts
- Building a Docker Image