Github Connection
GithubConnection
Defines the connection between the platform and a GitHub organization.
Provisions the API credentials, memberships and teams of the organization. It is the parent of its licenses, PR templates, secrets, repository templates and repositories.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be GithubConnection. |
| metadata | map | Reserved keys such as name and organization resolve the manifest identity and its parent Organization. |
| spec | Spec | User-authored specification of the connection. See Spec. |
Executors
Aggregate CI/CD runner footprint.
Requested counts of self-hosted runners by OS, summed from child build definitions.
| Property | Type | Description |
|---|---|---|
| ubuntu | int64 | Number of Ubuntu runners requested. |
| macos | int64 | Number of macOS runners requested. |
| windows | int64 | Number of Windows runners requested. |
ManagedWorkflowsPrivateEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | string |
ManagedWorkflowsPublicEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | string |
RelatedArtifactRegistriesEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedRelatedArtifactRegistry |
RelatedExternalRegistriesEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedRelatedExternalRegistry |
SecretsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedGithubSecretRepositories |
Spec
User-provided connection configuration.
Names the GitHub organization, the authentication method and the administrators.
| Property | Type | Description |
|---|---|---|
| description | string | Optional free-text description. The engine does not copy it to any GitHub resource. |
| owner | string | Name of the target GitHub organization (account owner). It is the root scope for all repository, team and secret generation. The engine compares it with the GitHub organization of the parent Organization to decide whether to reuse core credentials. Required. |
| authenticationMethod | string | How the engine authenticates to the GitHub API: PERSONAL_ACCESS_TOKEN or GITHUB_APP. With PERSONAL_ACCESS_TOKEN, the engine creates a secret in the core project to hold the token. Credential reuse currently depends on this value. |
| hostname | string | Hostname of the GitHub instance, for example github.my-company.com. Set it only for GitHub Enterprise Server. Defaults to github.com. Child repositories inherit it as connection_hostname. |
| administrators | list of string | GitHub usernames that get the admin role in the organization. The engine resolves each name through its OrganizationUser GitHub external account. Each administrator is also a maintainer on generated teams. |
ComputedGithubSecretRepositories
Relation between a GitHub secret and its target repositories.
Internal state. It tracks the repositories that received a GithubSecret manifest.
| Property | Type | Description |
|---|---|---|
| secretKey | string | Name of the secret. |
| repositories | list of string | Repositories that receive the secret. |
ComputedRelatedArtifactRegistry
Artifact Registry with its dependent repository names.
It links the registry of an environment to the application repositories built into it.
| Property | Type | Description |
|---|---|---|
| repositories | list of string | Names of the application repositories built into this registry. |
| registry | ComputedArtifactRegistry | The resolved Artifact Registry. |
ComputedRelatedExternalRegistry
External registry with its dependent repository names.
It links application repositories to an external registry.
| Property | Type | Description |
|---|---|---|
| repositories | list of string | Names of the application repositories that pull from this registry. |
| registry | ComputedExternalRegistry | The resolved external registry. |
ComputedExternalRegistry
Computed external container registry dependency.
It holds fields of an ExternalRegistry manifest and links the registry to the secrets with its credentials.
| Property | Type | Description |
|---|---|---|
| name | string | Copy of metadata.name. |
| type | string | Copy of spec.type. |
| publishUrl | string | Copy of spec.url. |
| authentication | string | Copy of spec.authentication. |
| usernameGcpSecretId | string | GCP resource StateID of the Secret manifest that the engine finds by the typical name <registryName>-username. |
| usernameSourceControlSecretId | string | Name of the GithubSecret manifest that the engine finds by the typical name <registryName>-username. |
| passwordGcpSecretId | string | GCP resource StateID of the Secret manifest that the engine finds by the typical name <registryName>-password. |
| passwordSourceControlSecretId | string | Name of the GithubSecret manifest that the engine finds by the typical name <registryName>-password. |
| region | string | GCP region of the external registry, used to resolve image paths. |
ComputedArtifactRegistry
Computed Artifact Registry resource.
The resolved state of an ArtifactRegistry manifest.
| Property | Type | Description |
|---|---|---|
| name | string | Copy of metadata.name. |
| type | string | Copy of spec.type. |
| publishUrl | string | URL that the engine composes from spec.type. |
| region | string | Copy of spec.region. |
| permissions | ArtifactRegistryAccessPermissions | Copy of spec.permissions, with user and group names resolved to full Google Cloud Identity identifiers. |
ArtifactRegistryAccessPermissions
Access levels for Artifact Registry repositories.
Readers get roles/artifactregistry.reader. Writers get roles/artifactregistry.writer.
| Property | Type | Description |
|---|---|---|
| readers | DetailedAccessPermissions | Users and groups with read-only access. |
| writers | DetailedAccessPermissions | Users and groups with read and write 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. |