Sourcehut Build Manifest Json Format

image - Which OS image to build in. A list of available build images can be found at https://man.sr.ht/builds.sr.ht/compatibility.md

arch - Which architecture to build for. See https://man.sr.ht/builds.sr.ht/compatibility.md for a list of available architectures.

packages A list of packages to install on the image. For image-specific details, consult https://man.sr.ht/builds.sr.ht/compatibility.md

#	Values	Actions
{{$index+1}}.

.repositories

_

shell - Whether to keep the build VM alive after all of the tasks have finished, even if it doesn't fail, so you can SSH in. You can also SSH in before the tasks have finished and tail the output of the build in your terminal. Learn more at https://man.sr.ht/builds.sr.ht/build-ssh.md

artifacts A list of files to extract from the completed build environment and make available for downloading from the jobs page. Artifacts are only uploaded for successful jobs and are pruned after 90 days. Note that the file names are interpreted literally: do not use ~ or any shell code. If a relative path is used (e.g. example/my-artifact.tar.gz), it will be interpreted relative to the build user's home directory.

#	Values	Actions
{{$index+1}}.

sources A list of repositories to clone into the home directory of the build user in the build environment. Optionally, prefix the protocol with the source control management scheme, to specify a protocol other than git. To specify a non-default git revision, append #commit-object to the repository.

#	Values	Actions
{{$index+1}}.

tasks A list of scripts to execute in the build environment. Task names must use only lowercase alphanumeric characters, underscores or dashes and must be <=128 characters in length. Tasks are executed in the order specified. Each task is run in a separate login session, so if you modify the groups of the build user they will be effective starting from the subsequent task.

#	Actions
{{$index+1}}.

triggers A list of triggers to execute post-build, which can be used to send emails or do other post-build tasks. Learn more at https://man.sr.ht/builds.sr.ht/triggers.md

#	action	condition	Actions
{{$index+1}}.

.environment

_

oauth - If present, and secrets are enabled for this build, an OAuth 2.0 bearer token is generated for this build with the given string as the list of grants. The acurl command may be used in the task scripts to perform authenticated GraphAL API requests (https://man.sr.ht/graphql.md).

secrets List of secret UUIDs to be added to the guest during the build. Learn more at https://man.sr.ht/builds.sr.ht/#secrets

#	Values	Actions
{{$index+1}}.

ToolMatter

Your Apps in Action

Use this form to visualize Sourcehut Build Manifest.

{{repoTitle.MainEntity}}

packages A list of packages to install on the image. For image-specific details, consult https://man.sr.ht/builds.sr.ht/compatibility.md

_

sources A list of repositories to clone into the home directory of the build user in the build environment. Optionally, prefix the protocol with the source control management scheme, to specify a protocol other than git. To specify a non-default git revision, append #commit-object to the repository.

triggers A list of triggers to execute post-build, which can be used to send emails or do other post-build tasks. Learn more at https://man.sr.ht/builds.sr.ht/triggers.md

_

secrets List of secret UUIDs to be added to the guest during the build. Learn more at https://man.sr.ht/builds.sr.ht/#secrets

{{repoTitle.MainEntity}}

{{repoTitle.MainEntity}}