https://github.com/throwtheswitch/drsurlycourse2docker
Dr. Surly’s Course #2 build environment
https://github.com/throwtheswitch/drsurlycourse2docker
Last synced: 9 months ago
JSON representation
Dr. Surly’s Course #2 build environment
- Host: GitHub
- URL: https://github.com/throwtheswitch/drsurlycourse2docker
- Owner: ThrowTheSwitch
- Created: 2017-05-23T14:16:34.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2025-02-17T14:19:56.000Z (over 1 year ago)
- Last Synced: 2025-10-03T06:37:22.608Z (9 months ago)
- Language: C
- Homepage:
- Size: 21.5 MB
- Stars: 7
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# Dr. Surly’s School for Mad Scientists: Interaction Tests, Mocks & Refactoring in Embedded Software Docker Image
Unit testing environment with ARM cross compiler, Unity, CMock, Ceedling, and Qemu emulator
## Contents
* Testing tools
* Ceedling 0.30.0
* CMock 2.5.2
* Unity 2.5.1
* Environment
* Ruby 2.4.9
* make 4.1
* gcc 7.4.0
* arm-none-eabi-gcc 6.3.1
* QEMU 1.1.2 (modified)
* Course project
## Build
The project image is layered atop a base image. The project image contains the potentially changeable content of the testing tools and the project materials. If future content updates are necessary this produces a slim `docker pull` operation for students.
The base docker image contains the heavyweight, unchanging tools — gcc toolchain, Ruby, and our customized Qemu. All these are built from scratch or installed by package manager during image build. To limit the download size for students, this image should be squashed.
If the base image changes, it must be rebuilt first and then the project image must be rebuilt. If only the project image changes, only it must be rebuilt.
### Base Docker Image
Because of the Docker `--squash` option, this image must be built locally, manually tagged, and pushed to Docker Hub. Automated Docker Hub builds do not support the `--squash` option.
1. Update Dockerfile and/or assets.
1. Build locally… `./build/base/run.sh`
1. Tag locally `docker image tag throwtheswitch/drsurly-course2-base throwtheswitch/drsurly-course2-base:[tag]`
1. `docker push throwtheswitch/drsurly-course2-base:[tag]`
### Project Docker Image
1. Update Dockerfile and/or assets. If base image has changed, be sure to update the tagged version of the base image at the top of build/release/Dockerfile before building the project image.
1. For a local build… `./build/release/run.sh`. Local builds are optional or for development work. Ultimately, this build is automated at Docker Hub for tagging and release, triggered by Github commits.
## Usage
`docker run -it --rm -v :/lab throwtheswitch/drsurly-course2[:tag]`