Sundhedsvæsenets Kvalitetsinstitut's FHIR Implementation Guide

Create a new release

1. Run sushi locally to ensure the build is successful

2. Bump the version field in sushi-config.yaml

3. Create a tag using git git tag -a X.Y.Z -m "Update something" and push with git push --tags.

4. When the release has been created check here you are ready to deploy the new IG

5. Go to netic flux and update the implementationGuide.yaml file with the new version in the environments you wish the new version to become available.

6. Do the same in trifork flux

7. When the new version has been deployed to the environments, you'll need to update HAPI to use the new version. This is done by creating a POST request to HAPI in the relevant environments:

   • dev: https://rkkp-hapi.tcs.trifork.dev/update-ig
   • test: https://rkkp-hapi.test.tcs.trifork.cloud/update-ig
   • prod: https://rkkp-internal-prod.tcs.trifork.cloud/hapi/update-ig

8. It takes a while for the new IG version to be fully available in HAPI.

Add new fsh inputs

This folder contains a docker-compose-file to host the FHIR Implementation Guide.

To add more to the guide, and let it sync into the backend-server, add and edit fsh-files to the /input-folder.

To check if a SearchParameter will work, check it against the FhirPath. Use the operators.

Run development tools

To get it up and running, type the following command, and wait for the container fhir-implementationguide-builder to exit:

docker compose up -d --build

This will start up two containers:

1. A custom container that will generate the site using Jekyll, java, node, Sushi, and the publisher.jar from FHIR IG Publisher.

2. An Nginx-container that will host it on http://localhost:4000.

Regenerate IG html-files

When you edit in the .fsh-files, run the following command:

docker compose start ig-server

Update the builder

Packages

If Sushi gets an update, this needs to be reflected into the dockerfile. By default, Docker will cache the build, so you need to run the following command before:

docker build --no-cache

If you want to build a docker image, run the following commands from this folder:

# Tags it with 'ig:local'
docker build . --force-rm -t ig:local -f ./DockerfileCi --no-cache

# Or if you run it from root
docker build --build-arg CONTENT_PATH=./FHIR-Implementation-Guide -t ig:local -f ./FHIR-Implementation-Guide/DockerfileCi .

# Removes the container when exiting, naming it 'implementation-guide', running on port 8088
docker run --rm -it --name implementation-guide \
    -p 8088:8080 -p 8087:8087 \
    ig:local

Then head for localhost:8088.

FHIR publisher

You may want to update FHIR. Run the following command:

docker compose run --rm ig-server ./_updatePublisher.sh

To use it, FSH-Sushi must be installed: npm install -g fsh-sushi.

To run it, step into this directory, and run sushi.

CI builds

• See https://build.fhir.org/ig/kip-infrastructure