Skip to content

ezgh build connections create

Connect an EZGH Git repository.

Updated View as Markdown
ezgh build connections create --name n --repository r [--bot b] [--trusted-ref glob]… [flags]

Connect an EZGH Git repository (gtr_… or its name) to the project: pushes to it then run its .ezgh/build.yaml. A GitHub repository is connected in the console, which installs the GitHub App.

Tasks’ sandboxes, cache and checks are the work of a Bot. Without --bot one is made for the connection, named build-<name>, with SandboxesFullAccess, RegistryFullAccess and GitBuildAccess, and trusted to be used by EZGH Build for this repository; with --bot an existing Bot is used as it is. --trusted-ref (a full ref glob, repeatable) says which refs may write the cache every ref reads; without it, the repository’s default branch.

Part of ezgh build connections.

Examples

ezgh build connections create --name app --repository app
ezgh build connections create --name app --repository gtr_4k2m9x0a7qpe --bot build --trusted-ref refs/heads/main --trusted-ref 'refs/tags/v*'

Flags

Flag Type Default Description
--bot string an existing Bot to run as, instead of making one
--name string the connection’s name
--repository string the EZGH Git repository, by ID (gtr_…) or name
--trusted-ref string, repeatable a full ref glob whose runs are trusted (default: the default branch); repeat for more

Inherited from parent commands:

Flag Type Default Description
--dir string . the repository’s checkout (any directory inside it)
--json boolean print JSON, as -o json does

This command also takes the global flags.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close