Skip to content

Latest commit

 

History

History
69 lines (45 loc) · 2.22 KB

README.md

File metadata and controls

69 lines (45 loc) · 2.22 KB
Raw

Workflow Build Packages (codename Project Cake)

Syntax

/build <Package> [<Package> ...]

/build

Description

The /build command builds packages via GitHub Actions. It starts clean, up-to-date instances of buildkit container, runs acbs-build to build packages.

When replying the command under an issue, packages are built from stable branch. When replying the command under a pull request, packages are built from the source branch of the pull request.

If packages are specified, only these packages will be built. If no packages are specified and the command is replied under a pull request, all packages which have spec file changed will be built.

If you would like for the workflow to run as a status check, prefix your pull request title with [ci].

It's also possible to run this workflow manually1 or using the REST API2.

Examples

Example 1: Building One Package

/build aosc-aaa

Example 2: Building Multiple Packages

/build openssl openssl+32

Example 3: Building A Group Of Packages

/build groups/dotnet

Example 4: Building All Changed Packages In A Pull Request

/build

Notes

  • Currently, this command only supports GitHub-hosted runners.
    • Microsoft Azure's Standard_DS2_v2 virtual machines only support x86-64 (amd64) architecture and may not have sufficient performance or storage to build some packages.
    • GitHub-hosted runners currently provide no TTY device3, any build that relies on this will fail.
  • Up to 256 packages could be built at a time.

Further Reading

Explanation on the codename

The cake is a lie4! Though Project Cake is an effort to augment AOSC OS's ongoing maintenance automation project5, it will only work in simple scenarios.

Footnotes

  1. https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow ↩

  2. https://docs.github.com/en/rest/reference/actions#create-a-workflow-dispatch-event ↩

  3. https://github.com/actions/runner/issues/241#issuecomment-556845290 ↩

  4. https://en.wikipedia.org/wiki/The_cake_is_a_lie ↩

  5. https://wiki.aosc.io/developer/automation/ ↩