From 3479455449a3e24d3bbffe6feceea10066321cb5 Mon Sep 17 00:00:00 2001 From: Arthur Barr Date: Wed, 21 Mar 2018 16:44:47 +0000 Subject: [PATCH] Update developer image to V9.0.5 --- Makefile | 4 ++-- docs/building.md | 12 +++++++++--- docs/testing.md | 9 ++++----- 3 files changed, 15 insertions(+), 10 deletions(-) diff --git a/Makefile b/Makefile index f17c60c..c1b94cc 100644 --- a/Makefile +++ b/Makefile @@ -19,7 +19,7 @@ # BASE_IMAGE is the base image to use for MQ, for example "ubuntu" or "rhel" BASE_IMAGE ?= ubuntu:16.04 # MQ_VERSION is the fully qualified MQ version number to build -MQ_VERSION ?= 9.0.4.0 +MQ_VERSION ?= 9.0.5.0 # MQ_ARCHIVE is the name of the file, under the downloads directory, from which MQ Advanced can # be installed. The default value is derived from MQ_VERSION, BASE_IMAGE and architecture # Does not apply to MQ Advanced for Developers. @@ -69,8 +69,8 @@ else ifeq "$(ARCH)" "s390x" MQ_ARCHIVE_ARCH=SYSTEM_Z endif # Archive names for IBM MQ Advanced for Developers for Ubuntu -MQ_ARCHIVE_DEV_9.0.3.0=mqadv_dev903_ubuntu_x86-64.tar.gz MQ_ARCHIVE_DEV_9.0.4.0=mqadv_dev904_ubuntu_x86-64.tar.gz +MQ_ARCHIVE_DEV_9.0.5.0=mqadv_dev905_ubuntu_x86-64.tar.gz ############################################################################### # Build targets diff --git a/docs/building.md b/docs/building.md index da4b616..5c06ee8 100644 --- a/docs/building.md +++ b/docs/building.md @@ -9,7 +9,7 @@ You need to ensure you have the following tools installed: This procedure works for building the MQ Continuous Delivery release, on `x86_64`, `ppc64le` and `s390x` architectures. 1. Create a `downloads` directory in the root of this repository -2. Download MQ from IBM Passport Advantage, and place the downloaded file (for example, `IBM_MQ_9.0.4.0_UBUNTU_X86-64.tar.gz` for MQ V9.0.4 for Ubuntu on x86_64 architecture) in the `downloads` directory +2. Download MQ from IBM Passport Advantage, and place the downloaded file (for example, `IBM_MQ_9.0.5.0_UBUNTU_X86-64.tar.gz` for MQ V9.0.5 for Ubuntu on x86_64 architecture) in the `downloads` directory 2. Run `make build-advancedserver` > **Warning**: Note that MQ offers two different sets of packaging on Linux: one is called "MQ for Linux" and contains RPM files for installing on Red Hat Enterprise Linux and SUSE Linux Enterprise Server. The other package is called "MQ for Ubuntu", and contains DEB files for installing on Ubuntu. @@ -38,6 +38,12 @@ By default, the MQ images use Ubuntu as the base layer. You can build using a R BASE_IMAGE=centos:7 make build-advancedserver ``` -The `make` tool will try and locate the right archive file under the `downloads` directory, based on your platform architecture and your `MQ_VERSION` environment variable, for example `IBM_MQ_9.0.4.0_LINUX_X86_64.tar.gz` for MQ V9.0.4.0 on x86_64. You can also set the `MQ_ARCHIVE` environment variable to set the specific file name. +The `make` tool will try and locate the right archive file under the `downloads` directory, based on your platform architecture and your `MQ_VERSION` environment variable, for example `IBM_MQ_9.0.5.0_LINUX_X86_64.tar.gz` for MQ V9.0.5.0 on x86_64. You can also set the `MQ_ARCHIVE` environment variable to set the specific file name. + +Note that if you are using Red Hat Enterprise Linux, you will need to create your own base image layer, with your subscription enabled, as described [here](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html/getting_started_with_containers/get_started_with_docker_formatted_container_images). The MQ image build needs to install some additional packages, and a subscription is required to access the Red Hat repositories. + + +## Installed components + +This image includes the core MQ server, Java, language packs, and GSKit. This can be configured by setting the `MQ_PACKAGES` argument to `make`, or directly as a [Docker build argument](https://docs.docker.com/engine/reference/commandline/build/#set-build-time-variables-build-arg). -Note that if you are using Red Hat Enterprise Linux, you will need to create your own base image layer, with your subscription enabled, as described [here](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html/getting_started_with_containers/get_started_with_docker_formatted_container_images). The MQ image build needs to install some additional packages, and a subscription is required to access the Red Hat repositories. \ No newline at end of file diff --git a/docs/testing.md b/docs/testing.md index 12c16c1..4c2ce78 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -18,11 +18,10 @@ make deps ``` ## Running the tests -There are three main sets of tests: +There are two main sets of tests: 1. Unit tests, which are run during a build 2. Docker tests, which test a complete Docker image, using the Docker API -3. Kubernetes tests, which test the Helm charts (and the Docker image) via [Helm](https://helm.sh) ### Running the Docker tests The Docker tests can be run locally on a machine with Docker. For example: @@ -35,7 +34,7 @@ make test-advancedserver You can specify the image to use directly by using the `MQ_IMAGE_ADVANCEDSERVER` or `MQ_IMAGE_DEVSERVER` variables, for example: ``` -MQ_IMAGE_ADVANCEDSERVER=mqadvanced-server9.0.4.0-x86_64-ubuntu-16.04 make test-advancedserver +MQ_IMAGE_ADVANCEDSERVER=mqadvanced-server:9.0.5.0-x86_64-ubuntu-16.04 make test-advancedserver ``` You can pass parameters to `go test` with an environment variable. For example, to run the "TestGoldenPath" test, run the following command:: @@ -44,10 +43,10 @@ You can pass parameters to `go test` with an environment variable. For example, TEST_OPTS_DOCKER="-run TestGoldenPath" make test-advancedserver ``` -You can also use the same environment variables you specified when [building](./building), for example, the following will try and test an image called `mqadvanced-server9.0.3.0-x86_64-ubuntu-16.04`: +You can also use the same environment variables you specified when [building](./building), for example, the following will try and test an image called `mqadvanced-server:9.0.4.0-x86_64-ubuntu-16.04`: ``` -MQ_VERSION=9.0.3.0 make test-advancedserver +MQ_VERSION=9.0.4.0 make test-advancedserver ``` ### Running the Docker tests with code coverage