KeycloakResourceBuilderExtensions Methods

Docs / Reference / Search C# APIs / Aspire.Hosting.Keycloak / KeycloakResourceBuilderExtensions / Methods

Methods

Docs Reference Search C# APIs Aspire.Hosting.Keycloak KeycloakResourceBuilderExtensions Methods

Class Methods 9 members

Provides extension methods for adding Keycloak resources to an Hosting.IDistributedApplicationBuilder.

AddKeycloak(IDistributedApplicationBuilder, string, int?, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) extension IResourceBuilder<KeycloakResource>

Adds a Keycloak container to the application model.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> AddKeycloak(
        this IDistributedApplicationBuilder builder,
        string name,
        int? port = null,
        IResourceBuilder<ParameterResource>? adminUsername = null,
        IResourceBuilder<ParameterResource>? adminPassword = null)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L59-L150

Parameters

builder IDistributedApplicationBuilder The Hosting.IDistributedApplicationBuilder.

name string The name of the resource.

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

adminUsername IResourceBuilder<ParameterResource> optional The parameter used as the admin for the Keycloak resource. If null a default value will be used.

adminPassword IResourceBuilder<ParameterResource> optional 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 ApplicationModel.IResourceBuilder`1.

Remarks

The container exposes port 8080 by default. This version of the package defaults to the tag of the / container image. Use in application host

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

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

WithDataBindMount(IResourceBuilder<KeycloakResource>, string) extension IResourceBuilder<KeycloakResource>

Adds a bind mount for the data folder to a Keycloak container resource.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithDataBindMount(
        this IResourceBuilder<KeycloakResource> builder,
        string source)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L194-L197

Parameters

builder IResourceBuilder<KeycloakResource> The resource builder.

source string The source directory on the host to mount into the container.

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

Remarks

The source directory is mounted at /opt/keycloak/data in the container. Use a bind mount

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

WithDataVolume(IResourceBuilder<KeycloakResource>, string?) extension IResourceBuilder<KeycloakResource>

Adds a named volume for the data folder to a Keycloak container resource.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithDataVolume(
        this IResourceBuilder<KeycloakResource> builder,
        string? name = null)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L171-L173

Parameters

builder IResourceBuilder<KeycloakResource> The resource builder.

name string? optional The name of the volume. Defaults to an auto-generated name based on the application and resource names.

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

Remarks

The volume is mounted at /opt/keycloak/data in the container. Use a data volume

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

WithDisabledFeatures(IResourceBuilder<KeycloakResource>, string[]) extension IResourceBuilder<KeycloakResource>

Additional feature names to disable for the keycloak resource

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithDisabledFeatures(
        this IResourceBuilder<KeycloakResource> builder,
        params string[] features)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L292-L299

Parameters

builder IResourceBuilder<KeycloakResource> The resource builder.

features string[] Names of features to disable for the keycloak resource

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

WithEnabledFeatures(IResourceBuilder<KeycloakResource>, string[]) extension IResourceBuilder<KeycloakResource>

Additional feature names to enable for the keycloak resource

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithEnabledFeatures(
        this IResourceBuilder<KeycloakResource> builder,
        params string[] features)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L272-L279

Parameters

builder IResourceBuilder<KeycloakResource> The resource builder.

features string[] Names of features to enable for the keycloak resource

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

WithOtlpExporter(IResourceBuilder<KeycloakResource>) extension IResourceBuilder<KeycloakResource>

Injects the appropriate environment variables to allow the resource to enable sending telemetry to the dashboard.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithOtlpExporter(
        this IResourceBuilder<KeycloakResource> builder)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L315-L321

Parameters

builder IResourceBuilder<KeycloakResource> The keycloak resource builder.

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

WithOtlpExporter(IResourceBuilder<KeycloakResource>, OtlpProtocol) extension IResourceBuilder<KeycloakResource>

Injects the appropriate environment variables to allow the resource to enable sending telemetry to the dashboard.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithOtlpExporter(
        this IResourceBuilder<KeycloakResource> builder,
        OtlpProtocol protocol)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L338-L344

Parameters

builder IResourceBuilder<KeycloakResource> The keycloak resource builder.

protocol OtlpProtocol The protocol to use for the OTLP exporter. If not set, it will try gRPC then Http.

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

Obsolete — Use WithRealmImport(string import) instead.

WithRealmImport(IResourceBuilder<KeycloakResource>, string, bool) extension IResourceBuilder<KeycloakResource>

Adds a realm import to a Keycloak container resource.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithRealmImport(
        this IResourceBuilder<KeycloakResource> builder,
        string import,
        bool isReadOnly)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L223-L228

Parameters

builder IResourceBuilder<KeycloakResource> The resource builder.

import string The directory containing the realm import files or a single import file.

isReadOnly bool A flag that indicates if the realm import directory is read-only.

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

Remarks

The realm import files are copied to /opt/keycloak/data/import in the container. Import the realms from a directory

var keycloak = builder.AddKeycloak("keycloak")
                      .WithRealmImport("../realms");

WithRealmImport(IResourceBuilder<KeycloakResource>, string) extension IResourceBuilder<KeycloakResource>

Adds a realm import to a Keycloak container resource.

public static class KeycloakResourceBuilderExtensions
{
    public static IResourceBuilder<KeycloakResource> WithRealmImport(
        this IResourceBuilder<KeycloakResource> builder,
        string import)
    {
        // ...
    }
}

KeycloakResourceBuilderExtensions.cs#L251-L259

Parameters

builder IResourceBuilder<KeycloakResource> The resource builder.

import string The directory containing the realm import files or a single import file.

Returns

IResourceBuilder<KeycloakResource> The ApplicationModel.IResourceBuilder`1.

Remarks

The realm import files are copied to /opt/keycloak/data/import in the container. Import the realms from a directory

var keycloak = builder.AddKeycloak("keycloak")
                      .WithRealmImport("../realms");