Skip to content

README.md

Latest commit

 

History

History
105 lines (75 loc) · 3.97 KB

README.md

File metadata and controls

105 lines (75 loc) · 3.97 KB

meta-dts

You can find documentation about the DTS system, including information on building the system, running the system, and the functionalities included in the system, by visiting the following links.

Please visit release section to get latest version of DTS.

Communication channel

We have created communication channels to provide support to our community. Please look there if you are looking for help regarding DTS system or any Dasharo related stuff.

Reporting issues

Thank you for using Dasharo Tools Suite Community Edition. If you have encountered any problems with this version, or would like to provide feedback for us - please open an issue on dasharo-issues repository.

Release process

This section contains the technical aspects of the DTS release process. The recipients of this information should be those authorised to issue DTS releases.

How to publish a release

Please follow the steps below to release a new DTS image.

  1. Make sure that everything that should go into the given release is merged to main.

  2. Bump the version in meta-dts-distro/conf/distro/dts-distro.conf file.

    Note: In cases where MINOR or MAJOR part of version is updated, please inform one of the maintainers as there will be needed new keys to sign the binaries in next step of CI/CD pipeline.

  3. Create and push tag that match the newly bumped version.

From here, rest of the jobs should be carried out by the GitHub and Gitea Actions. Whole pipeline of creating DTS release consists of two steps.

  • First is done on GitHub Actions. Here we build the DTS image and push the binaries to boot.dasharo.com.

  • Second is done on Gitea Actions. Here we push the ipxe menu to boot.3mdeb.com and sign the DTS binaries. The last step of Gitea Actions creates new release at the https://github.com/Dasharo/meta-dts/releases from where binaries can be downloaded.

Testing Dasharo firmware updates from local sources

By default the DTS uses https://3mdeb.com/open-source-firmware/Dasharo as a source of downloaded artifacts in case of community releases. This behaviour can be changed by starting dts script from the command line with FW_STORE_URL_DEV variable set to the http address that is serving the update files.

Below there is a list of steps that one need to do, to fetch binaries from local server.

  1. On host PC create dasharo-updates directory and from it start the http python module, as a port you can use e.g. 1234.

    mkdir dasharo-updates && cd dasharo-updates
python -m http.server 1234

  2. Inside dasharo-updates directory create the same folder structure as there is for your update files on https://3mdeb.com/open-source-firmware/Dasharo. E.g. for v1.7.2 of NovaCustom NS5X ADL you need to create path novacustom_ns5x_adl/v1.7.2/ and inside put binaries, hashes and signatures from that release.

  3. Boot DTS and start shell by pressing 9.

  4. Start dts script with FW_STORE_URL_DEV variable set to started server on the host PC. E.g. if the PC has IP address 192.168.1.14 use below command.

    FW_STORE_URL_DEV="http://192.168.1.14:1234" dts

  5. Normal dts menu entry will be displayed but any request to the server with binaries will be done to http://192.168.1.14:1234 instead of https://3mdeb.com/open-source-firmware/Dasharo.