RavenDB Cloud hosting integration for aspire deploy

オープン
  • 何か問題がありますか？
#2,412 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@poissoncorp がすでに取り組んでいます。

2026年11月6日 から。

  • #2413 @poissoncorp による — オープン

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
20/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
csharp, docker-compose
領域
backend, cloud

調査の方向性

Read the existing Hosting.RavenDB package and Aspire deployment pipeline APIs (ASPIREPIPELINES001/002), then trace how Docker Compose receives deploy-time values. The proposal also calls for client certificate and multi-node connection string support. Done means the preview package can provision or reuse RavenDB Cloud products, issue per-application certificates and show an approval-aware deployment plan; an open pull request already exists.

索引モデルが issue の本文から書いたものです。

説明

Aspire issue link

No response

Overview

aspire run starts RavenDB in a local container, but aspire deploy cannot point the applications at a managed RavenDB. Today each team creates a RavenDB Cloud product by hand, downloads a certificate, and wires the URL and the certificate into every application, for every environment.

Proposal: a new preview package, CommunityToolkit.Aspire.Hosting.RavenDB.Cloud, that makes RavenDB Cloud the deployment target of the existing RavenDB resource:

  • aspire deploy creates the product from an explicit spec, or finds an existing one by name.
  • Every application that references the server gets the product's node URLs and a client certificate of its own, with admin access to its own databases only, issued anew on every deployment.
  • A plan step shows what the deployment will do before anything is built. Changes to a paid product need explicit approval, and what RavenDB Cloud cannot change stops the deployment.
  • aspire run is unchanged: it still starts the local container.

The values reach the applications as deploy-time values of the compute environment; the first version supports Docker Compose.

Usage example
builder.AddDockerComposeEnvironment("compose");

var apiKey = builder.AddParameter("ravendb-cloud-api-key", secret: true);

var orders = builder.AddRavenDB("ravendb")
    .PublishAsRavenDBCloud(
        apiKey,
        "shop-production",
        RavenDBCloudSpec.Production(
            RavenDBCloudProvider.Azure,
            region: "westeurope",
            instanceType: "P20",
            diskSizeInGb: 128,
            RavenDBCloudStorageType.SsdStandard,
            RavenDBCloudDiskLayout.SingleDataDisk,
            releaseChannel: "Stable72"),
        cloud => cloud.WithAllowedIps("203.0.113.0/24"))
    .AddDatabase("orders", ensureCreated: true);

builder.AddProject<Projects.Api>("api").WithReference(orders);

A product that already exists and is shared by several AppHosts: PublishAsExistingRavenDBCloud(apiKey, "shared-product", clientName: "billing").

Additional context
  • The base Hosting.RavenDB package gains a small experimental API for deployment packages (CTASPIRERAVENDB001). The client gains CertificateBase64, so a certificate can arrive as a value, and accepts several node URLs in the connection string.
  • The package builds on Aspire's deployment pipeline APIs (ASPIREPIPELINES001/002), hence a separate preview package; the base package stays free of experimental Aspire APIs.
  • Azure Container Apps would carry the certificate as a plain template parameter, so it is left for a follow-up through Key Vault. Kubernetes is planned as a separate package built on the RavenDB operator.
  • Maintained by the RavenDB team, which owns the existing RavenDB packages. The implementation is ready and verified end to end against RavenDB Cloud.
Help us help you

Yes, I'd like to be assigned to work on this item

主要言語
C#
スター
632
フォーク
204
平均マージ
2日 18時間
マージ済み PR（30日）
99

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

CommunityToolkit/Aspire のほかの issue

CommunityToolkit/Aspire の issue をすべて見る

似ている issue

C# の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。