gridappsd/gridappsd_base container

This repository is used to build the base container for gridappsd.

It also includes a few scripts one to create the releases and another to create a blazegraph container.

Create a gridappsd release

To create a release, the create_release.sh script is run multiple times, between each run there are manual testing and validation steps. Requires github username and token.

1. Clone the build repository

git clone https://github.com/GRIDAPPSD/gridappsd-docker-build

2. Clone the gridappsd-docker repository

git clone https://github.com/GRIDAPPSD/gridapspd-docker

3. Edit the create_release.sh script to update the version and add GitHub username and token.

cd gridappsd-docker-build/scripts/release
vi create_release.sh

4. Run the create_release.sh script to create the release branches

./create_release.sh

• pulls the latest gridappsd/blazegraph:develop container and tags as releases_VERSION and pushes to docker hub
• clone the GitHub repositories develop branches and create the releases/VERSION branches
• Update the default version for the run.sh script in gridappsd-docker

5. Verify the containers were built and test the releases_VERSION

cd ../../../gridappsd-docker
./run.sh -t releases_VERSION

6. Run the create_release.sh script to create the pull requests

cd ../gridapspd-docker-build/scripts/release
./create_release.sh

• Update the gridappsd/blazegraph:master container
• Create the pull requests from releases/VERSION to master

7. Assign and merge the pull requests on GitHub

8. Run the create_release.sh script to create the tagged releases

./create_release.sh

• Create the tagged releases
• Create the gridappsd/blazegraph:vVERSION container

9. Verify the containers have been built and test the released version

cd ../../../gridappsd-docker
./run.sh -t vVERSION

Build the blazegraph container

1. Clone the build repository

git clone https://github.com/GRIDAPPSD/gridappsd-docker-build

2. Create a virtual environment and install the python requirements

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements_blazegraph.txt

3. Run the create_release.sh script to create the local blazegraph container

./create_blazegraph.sh

• pulls the base lyrasis container
• clones the GitHub repositories for the CIMHub and Powergrid0Models
• imports the PowerGridModels/platform/ files, and inserts measurements and houses

4. Verify the import was successfull

Review the bzbuild/build_timestamp/create.log file to verify all files, measurements, and houses were imported correctly.