How to deploy ui modules from a branch to scratch environment

Owned by Dmytro Popov
Last updated: Jul 18, 2020

Currently the only possible way of deploying UI modules is building platform complete and pushing it to a public docker repository, so that needs to be created beforehand.

Suppose we are deploying ui-oai-pmh from a brach ui-for-rancher.

Note: docker commands need to be executed in developer's local machine.

  • In platform complete, change the dependency of ui-oai-pmh to
"@folio/oai-pmh": "git://github.com/folio-org/ui-oai-pmh.git#ui-for-rancher"
  • Run the following command from root of platform complete, change OKAPI_URL
docker build -f docker/Dockerfile --build-arg OKAPI_URL=https://gulfstream-okapi.ci.folio.org --build-arg TENANT_ID=diku -t your_dockerhubrepo/platform-complete .
  • Run the following command. Without specifying tag (:tagname), it will be 'latest'
docker push your_dockerhubrepo/platform-complete
  • Go to rancher→ aps→platform complete→upgrade
  • Set answers image.repository=your_dockerhubrepo, tag=tagname
  • Press upgrade
  • When upgrade completes, run

docker run --rm -e TENANT_ID=diku -e ADMIN_USER=diku_admin -e ADMIN_PASSWORD=admin -e OKAPI_URL=https://gulfstream-okapi.ci.folio.org docker.dev.folio.org/bootstrap-superuser