Component
core/storage/s3-object-store
One object-storage bucket reached over the S3 API with an access key. A consumer points its S3 client at the published endpoint, signs for the published region and reads the published bucket, which is the bucket the store holds, so a consumer naming a bucket of its own checks it against this one. A consumer holds the key it presents on its own connection. The two key slots are a self-hosted server's own account, which SeaweedFS requires; a managed service issues its keys to its own principals outside the build, and its realization refuses an attached slot by name. Reach for it where the consumer speaks the S3 API with an access key, wherever it runs; and for core/storage/gcs where it uses Google's client libraries with a Google identity, or needs a setting only Cloud Storage has. Realized on Amazon S3, in an AWS account, by terraform/s3-object-store-amazon-s3 through Terraform and by cloudformation/s3-object-store-amazon-s3 in a CloudFormation stack: every public access is blocked, ACLs are disabled, and a consumer brings an IAM principal's access key. Realized on Google Cloud Storage, in a Google Cloud project, by terraform/s3-object-store-gcs, over its XML API: the bucket is never public, a consumer brings a Cloud Storage HMAC key, and an object ACL is refused under uniform bucket-level access. Realized on SeaweedFS, run in a cluster by helm/s3-object-store or on a Compose host by compose/s3-object-store with nothing else in place: the server creates the bucket, serves plain HTTP, and a consumer brings the key pair the slots hold.
Procedência
- Digest do conteúdo
- sha256:9548eb7db5f04218d18e6d0ac1a9b4b97da962f9211852e927b758b6cd82b46c
- Publicado
- 2026-11-10T10:14:08Z
- Identidade de assinatura
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Assinatura
- Oficialapplication/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:33587ea3c49984c9cec47ab460d42040455e6f3f7b99e71c4abd6e649cb3d658
Referência nesta versão
oci://hub.aggrega.ai/component/core/storage/s3-object-store:1.0.0Parâmetros do desenvolvedor
Valores que o desenvolvedor define no Aggregate.
| Nome | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
| bucket | string | — | sim | Name of the bucket the store holds, published as `bucket`. Each realization refuses a name its service does not take, naming the rule; on Cloud Storage a bucket name is unique across the whole service, and on Amazon S3 across its partition, and on both it is publicly visible, so it carries nothing confidential. |
Dimensionamento do operador
Dimensionamento de infraestrutura que o operador ajusta por ambiente.
| Nome | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
| region | string | — | não | Where the bucket is placed, published as `region`, the region a consumer's S3 client signs for. There is no default: a managed realization halts without one, because where the data lives is the operator's choice. On Amazon S3 it is the bucket's Region code, such as eu-west-1, and a CloudFormation stack is held to that Region. On Cloud Storage it is the bucket's location — a region such as europe-west1, a dual-region such as EUR4 or a multi-region such as EU — and Cloud Storage accepts any region in a signature. SeaweedFS reads none, so its realizations halt when it is set and publish us-east-1, which S3 clients read from a server reporting no region. |
| overrides | object (open) | — | não | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contrato de saída
Valores que este componente publica para os consumidores pela topologia uses.
| Nome | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
| bucket | string | — | sim | The bucket the store holds. A consumer reads its objects from this bucket; one that names a bucket of its own checks it against this one. |
| region | string | — | não | The region a consumer's S3 client signs its requests for: on a managed service the bucket's own location as the Release names it, and on SeaweedFS us-east-1, since the server reads none. |
| endpoint | string | — | sim | Base URL of the S3 API — scheme, host and, where it is not the scheme's default, port — the address a consumer points its S3 client at. The scheme is the one the store is reached over, so a consumer takes the address as published rather than assuming http. |
| host | string | — | sim | Host name of the S3 API. A consumer that composes its own address dials this name together with `port`; one that does not reads `endpoint` instead. |
| port | integer | — | sim | TCP port the S3 API accepts requests on, the one `endpoint` names or implies. |
| protocol | string | — | não | Wire protocol the published address speaks — `s3`, so a consumer knows to reach it with an S3 client rather than a plain HTTP one. |
Sockets uses
Os sockets de dependência pelos quais este componente se conecta. O destino de cada conexão ligada por um socket deve satisfazer o seletor de rótulos dele, e cada conexão pode carregar um acoplamento nos slots que o socket declara. Cada conexão que o Aggregate ou a Release liga pelo socket deve preencher os slots obrigatórios.
Nenhum socket uses declarado.
Slots de acoplamento
Pontos de vinculação nomeados nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual Feature pode preenchê-lo, e sua lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório deve estar vinculado em cada instância, por um acoplamento na instância ou em um escopo acima dela, e um slot sensível é declarado para lidar com material secreto. Uma Feature também pode se acoplar com um nome que nenhum slot declara.
| Slot | Seletor | Obrigatório | Injeção | Sensível | Descrição |
|---|---|---|---|---|---|
| access_key_id | feature.aggrega.ai/kind=secret | não | env | sim | Access key identifier of the store's own account, for a store that takes a key pair of its own: SeaweedFS takes the pair as its S3 identity, and its realizations halt when this slot is empty. A managed service issues its keys to its own principals outside the build, so the Amazon S3 and Cloud Storage realizations refuse an attachment here by name. A consumer presents its own key on its own connection. |
| secret_access_key | feature.aggrega.ai/kind=secret | não | env | sim | Secret access key of the store's own account, the pair of access_key_id, for a store that takes a key pair of its own: SeaweedFS takes the pair as its S3 identity, and its realizations halt when this slot is empty. A managed service issues its keys to its own principals outside the build, so the Amazon S3 and Cloud Storage realizations refuse an attachment here by name. A consumer presents its own key on its own connection. |
Lista de permissões de autoinjeção
env
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.
Usa
Esta entidade não usa nada do catálogo.
Usado por
usa o socket «store»
usa o socket «store»
usa o socket «event_store»
usa o socket «objstore»
implementa
implementa
implementa
implementa
implementa