Dev services for Amazon Services

Quarkus Amazon Services automatically starts a containerized AWS stack in dev mode and when running tests. So, you don’t have to start one manually. The extension client is configured automatically.

Choosing a Stack Provider

Dev Services for Amazon Services supports multiple stack providers:

  • LocalStack: The default stack provider, using the LocalStack container

  • MiniStack: An alternative stack provider

  • Moto: A lightweight AWS service mock library, using the motoserver container

  • Floci: Another alternative stack provider

Dev Services for Amazon Services does not verify if the chosen stack actually implements a mock for a given service. It will start the container and provide the configuration to the client to connect to it, regardless of whether the service is actually supported by that stack provider.

You can configure the stack provider globally or per-service:

# Global configuration (default: localstack)
quarkus.aws.devservices.provider=localstack

# Per-service configuration (overrides global setting)
quarkus.dynamodb.devservices.provider=ministack
quarkus.cognito-user-pools.devservices.provider=moto
quarkus.s3.devservices.provider=floci

Enabling / Disabling Dev Services for Amazon Services

Dev Services for Amazon Services is automatically enabled for each extensions added to pom.xml except in the following situations:

  • quarkus.devservices.enabled is set to false

  • devservices.enabled is set to false per extension (eg. quarkus.dynamodb.devservices.enabled=false)

  • the endpoint-override is configured (eg. quarkus.dynamodb.endpoint-override=http://localhost:4566)

  • Your environment does not support Docker. In test mode, it will cause the test to fail. Either disable Dev Services or configure the endpoint-override.

Shared services

By default, Dev Services for Amazon Services will start one stack container with only the needed services.

If you need to share a particular service between applications, Dev Services for Amazon Services implements a service discovery mechanism for your multiple Quarkus applications running in dev mode to share a single container.

Dev Services for Amazon Services starts the container with the quarkus-dev-service-{stack} label (where {stack} is the stack provider name, e.g., localstack, ministack, moto, or floci) and service name as the value, which is used to identify the container. If you need multiple (shared) container, you can configure the devservices.service-name attribute for a given extension (eg. quarkus.dynamodb.devservices.service-name) and indicate the container name. It looks for a container with the same value, or starts a new one if none can be found. The default service name is the stack provider name (localstack, ministack, moto, or floci).

Isolation (Legacy mode LocalStack)

Deprecated, only applies to LocalStack in legacy modeand will be removed in a future release.

By default, to ease sharing containers across multiple applications, each service will be started in its own container (the value of the quarkus-dev-service-{stack} label is suffixed by the extension name). However, sometimes, some services need to communicate with each other inside the same container (e.g., subscribing an Amazon SQS queue to an Amazon SNS topic). In this case, you can disable this behavior by setting the devservices.isolated attribute for a given extension to false.

Sharing is disabled by default in dev mode, and is always disabled in test mode. You can enable the sharing with devservices.shared=true for a given extension (e.g. quarkus.dynamodb.devservices.shared=true). All other non-shared services will be grouped in another container.

Configuring the image

Dev Services for Amazon Services uses different default images depending on the stack provider:

  • LocalStack: localstack/localstack:4.13 (latest community version)

  • MiniStack: ministackorg/ministack:latest (not a fixed version as MiniStack is still in early development)

  • Moto: motoserver/moto:latest (latest version)

  • Floci: floci/floci:latest (latest version)

You can configure the image and version using the stack-specific properties:

# Global LocalStack configuration
quarkus.aws.devservices.localstack.image-name=localstack/localstack:4.13

# Global MiniStack configuration
quarkus.aws.devservices.ministack.image-name=ministackorg/ministack:latest

# Global Moto configuration
quarkus.aws.devservices.moto.image-name=motoserver/moto:latest

# Global Floci configuration
quarkus.aws.devservices.floci.image-name=floci/floci:latest

# Per-service LocalStack configuration (overrides global)
quarkus.dynamodb.devservices.localstack.image-name=localstack/localstack:4.13

# Per-service MiniStack configuration (overrides global)
quarkus.dynamodb.devservices.ministack.image-name=ministackorg/ministack:latest

# Per-service Moto configuration (overrides global)
quarkus.dynamodb.devservices.moto.image-name=motoserver/moto:latest

# Per-service Floci configuration (overrides global)
quarkus.dynamodb.devservices.floci.image-name=floci/floci:latest

LocalStack Pro

To use LocalStack Pro, you need to configure the Pro image and provide your authentication token:

# Use LocalStack Pro image
quarkus.aws.devservices.localstack.image-name=localstack/localstack-pro:latest

# Set the authentication token as a container environment variable
quarkus.aws.devservices.localstack.container-env.LOCALSTACK_AUTH_TOKEN=your-auth-token-here

You can obtain your LocalStack Pro authentication token from your LocalStack account dashboard. The token is required to access Pro features and services.

Specific configuration

Dev Services for Amazon Services can support specific properties sent to the container. It can be globally applied to all containers or be specified per service as follows:

# Global LocalStack configuration
quarkus.aws.devservices.localstack.container-properties.START_WEB=0

# Global MiniStack configuration
quarkus.aws.devservices.ministack.container-properties.SOME_PROPERTY=value

# Global Moto configuration
quarkus.aws.devservices.moto.container-properties.SOME_MOTO_PROPERTY=value

# Per-service LocalStack configuration (overrides global)
quarkus.dynamodb.devservices.localstack.container-properties.DYNAMODB_HEAP_SIZE=1G

# Per-service MiniStack configuration (overrides global)
quarkus.dynamodb.devservices.ministack.container-properties.SOME_PROPERTY=value

# Per-service Moto configuration (overrides global)
quarkus.dynamodb.devservices.moto.container-properties.SOME_MOTO_PROPERTY=value

Refer to the LocalStack documentation for LocalStack configuration: https://docs.localstack.cloud/aws/capabilities/config/configuration/. For MiniStack, refer to its documentation. For Moto, refer to the Moto documentation. Note that not all environment variables are supported and some may affect Dev Services for Amazon Services.

Additional services

To start additional services for which a Quarkus extension does not exist or is not imported in the project, use the additional-services property:

# Global LocalStack configuration
quarkus.aws.devservices.localstack.additional-services."kinesis".enabled=true
quarkus.aws.devservices.localstack.additional-services."redshift".enabled=true

# Global MiniStack configuration
quarkus.aws.devservices.ministack.additional-services."kinesis".enabled=true
quarkus.aws.devservices.ministack.additional-services."redshift".enabled=true

The key is the name of the service to enable and must be a valid service name for the chosen stack provider.

Init scripts

You can configure init scripts to be executed during stack startup:

# Global LocalStack configuration
quarkus.aws.devservices.localstack.init-scripts-folder=src/test/resources/localstack-init
quarkus.aws.devservices.localstack.init-scripts-classpath=init-scripts

# Global MiniStack configuration
quarkus.aws.devservices.ministack.init-scripts-folder=src/test/resources/ministack-init
quarkus.aws.devservices.ministack.init-scripts-classpath=init-scripts

# Global Moto configuration
quarkus.aws.devservices.moto.init-scripts-folder=src/test/resources/moto-init
quarkus.aws.devservices.moto.init-scripts-classpath=init-scripts

# Per-service LocalStack configuration (overrides global)
quarkus.dynamodb.devservices.localstack.init-scripts-folder=src/test/resources/dynamodb-init

# Per-service MiniStack configuration (overrides global)
quarkus.dynamodb.devservices.ministack.init-scripts-folder=src/test/resources/dynamodb-init

# Per-service Moto configuration (overrides global)
quarkus.dynamodb.devservices.moto.init-scripts-folder=src/test/resources/dynamodb-init

The init-scripts-folder property points to a folder containing init scripts, while init-scripts-classpath points to a classpath resource. The folder-based configuration takes precedence.

Additional setup

Some extensions support additional configuration to be applied at startup. Refer to the extension documentation.

Global DevServices Configuration Reference

Configuration property fixed at build time - All other configuration properties are overridable at runtime

Configuration property

Type

Default

quarkus.aws.devservices.floci.image-name

The Floci container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_IMAGE_NAME

string

floci/floci:latest

quarkus.aws.devservices.floci.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ENABLED

boolean

quarkus.aws.devservices.floci.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_SHARED

boolean

true

quarkus.aws.devservices.floci.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.floci.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.floci.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.floci.service-name

The value of the quarkus-dev-service-floci label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for Floci looks for a container with the quarkus-dev-service-floci label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-floci label set to the specified value.

This property is used when you need multiple shared Floci containers.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_SERVICE_NAME

string

floci

quarkus.aws.devservices.floci.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.floci.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_PORT

int

quarkus.aws.devservices.provider

The dev services stack provider to use. Supported values: "localstack" (default), "ministack", "moto", "floci"

This is a global setting that can be overridden per-service using the service-specific devservices.provider configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_PROVIDER

localstack, ministack, moto, floci

localstack

quarkus.aws.devservices.localstack.image-name

The LocalStack container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_IMAGE_NAME

string

localstack/localstack:4.13

quarkus.aws.devservices.localstack.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ENABLED

boolean

quarkus.aws.devservices.localstack.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_SHARED

boolean

true

quarkus.aws.devservices.localstack.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.localstack.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.localstack.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.localstack.service-name

The value of the quarkus-dev-service-localstack label attached to the started container.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_SERVICE_NAME

string

localstack

quarkus.aws.devservices.localstack.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.localstack.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_PORT

int

quarkus.aws.devservices.localstack.legacy-mode

When legacy mode is enabled, Dev Services for LocalStack will use the old approach to manage the container lifecycle.

DEPRECATED: This mode is deprecated and should not be used. It is only provided as a fallback for users who rely on the old behavior and need more time to migrate to the new approach.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_LEGACY_MODE

boolean

false

quarkus.aws.devservices.ministack.image-name

The MiniStack container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_IMAGE_NAME

string

ministackorg/ministack:latest

quarkus.aws.devservices.ministack.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ENABLED

boolean

quarkus.aws.devservices.ministack.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_SHARED

boolean

true

quarkus.aws.devservices.ministack.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.ministack.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.ministack.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.ministack.service-name

The value of the quarkus-dev-service-ministack label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for MiniStack looks for a container with the quarkus-dev-service-ministack label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-ministack label set to the specified value.

This property is used when you need multiple shared MiniStack containers.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_SERVICE_NAME

string

ministack

quarkus.aws.devservices.ministack.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.ministack.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_PORT

int

quarkus.aws.devservices.moto.image-name

The Moto container image to use.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_IMAGE_NAME

string

motoserver/moto:latest

quarkus.aws.devservices.moto.enabled

If Dev Services for Amazon Services has been explicitly enabled or disabled. Dev Services are generally enabled by default, unless there is an existing configuration present. For Amazon Services, Dev Services starts a container unless aws.endpoint-override is set.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ENABLED

boolean

quarkus.aws.devservices.moto.shared

Indicates if the stack container managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Amazon Services starts a new container. Container sharing is only used in dev mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_SHARED

boolean

true

quarkus.aws.devservices.moto.init-scripts-folder

Path to init scripts folder executed during stack startup.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_INIT_SCRIPTS_FOLDER

string

quarkus.aws.devservices.moto.init-scripts-classpath

Classpath to init scripts folder executed during stack startup. initScriptsFolder has higher precedence.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_INIT_SCRIPTS_CLASSPATH

string

quarkus.aws.devservices.moto.init-completion-msg

Specific container log message to be waiting for stack init scripts completion.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_INIT_COMPLETION_MSG

string

quarkus.aws.devservices.moto.service-name

The value of the quarkus-dev-service-moto label attached to the started container. This property is used when shared is set to true. In this case, before starting a container, Dev Services for Moto looks for a container with the quarkus-dev-service-moto label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise, it starts a new container with the quarkus-dev-service-moto label set to the specified value.

This property is used when you need multiple shared Moto containers.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_SERVICE_NAME

string

moto

quarkus.aws.devservices.moto.container-properties."environment-variable-name"

Environment variables that are passed to the container.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_CONTAINER_PROPERTIES__ENVIRONMENT_VARIABLE_NAME_

Map<String,String>

quarkus.aws.devservices.moto.port

Optional fixed port the stack will listen to.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_PORT

int

quarkus.aws.devservices.floci.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. For all services but Cognito, the local AWS stack will be provided by LocalStack. Otherwise, it will be provided by Moto

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.floci.additional-services."service-name".shared

Indicates if the container managed by Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services starts a new container.

The discovery uses the quarkus-dev-service-{provider} label. The value is configured using the service-name property.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__SHARED

boolean

false

quarkus.aws.devservices.floci.additional-services."service-name".isolated

Indicates if shared LocalStack services managed by Dev Services should be isolated. When true, the service will be started in its own container and the value of the quarkus-dev-service-localstack label will be suffixed by the service name (s3, sqs, …​)

DEPRECATED: This will work only with the LocalStack legacy mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__ISOLATED

boolean

true

quarkus.aws.devservices.floci.additional-services."service-name".service-name

The value of the quarkus-dev-service-{provider} label attached to the started container. In dev mode, when shared is set to true, before starting a container, Dev Services looks for a container with the quarkus-dev-service-{provider} label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise it starts a new container with the quarkus-dev-service-{provider} label set to the specified value. In test mode, Dev Services will group services with the same service-name value in one container instance.

This property is used when you need multiple shared container instances.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__SERVICE_NAME

string

awsstack

quarkus.aws.devservices.floci.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.floci.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "localstack", "ministack"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_FLOCI_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

localstack, ministack, moto, floci

quarkus.aws.devservices.localstack.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. For all services but Cognito, the local AWS stack will be provided by LocalStack. Otherwise, it will be provided by Moto

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.localstack.additional-services."service-name".shared

Indicates if the container managed by Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services starts a new container.

The discovery uses the quarkus-dev-service-{provider} label. The value is configured using the service-name property.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__SHARED

boolean

false

quarkus.aws.devservices.localstack.additional-services."service-name".isolated

Indicates if shared LocalStack services managed by Dev Services should be isolated. When true, the service will be started in its own container and the value of the quarkus-dev-service-localstack label will be suffixed by the service name (s3, sqs, …​)

DEPRECATED: This will work only with the LocalStack legacy mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ISOLATED

boolean

true

quarkus.aws.devservices.localstack.additional-services."service-name".service-name

The value of the quarkus-dev-service-{provider} label attached to the started container. In dev mode, when shared is set to true, before starting a container, Dev Services looks for a container with the quarkus-dev-service-{provider} label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise it starts a new container with the quarkus-dev-service-{provider} label set to the specified value. In test mode, Dev Services will group services with the same service-name value in one container instance.

This property is used when you need multiple shared container instances.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__SERVICE_NAME

string

awsstack

quarkus.aws.devservices.localstack.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.localstack.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "localstack", "ministack"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_LOCALSTACK_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

localstack, ministack, moto, floci

quarkus.aws.devservices.ministack.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. For all services but Cognito, the local AWS stack will be provided by LocalStack. Otherwise, it will be provided by Moto

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.ministack.additional-services."service-name".shared

Indicates if the container managed by Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services starts a new container.

The discovery uses the quarkus-dev-service-{provider} label. The value is configured using the service-name property.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__SHARED

boolean

false

quarkus.aws.devservices.ministack.additional-services."service-name".isolated

Indicates if shared LocalStack services managed by Dev Services should be isolated. When true, the service will be started in its own container and the value of the quarkus-dev-service-localstack label will be suffixed by the service name (s3, sqs, …​)

DEPRECATED: This will work only with the LocalStack legacy mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__ISOLATED

boolean

true

quarkus.aws.devservices.ministack.additional-services."service-name".service-name

The value of the quarkus-dev-service-{provider} label attached to the started container. In dev mode, when shared is set to true, before starting a container, Dev Services looks for a container with the quarkus-dev-service-{provider} label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise it starts a new container with the quarkus-dev-service-{provider} label set to the specified value. In test mode, Dev Services will group services with the same service-name value in one container instance.

This property is used when you need multiple shared container instances.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__SERVICE_NAME

string

awsstack

quarkus.aws.devservices.ministack.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.ministack.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "localstack", "ministack"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_MINISTACK_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

localstack, ministack, moto, floci

quarkus.aws.devservices.moto.additional-services."service-name".enabled

If a local AWS stack should be used. (default to true) If this is true and endpoint-override is not configured then a local AWS stack will be started and will be used instead of the given configuration. For all services but Cognito, the local AWS stack will be provided by LocalStack. Otherwise, it will be provided by Moto

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__ENABLED

boolean

quarkus.aws.devservices.moto.additional-services."service-name".shared

Indicates if the container managed by Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services starts a new container.

The discovery uses the quarkus-dev-service-{provider} label. The value is configured using the service-name property.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__SHARED

boolean

false

quarkus.aws.devservices.moto.additional-services."service-name".isolated

Indicates if shared LocalStack services managed by Dev Services should be isolated. When true, the service will be started in its own container and the value of the quarkus-dev-service-localstack label will be suffixed by the service name (s3, sqs, …​)

DEPRECATED: This will work only with the LocalStack legacy mode.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__ISOLATED

boolean

true

quarkus.aws.devservices.moto.additional-services."service-name".service-name

The value of the quarkus-dev-service-{provider} label attached to the started container. In dev mode, when shared is set to true, before starting a container, Dev Services looks for a container with the quarkus-dev-service-{provider} label set to the configured value. If found, it will use this container instead of starting a new one. Otherwise it starts a new container with the quarkus-dev-service-{provider} label set to the specified value. In test mode, Dev Services will group services with the same service-name value in one container instance.

This property is used when you need multiple shared container instances.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__SERVICE_NAME

string

awsstack

quarkus.aws.devservices.moto.additional-services."service-name".container-properties."container-properties"

Generic properties that are pass for additional container configuration.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__CONTAINER_PROPERTIES__CONTAINER_PROPERTIES_

Map<String,String>

quarkus.aws.devservices.moto.additional-services."service-name".provider

The dev services stack provider to use for this service. If not specified, the global setting from quarkus.aws.devservices.provider is used. Supported values: "localstack", "ministack"

This allows per-service override of the global stack selection.

Environment variable: QUARKUS_AWS_DEVSERVICES_MOTO_ADDITIONAL_SERVICES__SERVICE_NAME__PROVIDER

localstack, ministack, moto, floci