Skip to content

[EN] lilac FAQ

Chih-Hsuan Yen edited this page Jun 28, 2024 · 6 revisions

lilac packaging FAQ

Q: How can I access the full lilac packaging log?

lilac log is stored at /home/lilydjwg/.lilac/ on the archlinuxcn build machine. There are two types of log available:

  • build.log: The full-sized result log of packaging. You can get the status, timestamp and the duration of each single package job from this log.
  • log/<TIMESTAMP>: These log files contain elaborate information of the lilac packaging job. It contains detailed error log, the result of dependency resolution, etc. These files are named in timestamp format. For example a file named 2018-11-10T09:13:01 stands for a the log of a set of packaging job which starts at 2018-11-10 09:13:01 (UTC+8).

Q: My package failed to build, Why doesn't lilac retry it?

Many packages fail to be built because of inconsistent PKGBUILD/lilac configuration. If maintainer doesn't manually fix the configuration error, repackaging these packages is not only useless, but also a waste of resource of build machine. Therefore lilac won't rebuild a failed package until a new commit of the package is pushed to repo. For maintainers, you need to manually update the package (e.g modify PKGBUILD, lilac.py or lilac.yaml) to trigger a rebuild. Then your package will be built in the next lilac job cycle. If there is nothing to modify (e.g building is failing due to temporary network failure), you can trigger lilac to rebuild using the following way.

Q: How to manually trigger lilac to rebuild my package

There are two ways:

  • You can add a manual: field under the update_on: update conditions in lilac.yaml, or change the parameter value of an existing manual: field. There can be multiple update conditions defined under update_on: , and you can list manual: under all other update conditions.
  • If you want to trigger lilac outside scheduled time, you can login https://build.archlinuxcn.org/triggerabuild/ via the GitHub account and add package names to the queue.

Q: How can I make changes to PKGBUILD from the upstream(e.g AUR) before the package phase?

You need to use a customized pre-build function, You can modify PKGBUID in the pre_build with sed or lilac built-in edit_file function as recommended by archlinuxcn community. Examples can be found with command git grep edit_file. lines is used for scanning in the PKGBUILD, and print is used for writing to PKGBUILD. Refer to archlinuxcn/repo for more information.

Q: Can I run lilac locally on my machine?

It's not recommended to run the full lilac build on your local machine. However, you can run lilac for a single package job locally. Instructions on configure the lilac can be found at archlinuxcn/lilac. The following are some precautions:

  • single_main accepts the first argument as build_prefix which default sets to makepkg. If you want to use other build prefixes such as extra-x86_64-build. You need to explicitly pass the argument to single_main
  • single_main won't perform any dependency resolution, thus if dependency are declared in lilac.py / lilac.yaml, your package will fail the local build.

Q: lilac send me a build log saying building was fail due to source file checksum mismatch. Both source files and checksums are updated and it might be due to lilac is caching the old file. How can I delete the cached files?

Please ssh build.archlinuxcn.org and run command sudo cleanup-package-files <pkgbase> to check the list of cached source files by lilac. After the confirmation you can remove those cached files by sudo cleanup-package-files --real <pkgbase> command.