Эта страница переведена автоматически. Читать английский оригинал.

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.

Происхождение

ОфициальныйПодписано идентичностью подписи, которую этот каталог признаёт официальным издателем.
Дайджест содержимого
sha256:9548eb7db5f04218d18e6d0ac1a9b4b97da962f9211852e927b758b6cd82b46c
Опубликовано
2026-11-10T10:14:08Z
Идентичность подписи
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Подпись

  • Официальныйapplication/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

Ссылка на эту версию

oci://hub.aggrega.ai/component/core/storage/s3-object-store:1.0.0

Параметры разработчика

Значения, которые разработчик задаёт в сущности Aggregate.

ИмяТипПо умолчаниюОбязательныйОписание
bucketstring—да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.

Размеры, задаваемые оператором

Размеры инфраструктуры, которые оператор настраивает для каждого окружения.

ИмяТипПо умолчаниюОбязательныйОписание
regionstring—нет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.
overridesobject (open)—нетProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Контракт выходных значений

Значения, которые этот компонент публикует для потребителей через топологию uses.

ИмяТипПо умолчаниюОбязательныйОписание
bucketstring—да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.
regionstring—нет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.
endpointstring—да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.
hoststring—да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.
portinteger—даTCP port the S3 API accepts requests on, the one `endpoint` names or implies.
protocolstring—нетWire protocol the published address speaks — `s3`, so a consumer knows to reach it with an S3 client rather than a plain HTTP one.

Сокеты uses

Сокеты зависимостей, через которые подключается этот компонент. Цель каждого соединения, проведённого через сокет, должна удовлетворять его селектору меток, и каждое соединение может нести подключение в слотах, которые объявляет сокет. Обязательный слот должен заполнить каждое соединение, которое сущность Aggregate или сущность Release проводит через сокет.

Сокеты uses не объявлены.

Слоты подключения

Именованные точки привязки, в которых Feature подключается к этому компоненту. Селектор слота ограничивает, какая сущность Feature может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности Feature. Обязательный слот должен быть привязан в каждом экземпляре — подключением в самом экземпляре или в области выше него, — а конфиденциальный слот объявляется для работы с секретными материалами. Feature также может подключаться под именем, которое не объявляет ни один слот.

СлотСелекторОбязательныйВнедрениеКонфиденциальныйОписание
access_key_idfeature.aggrega.ai/kind=secretнетenvда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_keyfeature.aggrega.ai/kind=secretнетenvда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.

Список разрешённых самовнедрений

env

Связи

Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.

Использует

Эта сущность ничего не использует из каталога.

Используется в

Справочник по понятию Component →

Каталог Aggrega — открытый указатель компонентов, функций, рецептов и плагинов, которые их рендерят.

Создано на общей дизайн-системе Aggrega.

Конфиденциальность