58 lines
2.5 KiB
Markdown
Executable File
58 lines
2.5 KiB
Markdown
Executable File
# Building a container image
|
|
|
|
## Prerequisites
|
|
|
|
You need to have the following tools installed:
|
|
|
|
* [Docker](https://www.docker.com/) 20.10 or later, or [Podman](https://podman.io) 4.4 or later.
|
|
* [GNU make](https://www.gnu.org/software/make/)
|
|
|
|
## Building Images
|
|
|
|
To build an IBM MQ image, navigate to the appropriate section:
|
|
|
|
- [Building a production image](#building-a-production-image)
|
|
- [Building a developer image](#building-a-developer-image)
|
|
|
|
## Building a production image
|
|
|
|
### MQ Continuous Delivery (CD)
|
|
|
|
The procedure below is for building the 9.4.1 release, on `amd64`, `ppc64le` and `s390x` architectures.
|
|
|
|
1. Create a `downloads` directory in the root of this repository
|
|
2. Identify the correct eImage part number for your architecture from https://www.ibm.com/support/pages/downloading-ibm-mq-94 and download
|
|
3. Ensure the `tar.gz` file is in the `downloads` directory
|
|
4. Run `make build-advancedserver`
|
|
|
|
If you have an MQ archive file with a different file name, you can specify a particular file (which must be in the `downloads` directory). You should also specify the MQ version, so that the resulting image is tagged correctly, for example:
|
|
|
|
```bash
|
|
MQ_ARCHIVE=mq-1.2.3.4.tar.gz MQ_VERSION=1.2.3.4 make build-advancedserver
|
|
```
|
|
|
|
### MQ LTS
|
|
|
|
The procedure below is for building the 9.4.0 release, on `amd64`, `ppc64le` and `s390x` architectures.
|
|
|
|
1. Create a `downloads` directory in the root of this repository
|
|
2. Identify the correct eImage part number for your architecture from https://www.ibm.com/support/pages/downloading-ibm-mq-94 and download
|
|
3. Ensure the `tar.gz` file is in the `downloads` directory
|
|
4. Run `make build-advancedserver`
|
|
|
|
If you have an MQ archive file with a different file name, you can specify a particular file (which must be in the `downloads` directory). You should also specify the MQ version, so that the resulting image is tagged correctly, for example:
|
|
|
|
```bash
|
|
MQ_ARCHIVE=mq-1.2.3.4.tar.gz MQ_VERSION=1.2.3.4 make build-advancedserver
|
|
```
|
|
|
|
## Building a developer image
|
|
|
|
Run `make build-devserver`, which will download the latest version of MQ Advanced for Developers. This is available on the `amd64` and `arm64` (Apple Silicon) architectures.
|
|
|
|
You can use the environment variable `MQ_ARCHIVE_DEV` to specify an alternative local file to install from (which must be in the `downloads` directory).
|
|
|
|
## Installed components
|
|
|
|
This image includes the core MQ server, Java, language packs, GSKit, and web server. This is configured in the `mq-redux` build stage in `Dockerfile-server`.
|