GCP.ArtifactRegistry reference

ListDockerImages

Source: src/GCP/ArtifactRegistry/ListDockerImages.ts

Runtime binding for Artifact Registry dockerImages.list.

Bind this operation to a Repository in a Function/Action init phase. Provide ListDockerImagesHttp.

ListDockerImages: Listing Docker Images

const listImages = yield* GCP.ArtifactRegistry.ListDockerImages(images);
const page = yield* listImages({ pageSize: 50 });

ListDockerImagesHttp

Source: src/GCP/ArtifactRegistry/ListDockerImagesHttp.ts Kind: Layer · Provides: GCP.ArtifactRegistry.ListDockerImages

HTTP implementation of ListDockerImages.

RepositoriesAttachment

Source: src/GCP/ArtifactRegistry/RepositoriesAttachment.ts

Artifact Registry metadata attached to a repository, package, or version. An attachment points at one or more files already stored in the repository.

Attachments have no update API — any change replaces the resource. Alchemy stamps ownership into annotations so list / nuke can find them.

RepositoriesAttachment: Creating a RepositoriesAttachment

const attachment = yield* GCP.ArtifactRegistry.RepositoriesAttachment(
  "Sbom",
  {
    repository: artifacts.name,
    target: artifacts.name,
    type: "application/spdx+json",
    files: [sbomFileName],
    annotations: { env: "prod" },
  },
);

RepositoriesPackagesTag

Source: src/GCP/ArtifactRegistry/RepositoriesPackagesTag.ts

An Artifact Registry package tag — an alternate name for a version.

Tags have no labels field. list / nuke find tags whose parent repository carries Alchemy labels. Changing repository, packageId, location, or tagId replaces the tag. version updates in place.

The package and version must already exist (for example a Docker image digest). Generic repositories reject tag create with HTTP 501.

RepositoriesPackagesTag: Creating a RepositoriesPackagesTag

Point stable at a version

const tag = yield* GCP.ArtifactRegistry.RepositoriesPackagesTag("Stable", {
  repository: images.name,
  packageId: "app",
  tagId: "stable",
  version: "sha256:abc123",
});

Move the tag to a new version

const tag = yield* GCP.ArtifactRegistry.RepositoriesPackagesTag("Stable", {
  repository: images.name,
  packageId: "app",
  tagId: "stable",
  version: "sha256:def456",
});

RepositoriesRule

Source: src/GCP/ArtifactRegistry/RepositoriesRule.ts

An Artifact Registry download rule on a repository.

Download rules are a Preview API. Each repository may have one repository-level rule and one rule per package. Changing repository, location, or ruleId replaces the rule. action, operation, packageId, and condition update in place.

Rules have no labels field. Alchemy stamps ownership into condition.title so list / pnpm nuke:gcp can find them.

RepositoriesRule: Creating a RepositoriesRule

Deny all downloads

const rule = yield* GCP.ArtifactRegistry.RepositoriesRule("Deny", {
  repository: images.name,
  action: "DENY",
});

Allow a package except old versions

const rule = yield* GCP.ArtifactRegistry.RepositoriesRule("AllowApp", {
  repository: images.name,
  action: "ALLOW",
  packageId: "app",
  condition: { expression: "pkg.version.id >= '1.0.0'" },
});

Repository

Source: src/GCP/ArtifactRegistry/Repository.ts

An Artifact Registry repository for Docker images, language packages, or generic artifacts.

Changing repositoryId, location, format, mode, kmsKeyName, or Maven version policy replaces the repository.

Repository: Creating a Repository

Generated name

const images = yield* GCP.ArtifactRegistry.Repository("Images", {});

Explicit id, format, and labels

const images = yield* GCP.ArtifactRegistry.Repository("Images", {
  repositoryId: "app-images",
  location: "us-central1",
  format: "DOCKER",
  description: "container images",
  labels: { env: "prod" },
  dockerConfig: { immutableTags: true },
});