Assignment #3
Adding the Skycapp Stack Controller
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 new 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 a 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 order.
- 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 the driver allows. WildFHIR does support this.
The controller operates entirely within the browser, with all FHIR API interactions happening via REST calls. No server-side API calls are required.
Prerequisites
We are going to assume you have a GitHub account, have GitHub installed, and know how to clone (or fork) a repository. If you are unconformable with these step or have not done this before please refer to this documentation. We will also assume you are using your preferred choice of an IDE. If you still need one we recommend using VS Code.
- 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/
Installing
- Navigate to https://github.com/danielhmendoza01/skycapp-stack
- Clone the repository
Building and Running Your Own Image 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. \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 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