Component

core/storage/gcs

One Google Cloud Storage bucket, with the settings only Cloud Storage has, reached through Google's own API. A consumer reads the published bucket name, its gs:// address and its location, and calls the bucket with Google's client libraries as its own Google identity. There is no key slot: Google's API authenticates the caller's own Google identity, a service account or a workload identity, and access to the bucket is granted to that identity by IAM, outside the build. Reach for it where the consumer uses Google's client libraries with a Google identity, or needs a setting only Cloud Storage has, such as its storage class; and for core/storage/s3-object-store where the consumer speaks the S3 API with an access key, wherever it runs. Realized by terraform/gcs: the bucket is never public, because public access prevention is enforced and uniform bucket-level access is on, so access is granted by IAM alone and a request setting an object ACL is refused.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:2a079a8c5bcfff01c8390cf952924ffdbd35ef1ac9d290394f58fee1c6768222
Published
2026-11-10T10:13:59Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:b185cbd5594edeba80257da22472df69037391c37f474892bb2bd5fdfeef361e

Reference at this version

oci://hub.aggrega.ai/component/core/storage/gcs:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
bucketstring—yesName of the bucket, published as `bucket`. A bucket name is unique across the whole of Cloud Storage and publicly visible, so it carries nothing confidential; the Recipe refuses a name Cloud Storage does not take, naming the rule.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
locationstring—noWhere the bucket's data is stored, published as `location`: a region such as europe-west1, a dual-region such as EUR4 or a multi-region such as EU. There is no default: the build halts without one, because where the data lives is the operator's choice.
storage_classstringSTANDARDnoThe bucket's default storage class, given to every object written without one of its own: STANDARD, NEARLINE, COLDLINE or ARCHIVE.
versioningbooleanfalsenoWhether the bucket keeps a noncurrent version of an object each time the object is replaced or deleted. Off by default, as the cloud-storage module leaves it.
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
bucketstring—yesThe bucket's name, the one a consumer passes to Google's client libraries.
urlstring—yesThe bucket's gs:// address, gs:// followed by the bucket's name, the form Google's tools and many data libraries take.
locationstring—noWhere the bucket's data is stored, as the Release names it.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

No self-inject pipes declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

This entity uses nothing in the catalog.

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy