Lab 03 – Adding a Stack Controller

Activity

In this assignment, you will set up the Skycapp Stack Controller using GitHub.

What is the Skycapp FHIR Stack Controller?

The Skycapp FHIR Stack Controller is a tool that allows users to reset their FHIR server by purging all existing resources and loading seed data via FHIR bundles. Usually, these FHIR bundles will contain default server data, but users also have the ability to load custom FHIR bundles for specific preferences or testing purposes.

Skycapp FHIR Stack Controller Overview

The Skycapp FHIR Stack Controller(GitHub) provides an easy-to-use interface for managing your local FHIR server. It offers the following key features:

Display Instructions: A web UI that presents Markdown-formatted instructions.
Load FHIR Bundles: Automate the loading of a preset sequence of FHIR bundles into the server, ensuring data is loaded in the correct sequence.
Guided Resource Links: Provides a structured sequence of resource links to help users navigate and interact with the FHIR server efficiently.
Purge Server Data: Supports bulk deletion of all resources on the server, if supported by the FHIR server’s driver.

A Stack Controller is client-only web application that runs completely within the browser, with all commands performed via FHIR API calls. Stack Controllers do not have their own backend service.

Prerequisites

You’ll need a GitHub account, have a git client installed, and know how to clone (or fork) a repository. If you are unfamiliar with these steps, refer to this below documentation before proceeding. We will also assume you are using your preferred IDE. If you still need one we recommend using the free, cross-platform Visual Studio (VS) Code app.

Create a GitHub: https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github
Setup Git on your computer: https://docs.github.com/en/get-started/getting-started-with-git/set-up-git
How to clone a repository: https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository
VS Code: https://code.visualstudio.com/
- Setup: https://code.visualstudio.com/docs/setup/setup-overview

Installing

Navigate to https://github.com/danielhmendoza01/skycapp-stack
Clone the repository

Building and Running Your Own Custom Stack Controller Configuration

The following docker command can be used to start your build.

Note: the “.” at the end means your current directory therefore make sure you are in the repository directory. \Skycapp\skycapp-stack

# Create a new buildx builder named "mybuilder"
docker buildx create --name mybuilder --use

#Verify
docker buildx inspect --bootstrap

#run
docker buildx build -t yourname/stackcontroller:latest --load .

Than you will want to run your image by using the following command. This will assign it to the port 4200.

docker run -d -p 4200:80 yourname/stackcontroller:latest

Your now have your own Stack Controller running on port 4200 (http://localhost:4200)

As long as you have your FHIR server running you can interact with it using the Stack Controller you’ve just created. You will see something similar to the UI below:

In most cases your FHIR server is running on port 8080. If it is not than you can adjust this in the stack.json file. https://github.com/danielhmendoza01/skycapp-stack/blob/main/public/stack.json