|
2 | 2 |
|
3 | 3 | Simple docker images for ACE v12 on Linux (amd64 and s390x) and Windows |
4 | 4 |
|
5 | | -ace-full contains a Dockerfile for building an image that can run the full product, including mqsicreatebar with a virtual X server. |
| 5 | +Dockefiles in the following directories are used for various purposes: |
6 | 6 |
|
7 | | -ace-basic contains a Dockerfile for building an image that can run the product server, including all files except the toolkit. |
| 7 | +- ace-full can run the full product, including mqsicreatebar with a virtual X server. |
| 8 | +- ace-basic can run the product server, including all files except the toolkit. |
| 9 | +- ace-minimal can run simple servers with a non-root user. |
| 10 | +- ace-sample contains a sample BAR file and Dockerfiles for building runnable images to serve HTTP clients. |
| 11 | +- devcontainers is used with GitHub Codespaces to allow container-based development with VisualStudio Code in a web browser. |
8 | 12 |
|
9 | | -ace-minimal contains the Dockerfiles for building images that can run simple servers with a non-root user. |
| 13 | +See build-all.sh for details on building the images; setting LICENSE=accept is required for all but the initial image builds. |
10 | 14 |
|
11 | | -ace-sample contains a sample BAR file and Dockerfiles for building runnable images to serve HTTP clients. |
| 15 | +## Setting the correct product URL |
12 | 16 |
|
13 | | -See build-all.sh for details on building the images; setting LICENSE=accept is required for all but the initial image builds. |
| 17 | +The Dockerfiles in the various directories take a `DOWNLOAD_URL` parameter that may |
| 18 | +need to be specified to build a specific version of the product. This is provided on |
| 19 | +the command line using the `--build-arg` parameter, and for the demo repos that use |
| 20 | +Tekton to build the image, the URL is the `aceDownloadUrl` value in ace-minimal-image-pipeline-run.yaml. |
| 21 | + |
| 22 | +This value may need updating, either to another version in the same server directory |
| 23 | +(if available) or else to an ACE developer edition URL from the IBM website. In the latter |
| 24 | +case, start at https://www.ibm.com/docs/en/app-connect/12.0?topic=enterprise-download-ace-developer-edition-get-started |
| 25 | +and proceed through the pages until the main download page with a link: |
| 26 | + |
| 27 | + |
| 28 | + |
| 29 | +The link is likely to be of the form |
| 30 | +``` |
| 31 | +https://iwm.dhe.ibm.com/sdfdl/v2/regs2/mbford/Xa.2/Xb.WJL1cUPI9gANEhP8GuPD_qX1rj6x5R4yTUM7s_C2ue8/Xc.12.0.10.0-ACE-LINUX64-DEVELOPER.tar.gz/Xd./Xf.LpR.D1vk/Xg.12164875/Xi.swg-wmbfd/XY.regsrvs/XZ.pPVETUejcqPsVfDVKbdNu6IRpo4TkyKu/12.0.10.0-ACE-LINUX64-DEVELOPER.tar.gz |
| 32 | +``` |
| 33 | +Copy that link into the aceDownloadUrl parameter or use it as the DOWNLOAD_URL build |
| 34 | +parameter, adjusting the version numbers in the other files and parameters as needed. |
| 35 | + |
| 36 | +## Running the sample |
14 | 37 |
|
15 | 38 | To run the sample after building: |
16 | 39 | ``` |
17 | | -docker run -e LICENSE=accept --rm -ti ace-sample:12.0.4.0-minimal-alpine |
| 40 | +docker run -e LICENSE=accept --rm -ti ace-sample:12.0.10.0-alpine |
18 | 41 | ``` |
19 | | -and then curl http://[container IP]:7800/test should return '{"data":"a string from ACE"}' |
| 42 | +and then `curl http://[container IP]:7800/test` should return '{"data":"a string from ACE"}' |
20 | 43 |
|
21 | 44 | ## Various sizes |
22 | | -Local on Debian 10 machine with defaults in Dockerfiles: |
| 45 | +Local on Ubuntu with defaults in Dockerfiles: |
23 | 46 |
|
24 | 47 | ``` |
25 | | -ace-minimal 12.0.4.0-alpine-openjdk16 2d02c13096c9 24 minutes ago 496MB |
26 | | -ace-minimal 12.0.4.0-alpine-openjdk14 5c1d593ee96f 25 minutes ago 506MB |
27 | | -ace-minimal 12.0.4.0-alpine 6775ce85b5fd 27 minutes ago 604MB |
28 | | -ace-minimal 12.0.4.0-ubuntu a351cfebbd4d 26 minutes ago 684MB |
29 | | -ace-basic 12.0.4.0-ubuntu 319227027474 19 minutes ago 1.48GB |
30 | | -ace-full 12.0.4.0-ubuntu 73978ff4c598 20 minutes ago 3.02GB |
| 48 | +ace-basic 12.0.10.0-ubuntu 69f66523df16 About a minute ago 1.78GB |
| 49 | +ace-full 12.0.10.0-ubuntu 2b77ec0f9a71 2 minutes ago 4.15GB |
| 50 | +ace-minimal 12.0.10.0-ubuntu 0b662240db80 13 minutes ago 738MB |
| 51 | +ace-minimal 12.0.10.0-alpine c5d126442f73 15 minutes ago 644MB |
31 | 52 | ``` |
32 | 53 |
|
33 | | -Most of these will fit into the IBM Cloud container registry free tier due to compression, but ace-full and ace-basic are too big for that. |
| 54 | +Some of these will fit into the IBM Cloud container registry free tier due to compression, but ace-full and ace-basic are too big for that. |
34 | 55 |
|
0 commit comments