Creating Preloaded Images¶
The main purpose of CI is to produce Targets. These Targets are produced by two different types of CI builds: LmP “platform” builds and “container” builds. By default, platform builds don’t include the Docker Compose Apps and container images defined in the Target. In a similar fashion container builds don’t produce an image that can be flashed to a device.
As customers move closer to more formal phases of CI and/or production, they normally want each Target to have a complete image that can run without having to download container images. This can be done by configuring a Factory for “preloaded images”.
There are two ways to create these images:
- fioctl targets image
- configuring ci-scripts.git to preload each build
The easiest way to configure this is updating a Factory’s factory-config.yml in ci-scripts.git with:
containers: preload: true assemble_system_image: true # Optional: The list of apps to preload can be set globally with: # params: # APP_SHORTLIST: "money-making-app,debug-tools"
For simple workflows this may suffice. It will cause every Target built in the Factory to include and enable all Compose Apps. However, its quite common to have more complex workflows. For example a Factory may have their containers.git set up like:
# devel branch fiotest - A compose-app that some devices run for QA. money-making-app - The "product" debug-tools - A compose-app with some tooling used for devel # master branch fiotest - A compose-app that some devices run for QA. money-making-app - The "product" # production branch money-making-app - The "product"
In this scenario “devel” images should be preloaded with:
“master” images and “production” should only include the “money-making-app”.
This can be configured in factory-config.yml with:
lmp: tagging: # Use a "production" branch, that may have some special platform # features enabled/disabled. However, it still uses the containers # from master for its apps: refs/heads/production: - tag: production inherit: master ... containers: preload: true assemble_system_image: true tagging: # Changes to containers master create both "master" and "production" tagged targets refs/heads/master: - tag: master - tag: production refs/heads/devel: - tag: devel ref_options: refs/heads/devel: params: APP_SHORTLIST: "money-making-app,debug-tools" refs/heads/master: params: APP_SHORTLIST: "money-making-app" refs/heads/production: params: APP_SHORTLIST: "money-making-app"
With this configuration in place the factory will produce Targets with the correct apps preloaded and enabled by default.