Github Repository Template
GithubRepositoryTemplate
Reusable template for new GitHub repositories.
A GithubRepository references it by name and uses only the resolved template name. The template provisions no GitHub resource itself.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be GithubRepositoryTemplate. |
| metadata | map | The engine reads the reserved keys name and organization to resolve the identity of the manifest and its parent GithubConnection and Organization. |
| spec | Spec | Template definition. See Spec. |
Spec
User-provided template definition.
Baseline settings for repositories that derive from this template.
| Property | Type | Description |
|---|---|---|
| public | bool | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: true makes derived repositories public, otherwise they are private. |
| description | string | Optional description. It is documentation only: the engine does not copy it to any GitHub resource. |
| name | string | Name of the template repository on GitHub. The engine uses it as is and adds no prefix. Default: metadata.name. |
| strategy | string | NOT YET IMPLEMENTED. The engine ignores this field. One of GIT_FLOW, GITHUB_FLOW or TRUNK_BASED. Intended use: branch protection rules on derived repositories. A GithubRepository fully applies its own strategy field. |
| codeOwners | list of CodeOwnersEntry | NOT YET IMPLEMENTED. The engine ignores this field. Map of path pattern to owners, intended for the .github/CODEOWNERS file. The permissions field drives code-owner aggregation instead. |
| pullRequest | PullRequestConfig | GithubPullRequestTemplate to use for derived repositories. See PullRequestConfig. |
| license | string | Name of the GithubLicense manifest to use. The engine validates it and resolves its content into computed.license. |
| permissions | AccessPermissions | Users and groups with admin, write or read access. The engine does not apply them as repository permissions. The admin and contributor groups and members feed the code-owner set of the parent Organization. |
CodeOwnerEntry
Code owners for a repository path.
Entry of the code_owners map, keyed by path pattern. Intended for a .github/CODEOWNERS file.
| Property | Type | Description |
|---|---|---|
| owners | list of string | GitHub team names or user handles that own the path. |
CodeOwnersEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | CodeOwnerEntry |
PullRequestConfig
Pull request template reference.
Selects the GithubPullRequestTemplate whose content seeds the pull request template of a derived repository.
| Property | Type | Description |
|---|---|---|
| template | string | Name of the GithubPullRequestTemplate manifest to use. It must exist under the same connection. |
AccessPermissions
Administrator, contributor, and viewer privileges for an asset.
The engine aggregates the users and groups into IAM policies.
| Property | Type | Description |
|---|---|---|
| administrators | DetailedAccessPermissions | Users and groups with administrative privileges, usually full control. |
| contributors | DetailedAccessPermissions | Users and groups with contributor privileges, usually read and write access. |
| viewers | DetailedAccessPermissions | Users and groups with viewer privileges, usually read-only access. |
DetailedAccessPermissions
User and group access definitions.
The engine resolves the listed manifests to Google Workspace identity emails for IAM bindings.
| Property | Type | Description |
|---|---|---|
| members | list of string | Names of OrganizationUser manifests. |
| groups | list of string | Names of OrganizationUserGroup manifests. |