Seq hosting integration

The Seq hosting integration models a Seq resource as the SeqResource type. To access this type and APIs, add the 📦 Aspire.Hosting.Seq NuGet package in your AppHost project:

Aspire CLI

Aspire CLI — Adicionar pacote Aspire.Hosting.Seq

aspire add seq

A CLI Aspire é interativa; escolhe o resultado apropriado quando solicitado:

Aspire CLI — Exemplo de saída

Select an integration to add:

> seq (Aspire.Hosting.Seq)
> Other results listed as selectable options...

Nota

Se existir apenas um resultado ele é selecionado automaticamente. Ainda assim confirma a versão.

apphost.cs (C# file-based app)

C# — AppHost.cs

#:package Aspire.Hosting.Seq@*

PackageReference (*.csproj)

XML — Adicionar referência de pacote Aspire.Hosting.Seq

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

Add a Seq resource

In your AppHost project, call AddSeq to add and return a Seq resource builder:

C# — AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

var seq = builder.AddSeq("seq")
                 .ExcludeFromManifest()
                 .WithLifetime(ContainerLifetime.Persistent)
                 .WithEnvironment("ACCEPT_EULA", "Y");

var myService = builder.AddProject<Projects.ExampleProject>()
                       .WithReference(seq)
                       .WaitFor(seq);

Nota

The Seq container may be slow to start, so it’s best to use a persistent lifetime to avoid unnecessary restarts. For more information, see Container resource lifetime.

Accept the Seq End User License Agreement (EULA)

You must accept the Seq EULA for Seq to start. To accept the agreement in code, pass the environment variable ACCEPT_EULA to the Seq container, and set its value to Y.

Seq in the Aspire manifest

Seq shouldn’t be part of the Aspire deployment manifest, hence the chained call to ExcludeFromManifest. It’s recommended you set up a secure production Seq server outside of Aspire for your production environment.

Add a Seq resource with a data volume

To add a data volume to the Seq resource, call the WithDataVolume method:

C# — AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

var seq = builder.AddSeq("seq")
                 .WithDataVolume()
                 .ExcludeFromManifest()
                 .WithLifetime(ContainerLifetime.Persistent);

var myService = builder.AddProject<Projects.ExampleProject>()
                       .WithReference(seq)
                       .WaitFor(seq);

The data volume is used to persist the Seq data outside the lifecycle of its container.