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
- 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.0Developer parameters
Values the developer sets in the Aggregate.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| bucket | string | — | yes | Name 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.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| location | string | — | no | Where 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_class | string | STANDARD | no | The bucket's default storage class, given to every object written without one of its own: STANDARD, NEARLINE, COLDLINE or ARCHIVE. |
| versioning | boolean | false | no | Whether 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. |
| overrides | object (open) | — | no | Provider-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.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| bucket | string | — | yes | The bucket's name, the one a consumer passes to Google's client libraries. |
| url | string | — | yes | The bucket's gs:// address, gs:// followed by the bucket's name, the form Google's tools and many data libraries take. |
| location | string | — | no | Where 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
uses socket «store»
uses socket «store»
uses socket «event_store»
uses socket «objstore»
implements