Get started with the RustFS integration

⭐ 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

1. Install the hosting package in the AppHost.

   Aspire CLI

   Aspire CLI — CommunityToolkit.Aspire.Hosting.RustFs पैकेज जोड़ें

   aspire add rustfs

   Aspire CLI इंटरैक्टिव है; प्रॉम्प्ट पर उपयुक्त परिणाम चुनें:

   Aspire CLI — उदाहरण आउटपुट

   Select an integration to add:
   
   > rustfs (CommunityToolkit.Aspire.Hosting.RustFs)
   > Other results listed as selectable options...

   टिप्पणी

   यदि केवल एक परिणाम है तो वह स्वचालित रूप से चुना जाएगा। संस्करण की पुष्टि अभी भी करनी होगी।
   apphost.cs (C# file-based app)

   C# — AppHost.cs

   #:package CommunityToolkit.Aspire.Hosting.RustFs@*

   PackageReference (*.csproj)

   XML — CommunityToolkit.Aspire.Hosting.RustFs पैकेज संदर्भ जोड़ें

   <PackageReference Include="CommunityToolkit.Aspire.Hosting.RustFs" Version="*" />

2. Add a RustFS resource and, optionally, one or more buckets. See Host RustFS in the AppHost for endpoint, credential, persistence, and bucket configuration.

3. Reference the RustFS resource or a bucket resource from a consuming project. See Connect to RustFS for connection properties and an S3 client example.

See also

• Host RustFS in the AppHost
• Connect to RustFS
• RustFS documentation
• 📦 CommunityToolkit.Aspire.Hosting.RustFs