Skip to main content

Artifact Registry

ArtifactRegistry​

A private Google Artifact Registry repository.

It stores container images or language packages, and can have TrustedRepository children. The engine adds scoped IAM bindings, and a Cloud Run proxy service for the BUF and DART formats.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be ArtifactRegistry.
metadatamapThe engine reads the reserved keys name and organization to resolve the identity and the parent Organization.
specSpecDesired repository configuration. See Spec.

Spec​

Desired repository configuration.

Format, region, public access, and reader and writer permissions.

PropertyTypeDescription
enabledboolNOT YET IMPLEMENTED. The engine ignores this field and always provisions the repository. Intended use: if false, omit the repository from the execution graph and destroy it.
descriptionstringOptional description. The engine copies it to the provisioned repository.
publicboolIf true, grants roles/artifactregistry.reader to allUsers, so anyone can pull artifacts without authentication. If false, only the principals in permissions have access.
typestringPackage format. Must be one of DOCKER, MAVEN, NPM, GO, PYTHON, HELM, BUF, DART, AGENT, or STATIC. The engine stores BUF and DART as GENERIC and serves them through a Cloud Run proxy. STATIC is a GENERIC store with no proxy. It holds static web bundles (tar.gz or zip) that REACT builds publish. A StaticAssetRoute serves them from a public Bucket (see target: CDN applications).
regionstringGCP region. Defaults to the default region of the parent Organization. The engine resolves it to a multi-region location.
permissionsArtifactRegistryAccessPermissionsUsers and groups of the organization that get roles/artifactregistry.reader (read) or roles/artifactregistry.writer (write). The engine validates them against the parent Organization. See ArtifactRegistryAccessPermissions.

ArtifactRegistryAccessPermissions​

Access levels for Artifact Registry repositories.

Readers get roles/artifactregistry.reader. Writers get roles/artifactregistry.writer.

PropertyTypeDescription
readersDetailedAccessPermissionsUsers and groups with read-only access.
writersDetailedAccessPermissionsUsers 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.

PropertyTypeDescription
memberslist of stringNames of OrganizationUser manifests.
groupslist of stringNames of OrganizationUserGroup manifests.