Docker Guide

From Variscite Wiki
Revision as of 16:40, 9 April 2020 by Francesco (talk | contribs)

Docker Introduction

<https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-debian-9> Docker is an application that simplifies the process of managing application processes in containers.
Containers let you run your applications in resource-isolated processes. They’re similar to virtual machines, but containers
are more portable, more resource-friendly, and more dependent on the host operating system.

For a detailed introduction to the different components of a Docker container, check out The Docker Ecosystem: An Introduction to
Common Components.

You can check SWUpdate's online documentation at: http://sbabic.github.io/swupdate
This Introduction was taken from the SWUpdate README.md at: https://github.com/sbabic/swupdate

Yocto Integration

Recipes

Before you begin, get familiar with the Varicite Yocto Build Release guide.

Variscite provides the following image recipes:

  • var-image-docker - Based on fsl-image-core with the following differences:
    • xxxxxxxxxxxxxx


Create a Docker-ready Image

  • Follow steps 1-3 of the Yocto Build Release page.
  • Build a recovery SD card and the var-image-swupdate image as the recovery image
$ cd 
$ MACHINE= DISTRO=
$ bitbake fsl-image-gui      (for the recovery SD card)
$ bitbake var-image-swupdate (for the rootfs to be installed on the eMMC)
  • Create the "SWUpdate recovery SD card"
$ sudo MACHINE= ../sources/meta-variscite-imx/scripts/var_mk_yocto_sdcard/var-create-yocto-sdcard.sh -r tmp/deploy/images//var-image-swupdate- /dev/sdX
(Replace /dev/sdX with your actual device)
  • Boot the board using the created SD card. See more info here.
  • Install the demo image to the eMMC. Either use the installation icons on the desktop (which will be updated with the "-u" parameter by the var-create-yocto-sdcard.sh script, when the recovery image used is var-image-swupdate), or use the install_yocto.sh script manually, with the "-u" parameter.
When called with the "-u" parameter, the install_yocto.sh script creates the double-copy compatible layout as shown above

Generate a Field Update file (.swu image)

  • Make your changes in
  • Edit the sw-description file
  • Generate .swu file:
$ bitbake var-image-swu

Test SWUpdate

  • Get the target's IP address using ifconfig
  • Open a web browser on the host and connect to the SWUpdate web server on the target by entering the following in the address bar:
http://<target_ip>:8080
  • On the web page, click "Browse..." and open the .swu image which is located at tmp/deploy/images//var-image-swu-.swu