Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Component

core/datastore/opensearch

An OpenSearch search and analytics engine. Indexes documents for full-text and analytical queries and indexes embedding vectors beside them, answering similarity searches through its k-NN plugin, so a component that retrieves by similarity can be wired here. Indexes are created through OpenSearch's own API at runtime; the component declares the server, not its contents. It runs as one node. Exports its host, port, protocol, an endpoint joining them and the account a client signs in as. The security plugin stays on with one account, the administrator, whose password is the attached credential. Realized self-hosted by the product's own Helm chart on Kubernetes, fetched at build time, and by a Compose Recipe for local development. Each runs the product's image with no demonstration account or certificate, each node generating its own transport key when it starts; the API is served over plain HTTP, not encrypted, reachable only inside the Release, and with no credential attached the password is a development default. Realized on Amazon OpenSearch Service by terraform/opensearch-service and, in a CloudFormation stack, cloudformation/opensearch-service: each a domain in the operator's AWS account and VPC that serves HTTPS alone on port 443 and answers similarity searches through the service's own k-NN support, and each halts unless core/random-password, with values.symbols true, supplies the password. Reach for them where the engine is the operator's managed AWS service; reach for the self-hosted Recipes on a cluster or a Docker host. The Recipes are verified by their rendered output, not by a started server.

Provenienza

UfficialeFirmato da un’identità di firma che questo catalogo riconosce come editore ufficiale.
Digest del contenuto
sha256:eb87045f077ae39210c3844a719977680bd1cf0fb23b1ff237b18c7e2b599551
Pubblicato
2026-11-10T10:10:59Z
Identità di firma
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Firma

  • Ufficialeapplication/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:a1ce0ac66f5099cba15bdcd4c4f9abe79266d649b0a04172e66027a04c4b289d

Riferimento a questa versione

oci://hub.aggrega.ai/component/core/datastore/opensearch:1.0.0

Parametri dello sviluppatore

Valori che lo sviluppatore imposta nell’Aggregate.

Nessun parametro dello sviluppatore dichiarato.

Dimensionamento dell’operatore

Dimensionamento dell’infrastruttura che l’operatore regola per ogni ambiente.

NomeTipoPredefinitoObbligatorioDescrizione
portinteger (min 1024, max 65535)9200noPort the server's REST API is published on. Most operators should omit this and let the Recipe assign the default (9200). The server listens on it on both self-hosted targets; on Kubernetes it is also the Service port. The OpenSearch Service realizations do not read it: the domain serves port 443 alone, and any other value than the default halts there.
engine_versionstring3.9.0@sha256:adfa61f85025d06b4aeb562e7e74fde7e31c437039c93c3862c17e9acebd6c7cnoTag of the opensearchproject/opensearch image every Recipe runs, optionally followed by @ and the digest it must resolve to. It begins with the release's version number, which the Kubernetes Recipe reads its major version from. The Recipes configure the server through the settings of the 3.x releases; another release may need other ones. The OpenSearch Service realizations read the major and minor version the value begins with as the domain's engine version, among those Amazon OpenSearch Service offers; the default names a release it does not run, so it halts there and the Release sets one it offers, such as 3.5.
source_versionstring—noVersion of the Helm chart the Kubernetes Recipe pulls. Read only by that Recipe; the Compose Recipe pulls no source artifact and ignores it, terraform/opensearch-service pins its module in its own lock and ignores it too, and cloudformation/opensearch-service, which pulls nothing, ignores it as well. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart.
computeobject—no—
storageobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contratto di output

Valori che questo componente pubblica verso i consumatori attraverso la topologia uses.

NomeTipoPredefinitoObbligatorioDescrizione
hoststring—sìAddress a client connects to. On Kubernetes it is the Service's DNS name, and on Compose the service name; on the OpenSearch Service realizations a pointer string Terraform or CloudFormation resolves to the domain's endpoint, or the DNS name the Release sets in infra.overrides.host instead, so a consumer on another target receives an address it can resolve. That name becomes the domain's custom endpoint, which presents the AWS Certificate Manager certificate the Release names beside it, in infra.overrides.custom_endpoint_certificate_arn on terraform and infra.overrides.CustomEndpointCertificateArn on CloudFormation, so a client checking the certificate reaches the domain by that name; a name without a certificate halts, and so does a certificate without a name.
portinteger—sìTCP port the server's REST API answers on. On the self-hosted Recipes it follows the port an operator set in the Release, so a consumer reads it rather than assuming 9200; on the OpenSearch Service realizations it is 443, the one port the domain serves.
userstring—noName of the account a client signs in as — `admin`, the server's one account, which on Amazon OpenSearch Service is the domain's master user. The matching password arrives through the credential attached to the component, never through this contract.
protocolstring—noScheme a client composes the server's address with — `http` on the self-hosted Recipes, as in http://<host>:<port>, where the REST API is served over plain HTTP, and `https` on the OpenSearch Service realizations, whose domain accepts HTTPS alone. A client composing the address from its parts reads this key rather than assuming either.
endpointstring—noThe server's address as one URI, for a client that takes one address rather than its parts: http://<host>:<port> on the self-hosted Recipes, and https://<host> on the OpenSearch Service realizations, the scheme's own port 443. It carries no credential.

Socket uses

I socket di dipendenza attraverso cui questo componente si connette. La destinazione di ogni connessione collegata attraverso un socket deve soddisfare il suo selettore di etichette, e ogni connessione può portare un aggancio negli slot che il socket dichiara. Uno slot obbligatorio deve essere riempito da ogni connessione che l’Aggregate o la Release collega attraverso il socket.

Nessun socket uses dichiarato.

Slot di aggancio

Punti di associazione con nome in cui una Feature si aggancia a questo componente. Il selettore di uno slot limita quale Feature può riempirlo e la sua lista inject indica come può essere consegnato il materiale della Feature. Uno slot obbligatorio deve essere associato su ogni istanza, da un aggancio sull’istanza o a un ambito superiore, e uno slot sensibile è dichiarato per gestire materiale segreto. Una Feature può anche agganciarsi con un nome che nessuno slot dichiara.

SlotSelettoreObbligatorioIniezioneSensibileDescrizione
passwordfeature.aggrega.ai/kind=secretnoenvsìOptional password of the server's administrator account, admin. When attached, the Kubernetes Recipe reads it from the credential's Secret by reference and the Compose Recipe writes the value the credential delivers; unattached, compose/opensearch and helm/opensearch-chart set it to the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password, and attaching a credential replaces it. The OpenSearch Service realizations take core/random-password alone, with values.symbols true so the password holds every character class — as a reference to the password Terraform draws at apply time on terraform, as a Secrets Manager dynamic reference to the secret the stack generates on CloudFormation — and halt on any other credential, on punctuation left off, or on none.

Elenco consentito di auto-iniezione

env

Relazioni

Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.

Usa

Questa entità non usa nulla del catalogo.

Usato da

Riferimento al concetto Component →

Il catalogo Aggrega — un indice aperto di componenti, funzionalità, ricette e dei plugin che li renderizzano.

Realizzato con il design system condiviso di Aggrega.

Privacy