Locally Develop CMS and TUP CMS

Overview

In Core-CMS make changes. Snapshot the container. In TUP-UI, use the local CMS image.

Steps

TACC/Core-CMS

Note If another CMS container is running, shut it down.

Important If you have changed any dependencies (e.g. Locally Develop CMS and Styles), pin those changes via appropriate lock file (e.g. npm install --save …); otherwise the build step will overwrite those changes.

1. docker-compose -f docker-compose.dev.yml build
   _{For every test of TACC/Core-CMS change on TACC/tup-ui, this is (unexpectedly) required.}
   For initial setup of TACC/Core-CMS for testing, if image is not already built, this is necessary.
2. docker-compose -f docker-compose.dev.yml up --detach
3. docker commit core_cms
   _{The output (with or without sha256:) is your __IMAGE_ID__.}
4. docker tag __IMAGE_ID__ __LOCAL_TAG_NAME__
   _{You may choose any name you would like for __LOCAL_TAG_NAME__.}

^{The container snapshot steps are a streamlined version of (internal) How to Create Docker Image from Local Container.}

TACC/tup-ui

Note If another CMS container is running, shut it down.

5. Edit apps/tup-cms/Dockerfile.
6. Change FROM taccwma/core-cms:... to FROM __LOCAL_TAG_NAME__. _{Or the tag name of any other image you want to test.}
7. docker-compose -f apps/tup-cms/docker-compose.dev.yml build --no-cache
8. npx nx serve tup-cms