jeffersonlab/mycontainer repository overview

⁠mycontainer

Read-only MYA Docker container.

• Overview⁠
• Quick Start with Compose⁠
• Install⁠
• Configure⁠
• Build⁠
• Release⁠
• See Also⁠

⁠Overview

The JLab EPICS⁠ archiver is named MYA, and this project provides a read-only single node instance in a container. The container image leverages the MariaDB⁠ image and adds the MYA schema with some example data. The parts of MYA that monitor EPICS and write to the database are not included. This container is useful for testing and developing MYA-dependent apps.

⁠Quick Start with Compose

1. Grab project

git clone https://github.com/JeffersonLab/mycontainer
cd mycontainer

1. Launch Compose⁠

docker compose up

1. Query for channels list

docker exec -it mya bash
mysql -u myapi -p -A archive
select * from channels;

Use password: password

⁠Install

docker pull jeffersonlab/mycontainer

⁠Configure

The container is extended from the official MariaDB⁠ image so all of those environment variables apply, especially the MYSQL_PASSWORD and MYSQL_ROOT_PASSWORD.

You can mount an .sql file into the /docker-entrypoint-initdb.d/ directory to add additional data. Some files⁠ already exist, so be careful not to overwrite or name your file starting with a number that forces it to be processed before the base DDL is run. Use a file mount and avoid an entire directory mount else you'll erase the 00_base.sql file needed to setup the base DDL.

⁠Build

git clone https://github.com/JeffersonLab/mycontainer
cd mycontainer
docker build -t mycontainer .

⁠Release

1. Create a new release on the GitHub Releases⁠ (Enumerate changes and link issues).
2. Build and publish a new Docker image from the GitHub tag⁠. GitHub is configured to do this automatically on git push of semver tag (typically part of GitHub release) or the Publish to DockerHub⁠ action can be manually triggered after selecting a tag.
3. Bump and commit quick start image version⁠

⁠See Also

• myquery⁠
• softioc⁠