KeycloakResourceBuilderExtensions.AddKeycloak Method

Reference

Definition

Namespace:: Aspire.Hosting

Assembly:: Aspire.Hosting.Keycloak.dll

Package:: Aspire.Hosting.Keycloak v8.2.0-preview.1.24427.7

Source:: KeycloakResourceBuilderExtensions.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 Keycloak container to the application model.

public static Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.KeycloakResource> AddKeycloak (this Aspire.Hosting.IDistributedApplicationBuilder builder, string name, int? port = default, Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource>? adminUsername = default, Aspire.Hosting.ApplicationModel.IResourceBuilder<Aspire.Hosting.ApplicationModel.ParameterResource>? adminPassword = default);

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

<Extension()>
Public Function AddKeycloak (builder As IDistributedApplicationBuilder, name As String, Optional port As Nullable(Of Integer) = Nothing, Optional adminUsername As IResourceBuilder(Of ParameterResource) = Nothing, Optional adminPassword As IResourceBuilder(Of ParameterResource) = Nothing) As IResourceBuilder(Of KeycloakResource)

Parameters

builder: IDistributedApplicationBuilder

The IDistributedApplicationBuilder.

name: String

The name of the resource.

port: Nullable<Int32>

The host port that the underlying container is bound to when running locally.

adminUsername: IResourceBuilder<ParameterResource>

The parameter used as the admin for the Keycloak resource. If null a default value will be used.

adminPassword: IResourceBuilder<ParameterResource>

The parameter used as the admin password for the Keycloak resource. If null a default password will be used.

Returns

IResourceBuilder<KeycloakResource>

A reference to the IResourceBuilder<T>.

Examples

Use in application host

var keycloak = builder.AddKeycloak("keycloak");

var myService = builder.AddProject<Projects.MyService<()
                       .WithReference(keycloak);

Remarks

The container is based on the quay.io/keycloak/keycloak container image. The default tag is 24.0. The container exposes port 8080 by default.

Applies to

Share via