48 lines
2.9 KiB
Markdown
48 lines
2.9 KiB
Markdown
# Building a container image
|
|
|
|
## Prerequisites
|
|
|
|
You need to have the following tools installed:
|
|
|
|
* [Docker](https://www.docker.com/) 17.06.1 or later, or [Podman](https://podman.io) 1.0 or later (Podman 4.1 on macOS). If using Podman on macOS, the you need to be in "rootful" mode to allow the use of a network during builds. Run `podman machine init --rootful`.
|
|
* [GNU make](https://www.gnu.org/software/make/)
|
|
|
|
If you are working in the Windows Subsystem for Linux, follow [this guide by Microsoft to set up Docker](https://blogs.msdn.microsoft.com/commandline/2017/12/08/cross-post-wsl-interoperability-with-docker/) first.
|
|
|
|
## Building a production image
|
|
|
|
From MQ 9.2.X, the MQ container adds support for MQ Long Term Support (LTS) **production licensed** releases.
|
|
|
|
### Building MQ 9.3 Long Term Support (LTS) and Continuous Delivery (CD)
|
|
|
|
**Note**: MQ 9.3 is the latest MQ version with MQ Long Term Support (LTS), as well as being the latest Continuous Delivery (CD) version.
|
|
|
|
The procedure below is for building the 9.3 release, on `amd64`, `ppc64le` and `s390x` architectures.
|
|
|
|
1. Create a `downloads` directory in the root of this repository
|
|
2. Download MQ from [IBM Passport Advantage](https://www.ibm.com/software/passportadvantage/), selecting the correct 'Continuous Delivery for containers' eImage part number for your architecture: https://www.ibm.com/support/pages/downloading-ibm-mq-925-continuous-delivery
|
|
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 previous MQ Long Term Support (LTS)
|
|
|
|
**Note**: MQ 9.3 is the latest MQ version with MQ Long Term Support (LTS), as well as being the latest Continuous Delivery (CD) version. Therefore, to build build 9.3.0.X, follow the [instructions above for MQ 9.3](#building-mq-93-long-term-support-lts-and-continuous-delivery-cd).
|
|
|
|
However, if you wish to build the previous MQ LTS, use the instructions for LTS in `docs/building.md` in the `v9.2.0.x-eus` branch.
|
|
|
|
## Building a developer image
|
|
|
|
Run `make build-devserver`, which will download the latest version of MQ Advanced for Developers from IBM developerWorks. This is currently only available on the `amd64` architecture.
|
|
|
|
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 `Generate MQ package in INSTALLATION_DIR` section [here](../install-mq.sh), with the configured options being picked up at build time.
|