PostgresBuilderExtensions.AddPostgres Method

Definition

Namespace:: Aspire.Hosting

Assembly:: Aspire.Hosting.PostgreSQL.dll

Package:: Aspire.Hosting.PostgreSQL v8.2.0

Package:: Aspire.Hosting.PostgreSQL v9.0.0

Package:: Aspire.Hosting.PostgreSQL v9.1.0

Package:: Aspire.Hosting.PostgreSQL v9.2.0

Package:: Aspire.Hosting.PostgreSQL v9.3.0

Source:: PostgresBuilderExtensions.cs

Source:: PostgresBuilderExtensions.cs

Source:: PostgresBuilderExtensions.cs

Source:: PostgresBuilderExtensions.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Adds a PostgreSQL resource to the application model. A container is used for local development.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.PostgresServerResource> AddPostgres(this Aspire.Hosting.IDistributedApplicationBuilder builder, string name, Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource>? userName = default, Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource>? password = default, int? port = default);

static member AddPostgres : Aspire.Hosting.IDistributedApplicationBuilder * string * Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource> * Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource> * Nullable<int> -> Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.PostgresServerResource>

<Extension()>
Public Function AddPostgres (builder As IDistributedApplicationBuilder, name As String, Optional userName As IResourceBuilder(Of ParameterResource) = Nothing, Optional password As IResourceBuilder(Of ParameterResource) = Nothing, Optional port As Nullable(Of Integer) = Nothing) As IResourceBuilder(Of PostgresServerResource)

Parameters

builder: IDistributedApplicationBuilder

The IDistributedApplicationBuilder.

name: String

The name of the resource. This name will be used as the connection string name when referenced in a dependency.

userName: IResourceBuilder<ParameterResource>

The parameter used to provide the user name for the PostgreSQL resource. If null a default value will be used.

password: IResourceBuilder<ParameterResource>

The parameter used to provide the administrator password for the PostgreSQL resource. If null a random password will be generated.

port: Nullable<Int32>

The host port used when launching the container. If null a random port will be assigned.

Returns

IResourceBuilder<PostgresServerResource>

A reference to the IResourceBuilder<T>.

Remarks

This resource includes built-in health checks. When this resource is referenced as a dependency using the WaitFor<T>(IResourceBuilder<T>, IResourceBuilder<IResource>) extension method then the dependent resource will wait until the Postgres resource is able to service requests.

This version of the package defaults to the <inheritdoc cref="F:Aspire.Hosting.Postgres.PostgresContainerImageTags.Tag"></inheritdoc> tag of the <inheritdoc cref="F:Aspire.Hosting.Postgres.PostgresContainerImageTags.Image"></inheritdoc> container image.

Applies to