Get started with the RustFS integration

Dette indhold er ikke tilgængeligt i dit sprog endnu.

⭐ Community Toolkit

RustFS is an S3-compatible object storage server. The Community Toolkit integration runs RustFS as an AppHost container, exposes its S3 and console endpoints, and can provision buckets when the server is ready.

Why use RustFS with Aspire

Add storage as a named resource and reference it from other AppHost resources.
Provision one or more buckets without a separate mc container.
Persist objects in a Docker volume or a host bind mount.
View the storage service and each bucket resource in the Aspire dashboard.

Prerequisites

The Aspire CLI and the other Aspire prerequisites.
Docker to run the RustFS container.
An S3-compatible client in each consuming application. The Toolkit package provides hosting APIs, not a client library.

How the integration fits together

The hosting package starts the RustFS container and exposes the S3 endpoint and web console. When the AppHost references the resource, Aspire provides an endpoint and credentials to the dependent app. The integration can also create buckets after the S3 endpoint is ready.

architecture-beta
  group apphost(server)[AppHost]
  group rustfs(server)[RustFS container]
  service hosting(server)[RustFS hosting integration] in apphost
  service resource(disk)[RustFS resource] in apphost
  service s3(api)[S3-compatible API] in rustfs
  service console(server)[Web console] in rustfs
  service app(server)[Application]
  hosting:R --> L:resource
  resource:R --> L:s3
  resource:R --> L:console
  app:L --> R:s3

Start using RustFS

Install the hosting package in the AppHost.
Aspire CLI — Tilføj CommunityToolkit.Aspire.Hosting.RustFs-pakke
aspire add rustfs
Aspire CLI er interaktiv; vælg det passende søgeresultat når du bliver spurgt:
Aspire CLI — Eksempel output
Select an integration to add: > rustfs (CommunityToolkit.Aspire.Hosting.RustFs) > Other results listed as selectable options...
Hvis der kun er ét resultat, vælges det automatisk. Du skal stadig bekræfte versionen.
C# — AppHost.cs
#:package CommunityToolkit.Aspire.Hosting.RustFs@*
XML — Tilføj CommunityToolkit.Aspire.Hosting.RustFs pakkereference
<PackageReference Include="CommunityToolkit.Aspire.Hosting.RustFs" Version="*" />
Add a RustFS resource and, optionally, one or more buckets. See Host RustFS in the AppHost for endpoint, credential, persistence, and bucket configuration.
Reference the RustFS resource or a bucket resource from a consuming project. See Connect to RustFS for connection properties and an S3 client example.