Light, fluffy, and always free - The AWS Local Emulator alternative
feat(core): translate LocalStack variables in Java instead of the entrypoint (#5851)
Hector Ventura9dcb1b65ae55
diff --git a/.dockerignore b/.dockerignoreindex 83238f2ce0..c0ecd47c6b 100644--- a/.dockerignore+++ b/.dockerignore@@ -1,7 +1,6 @@*!bin/awslocal!docker/entrypoint.sh-!docker/localstack-parity.sh!docker/healthcheck.sh!pom.xml!src/**diff --git a/.github/workflows/compatibility.yml b/.github/workflows/compatibility.ymlindex fa6245b01d..0b2214299a 100644--- a/.github/workflows/compatibility.yml+++ b/.github/workflows/compatibility.yml@@ -11,7 +11,6 @@ on:- 'docker/Dockerfile.native-package'- 'docker/Dockerfile.compat'- 'docker/entrypoint.sh'- - 'docker/localstack-parity.sh'- 'docker/healthcheck.sh'- 'docker/run-docker-tests.sh'- 'docker/test-run-docker-tests.sh'diff --git a/docker/Dockerfile b/docker/Dockerfileindex 354de752cc..c1dffcaedc 100644--- a/docker/Dockerfile+++ b/docker/Dockerfile@@ -52,7 +52,7 @@ COPY --from=build /build/target/quarkus-app/ quarkus-app/RUN chown -R 1001:root /app/quarkus-appCOPY --chmod=755 docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh-COPY --chmod=755 docker/localstack-parity.sh docker/healthcheck.sh /usr/local/bin/+COPY --chmod=755 docker/healthcheck.sh /usr/local/bin/VOLUME /app/datadiff --git a/docker/Dockerfile.compat b/docker/Dockerfile.compatindex 104a2ce327..98cc36f83a 100644--- a/docker/Dockerfile.compat+++ b/docker/Dockerfile.compat@@ -111,7 +111,7 @@ ENV FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE=trueCOPY --from=native --chown=1001:root /app/ /app/VOLUME /app/data-COPY --from=native /usr/local/bin/docker-entrypoint.sh /usr/local/bin/localstack-parity.sh /usr/local/bin/+COPY --chmod=755 docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh# From the build context, not the native image: a published native image may predate the script.COPY --chmod=755 docker/healthcheck.sh /usr/local/bin/diff --git a/docker/Dockerfile.jvm-package b/docker/Dockerfile.jvm-packageindex a938c6b803..07ccb810fd 100644--- a/docker/Dockerfile.jvm-package+++ b/docker/Dockerfile.jvm-package@@ -51,7 +51,7 @@ COPY target/quarkus-app/ quarkus-app/RUN chown -R 1001:root /app/quarkus-appCOPY --chmod=755 docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh-COPY --chmod=755 docker/localstack-parity.sh docker/healthcheck.sh /usr/local/bin/+COPY --chmod=755 docker/healthcheck.sh /usr/local/bin/VOLUME /app/datadiff --git a/docker/Dockerfile.native b/docker/Dockerfile.nativeindex 51bf9336a1..7be22b4669 100644--- a/docker/Dockerfile.native+++ b/docker/Dockerfile.native@@ -50,7 +50,7 @@ ENV FLOCI_STORAGE_PERSISTENT_PATH=/app/dataCOPY --from=build /usr/lib64/libz.so.1 /usr/lib64/libz.so.1COPY --chmod=755 --from=build /app/target/*-runner /app/applicationCOPY --chmod=755 docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh-COPY --chmod=755 docker/localstack-parity.sh docker/healthcheck.sh /usr/local/bin/+COPY --chmod=755 docker/healthcheck.sh /usr/local/bin/ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]# A published port needs 0.0.0.0 inside the container, which Floci only accepts with explicit consent.diff --git a/docker/Dockerfile.native-package b/docker/Dockerfile.native-packageindex 804fc8b809..7b365f61e8 100644--- a/docker/Dockerfile.native-package+++ b/docker/Dockerfile.native-package@@ -14,7 +14,7 @@ RUN echo 'floci:x:1001:0:Floci:/app:/sbin/nologin' >> /etc/passwd \VOLUME /app/dataCOPY --chmod=755 docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh-COPY --chmod=755 docker/localstack-parity.sh docker/healthcheck.sh /usr/local/bin/+COPY --chmod=755 docker/healthcheck.sh /usr/local/bin/ARG VERSION=latestENV FLOCI_VERSION=${VERSION}diff --git a/docker/entrypoint.sh b/docker/entrypoint.shindex 86a17a103b..773b73f429 100755--- a/docker/entrypoint.sh+++ b/docker/entrypoint.sh@@ -53,10 +53,6 @@ if [ "$(id -u)" = '0' ]; thenfifi-if [ "${LOCALSTACK_PARITY:-true}" != "false" ]; then- . /usr/local/bin/localstack-parity.sh-fi-# Probe the state dir as the unprivileged user and warn loudly when it is not# writable (read-only or root-owned bind mounts the chown above could not fix).# The container still starts: with the default in-memory storage the dir isdiff --git a/docker/localstack-parity.sh b/docker/localstack-parity.shdeleted file mode 100644index 9c3a1a6e12..0000000000--- a/docker/localstack-parity.sh+++ /dev/null@@ -1,82 +0,0 @@-#!/bin/sh-# Maps LocalStack Community environment variables to their Floci equivalents.-# Sourced by entrypoint.sh when LOCALSTACK_PARITY=true.-# Floci vars always win: every mapping uses ${FLOCI_VAR:-<derived>} so an-# explicitly-set Floci var is never overwritten.--# Storage mode — PERSISTENCE=1 / PERSIST_STATE=1 → persistent storage-if [ -n "${PERSISTENCE:-}" ] || [ -n "${PERSIST_STATE:-}" ]; then- _ls_persist="${PERSISTENCE:-${PERSIST_STATE:-}}"- if [ "${_ls_persist}" = "1" ] || [ "${_ls_persist}" = "true" ]; then- export FLOCI_STORAGE_MODE="${FLOCI_STORAGE_MODE:-persistent}"- fi-fi--# Bind port — EDGE_PORT → FLOCI_PORT-[ -n "${EDGE_PORT:-}" ] && export FLOCI_PORT="${FLOCI_PORT:-${EDGE_PORT}}"--# Hostname returned in response URLs — LOCALSTACK_HOST / LOCALSTACK_HOSTNAME → FLOCI_HOSTNAME-_ls_host="${LOCALSTACK_HOST:-${LOCALSTACK_HOSTNAME:-}}"-[ -n "${_ls_host}" ] && export FLOCI_HOSTNAME="${FLOCI_HOSTNAME:-${_ls_host}}"--# Bind address — GATEWAY_LISTEN → QUARKUS_HTTP_HOST. LocalStack listens there with no further-# opt-in, so GATEWAY_LISTEN also gives the consent Floci requires for a non-loopback address.-if [ -n "${GATEWAY_LISTEN:-}" ]; then- export QUARKUS_HTTP_HOST="${QUARKUS_HTTP_HOST:-${GATEWAY_LISTEN}}"- export FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE="${FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE:-true}"-fi--# Log level — LS_LOG / DEBUG=1 → QUARKUS_LOG_LEVEL-if [ -n "${LS_LOG:-}" ]; then- export QUARKUS_LOG_LEVEL="${QUARKUS_LOG_LEVEL:-${LS_LOG}}"-elif [ "${DEBUG:-}" = "1" ]; then- export QUARKUS_LOG_LEVEL="${QUARKUS_LOG_LEVEL:-DEBUG}"-fi--# Lambda — LAMBDA_EXECUTOR is intentionally ignored; Floci always runs Lambda in Docker containers.--# Lambda Docker network-[ -n "${LAMBDA_DOCKER_NETWORK:-}" ] && \- export FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK="${FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK:-${LAMBDA_DOCKER_NETWORK}}"--# Lambda ephemeral containers-if [ "${LAMBDA_REMOVE_CONTAINERS:-}" = "1" ] || [ "${LAMBDA_REMOVE_CONTAINERS:-}" = "true" ]; then- export FLOCI_SERVICES_LAMBDA_EPHEMERAL="${FLOCI_SERVICES_LAMBDA_EPHEMERAL:-true}"-fi--# LAMBDA_REMOTE_DOCKER — not fully supported.-# Floci's hot-reload is per-function opt-in (S3Bucket=hot-reload), not a global bind-mount mode.-if [ -n "${LAMBDA_REMOTE_DOCKER:-}" ]; then- echo "[floci-parity] WARNING: LAMBDA_REMOTE_DOCKER is not fully supported by Floci." >&2- echo "[floci-parity] Use S3Bucket=hot-reload per function instead. See https://floci.io/docs/services/lambda" >&2-fi--# Docker host-[ -n "${DOCKER_HOST:-}" ] && export FLOCI_DOCKER_DOCKER_HOST="${FLOCI_DOCKER_DOCKER_HOST:-${DOCKER_HOST}}"--# Docker network — shared across all container-based services (Lambda, RDS, ElastiCache, MSK, OpenSearch, EKS).-# Per-service overrides (e.g. FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK) take precedence when set.-[ -n "${DOCKER_NETWORK:-}" ] && export FLOCI_SERVICES_DOCKER_NETWORK="${FLOCI_SERVICES_DOCKER_NETWORK:-${DOCKER_NETWORK}}"--# DNS suffixes — register LocalStack and Floci hostname suffixes so that container-to-container-# hostname routing (Function URLs, presigned S3, SQS QueueUrl, etc.) works without manual config.-_parity_suffixes="localhost.localstack.cloud,localhost.floci.io"-if [ -n "${FLOCI_DNS_EXTRA_SUFFIXES:-}" ]; then- export FLOCI_DNS_EXTRA_SUFFIXES="${FLOCI_DNS_EXTRA_SUFFIXES},${_parity_suffixes}"-else- export FLOCI_DNS_EXTRA_SUFFIXES="${_parity_suffixes}"-fi--# TLS — USE_SSL=1 → FLOCI_TLS_ENABLED=true-if [ "${USE_SSL:-0}" = "1" ]; then- export FLOCI_TLS_ENABLED="${FLOCI_TLS_ENABLED:-true}"-fi--# TLS — CUSTOM_SSL_CERT_PATH → FLOCI_TLS_CERT_PATH + FLOCI_TLS_KEY_PATH-# LocalStack uses a single combined PEM (cert+key). Floci accepts it in both fields.-if [ -n "${CUSTOM_SSL_CERT_PATH:-}" ]; then- export FLOCI_TLS_CERT_PATH="${FLOCI_TLS_CERT_PATH:-${CUSTOM_SSL_CERT_PATH}}"- export FLOCI_TLS_KEY_PATH="${FLOCI_TLS_KEY_PATH:-${CUSTOM_SSL_CERT_PATH}}"-fi--# SERVICES: intentionally ignored; Floci starts every service in ~24ms.diff --git a/docker/test-localstack-parity.sh b/docker/test-localstack-parity.shdeleted file mode 100755index 2f7e6cf547..0000000000--- a/docker/test-localstack-parity.sh+++ /dev/null@@ -1,153 +0,0 @@-#!/bin/sh-# Unit tests for localstack-parity.sh.-# Run directly: sh docker/test-localstack-parity.sh-# Exit 0 on success, non-zero on first failure.--set -eu--SCRIPT="$(dirname "$0")/localstack-parity.sh"-PASS=0-FAIL=0--# Run the parity script in a subshell with a given environment and print the-# value of a single variable. Arguments: VAR_NAME [ENV_KEY=VALUE ...]-_run() {- var="$1"; shift- env -i "$@" sh -c ". '${SCRIPT}'; printf '%s' \"\${${var}:-}\""-}--# Assert that _run produces an expected value.-assert_eq() {- desc="$1"; expected="$2"; actual="$3"- if [ "${actual}" = "${expected}" ]; then- printf '[PASS] %s\n' "${desc}"- PASS=$((PASS + 1))- else- printf '[FAIL] %s\n expected: %s\n actual: %s\n' "${desc}" "${expected}" "${actual}"- FAIL=$((FAIL + 1))- fi-}--# --- PERSISTENCE ----assert_eq "PERSISTENCE=1 sets FLOCI_STORAGE_MODE=persistent" \- "persistent" \- "$(_run FLOCI_STORAGE_MODE PERSISTENCE=1)"--assert_eq "PERSISTENCE=true sets FLOCI_STORAGE_MODE=persistent" \- "persistent" \- "$(_run FLOCI_STORAGE_MODE PERSISTENCE=true)"--assert_eq "PERSIST_STATE=1 sets FLOCI_STORAGE_MODE=persistent" \- "persistent" \- "$(_run FLOCI_STORAGE_MODE PERSIST_STATE=1)"--assert_eq "FLOCI_STORAGE_MODE wins over PERSISTENCE" \- "hybrid" \- "$(_run FLOCI_STORAGE_MODE PERSISTENCE=1 FLOCI_STORAGE_MODE=hybrid)"--# --- EDGE_PORT ----assert_eq "EDGE_PORT sets FLOCI_PORT" \- "4567" \- "$(_run FLOCI_PORT EDGE_PORT=4567)"--assert_eq "FLOCI_PORT wins over EDGE_PORT" \- "4568" \- "$(_run FLOCI_PORT EDGE_PORT=4567 FLOCI_PORT=4568)"--# --- LOCALSTACK_HOST / LOCALSTACK_HOSTNAME ----assert_eq "LOCALSTACK_HOST sets FLOCI_HOSTNAME" \- "myhost" \- "$(_run FLOCI_HOSTNAME LOCALSTACK_HOST=myhost)"--assert_eq "LOCALSTACK_HOSTNAME sets FLOCI_HOSTNAME when LOCALSTACK_HOST unset" \- "myhost2" \- "$(_run FLOCI_HOSTNAME LOCALSTACK_HOSTNAME=myhost2)"--assert_eq "LOCALSTACK_HOST takes priority over LOCALSTACK_HOSTNAME" \- "primary" \- "$(_run FLOCI_HOSTNAME LOCALSTACK_HOST=primary LOCALSTACK_HOSTNAME=secondary)"--assert_eq "FLOCI_HOSTNAME wins over LOCALSTACK_HOST" \- "explicit" \- "$(_run FLOCI_HOSTNAME LOCALSTACK_HOST=myhost FLOCI_HOSTNAME=explicit)"--# --- GATEWAY_LISTEN ----assert_eq "GATEWAY_LISTEN sets QUARKUS_HTTP_HOST" \- "0.0.0.0" \- "$(_run QUARKUS_HTTP_HOST GATEWAY_LISTEN=0.0.0.0)"--assert_eq "GATEWAY_LISTEN allows a non-loopback address" \- "true" \- "$(_run FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE GATEWAY_LISTEN=0.0.0.0)"--assert_eq "FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE wins over GATEWAY_LISTEN" \- "false" \- "$(_run FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE GATEWAY_LISTEN=0.0.0.0 FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE=false)"--assert_eq "no GATEWAY_LISTEN leaves network exposure unallowed" \- "" \- "$(_run FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE)"--# --- LOG LEVEL ----assert_eq "LS_LOG sets QUARKUS_LOG_LEVEL" \- "WARN" \- "$(_run QUARKUS_LOG_LEVEL LS_LOG=WARN)"--assert_eq "DEBUG=1 sets QUARKUS_LOG_LEVEL=DEBUG" \- "DEBUG" \- "$(_run QUARKUS_LOG_LEVEL DEBUG=1)"--assert_eq "LS_LOG takes priority over DEBUG=1" \- "TRACE" \- "$(_run QUARKUS_LOG_LEVEL LS_LOG=TRACE DEBUG=1)"--assert_eq "QUARKUS_LOG_LEVEL wins over LS_LOG" \- "INFO" \- "$(_run QUARKUS_LOG_LEVEL LS_LOG=DEBUG QUARKUS_LOG_LEVEL=INFO)"--# --- LAMBDA ----assert_eq "LAMBDA_DOCKER_NETWORK sets FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK" \- "mynet" \- "$(_run FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK LAMBDA_DOCKER_NETWORK=mynet)"--assert_eq "FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK wins over LAMBDA_DOCKER_NETWORK" \- "floci-net" \- "$(_run FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK LAMBDA_DOCKER_NETWORK=mynet FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK=floci-net)"--assert_eq "LAMBDA_REMOVE_CONTAINERS=1 sets FLOCI_SERVICES_LAMBDA_EPHEMERAL=true" \- "true" \- "$(_run FLOCI_SERVICES_LAMBDA_EPHEMERAL LAMBDA_REMOVE_CONTAINERS=1)"--assert_eq "LAMBDA_REMOVE_CONTAINERS=true sets FLOCI_SERVICES_LAMBDA_EPHEMERAL=true" \- "true" \- "$(_run FLOCI_SERVICES_LAMBDA_EPHEMERAL LAMBDA_REMOVE_CONTAINERS=true)"--assert_eq "FLOCI_SERVICES_LAMBDA_EPHEMERAL wins over LAMBDA_REMOVE_CONTAINERS" \- "false" \- "$(_run FLOCI_SERVICES_LAMBDA_EPHEMERAL LAMBDA_REMOVE_CONTAINERS=1 FLOCI_SERVICES_LAMBDA_EPHEMERAL=false)"--# --- DOCKER HOST / NETWORK ----assert_eq "DOCKER_HOST sets FLOCI_DOCKER_DOCKER_HOST" \- "unix:///var/run/docker.sock" \- "$(_run FLOCI_DOCKER_DOCKER_HOST DOCKER_HOST=unix:///var/run/docker.sock)"--assert_eq "DOCKER_NETWORK sets FLOCI_SERVICES_DOCKER_NETWORK" \- "shared" \- "$(_run FLOCI_SERVICES_DOCKER_NETWORK DOCKER_NETWORK=shared)"--assert_eq "FLOCI_SERVICES_DOCKER_NETWORK wins over DOCKER_NETWORK" \- "override" \- "$(_run FLOCI_SERVICES_DOCKER_NETWORK DOCKER_NETWORK=shared FLOCI_SERVICES_DOCKER_NETWORK=override)"--# --- DNS SUFFIXES ----assert_eq "DNS suffixes set when FLOCI_DNS_EXTRA_SUFFIXES unset" \- "localhost.localstack.cloud,localhost.floci.io" \- "$(_run FLOCI_DNS_EXTRA_SUFFIXES)"--assert_eq "DNS suffixes appended to existing FLOCI_DNS_EXTRA_SUFFIXES" \- "custom.internal,localhost.localstack.cloud,localhost.floci.io" \- "$(_run FLOCI_DNS_EXTRA_SUFFIXES FLOCI_DNS_EXTRA_SUFFIXES=custom.internal)"--# --- Summary ----printf '\nResults: %d passed, %d failed\n' "${PASS}" "${FAIL}"-[ "${FAIL}" -eq 0 ]diff --git a/docs/getting-started/migrate-from-localstack.md b/docs/getting-started/migrate-from-localstack.mdindex 93834407f3..8b3e4b1b56 100644--- a/docs/getting-started/migrate-from-localstack.md+++ b/docs/getting-started/migrate-from-localstack.md@@ -23,6 +23,8 @@ services:Explicitly set Floci variables always win — the translation only fills in values that haven't been set. To disable the translation entirely, set `LOCALSTACK_PARITY=false`.+The translation happens inside Floci, not in the image's entrypoint, so it applies the same way to the Docker image, the JVM build and a native binary run on the host.+Unless parity is disabled, the startup log also ends with a LocalStack-style `Ready.` line (in addition to Floci's own banner), so tooling that watches the container log for LocalStack's readiness message — such as the default wait strategy of Testcontainers' `LocalStackContainer` — works without a custom wait.## Step-by-step migrationdiff --git a/src/main/java/io/github/hectorvent/floci/config/LocalStackParity.java b/src/main/java/io/github/hectorvent/floci/config/LocalStackParity.javanew file mode 100644index 0000000000..d2a223df83--- /dev/null+++ b/src/main/java/io/github/hectorvent/floci/config/LocalStackParity.java@@ -0,0 +1,200 @@+package io.github.hectorvent.floci.config;++import org.jboss.logging.Logger;++import java.util.ArrayList;+import java.util.LinkedHashMap;+import java.util.LinkedHashSet;+import java.util.List;+import java.util.Map;+import java.util.Optional;+import java.util.Set;+import java.util.regex.Matcher;+import java.util.regex.Pattern;++/**+ * Translates LocalStack Community environment variables into the Floci configuration they mean,+ * so a LocalStack setup works unchanged in the image and in a binary on the host alike.+ *+ * <p>An explicitly set Floci variable always wins: a mapping is produced only when the matching+ * {@code FLOCI_*} or {@code QUARKUS_*} environment variable is absent. The DNS suffixes are the+ * one exception: LocalStack's and Floci's hostname suffixes are appended to the configured ones,+ * wherever those are set ({@link #withDnsSuffixes}). The whole translation is off when+ * {@code LOCALSTACK_PARITY=false}.+ */+public final class LocalStackParity {++ private static final Logger LOG = Logger.getLogger(LocalStackParity.class);++ static final List<String> PARITY_SUFFIXES = List.of("localhost.localstack.cloud", "localhost.floci.io");++ private static final Pattern BRACKETED_IPV6 = Pattern.compile("^\\[([^\\]]+)\\](?::(\\d+))?$");++ /** One translated setting: the Floci variable it stands for, its property, and its value. */+ record Mapping(String variable, String property, String value) {+ }++ /** A host and a port, either of which may be absent (LocalStack then uses its default). */+ record HostAndPort(String host, String port) {+ }++ private LocalStackParity() {+ }++ public static boolean enabled(Map<String, String> env) {+ return !"false".equals(env.get("LOCALSTACK_PARITY"));+ }++ /** The translation for this process's environment, as configuration property names. */+ public static Map<String, String> forCurrentEnvironment() {+ return translate(System.getenv());+ }++ /**+ * @return property name to value, for every LocalStack variable present whose Floci+ * counterpart is not set; empty when parity is disabled+ */+ public static Map<String, String> translate(Map<String, String> env) {+ Map<String, String> out = new LinkedHashMap<>();+ for (Mapping mapping : mappings(env)) {+ out.put(mapping.property(), mapping.value());+ }+ return out;+ }++ /**+ * The same translation as {@code FLOCI_*}/{@code QUARKUS_*} variables, for child processes such+ * as init hooks: the entrypoint script used to export them, so hooks inherited them. Includes+ * {@code FLOCI_DNS_EXTRA_SUFFIXES} with the LocalStack suffixes appended, as the script did.+ */+ public static Map<String, String> environment(Map<String, String> env) {+ Map<String, String> out = new LinkedHashMap<>();+ if (!enabled(env)) {+ return out;+ }+ for (Mapping mapping : mappings(env)) {+ out.put(mapping.variable(), mapping.value());+ }+ String suffixes = env.get("FLOCI_DNS_EXTRA_SUFFIXES");+ out.put("FLOCI_DNS_EXTRA_SUFFIXES", String.join(",", withDnsSuffixes(+ isSet(suffixes) ? Optional.of(List.of(suffixes.split(","))) : Optional.empty(), env).orElseThrow()));+ return out;+ }++ /** The configured extra DNS suffixes, plus LocalStack's and Floci's when parity is on. */+ public static Optional<List<String>> withDnsSuffixes(Optional<List<String>> configured) {+ return withDnsSuffixes(configured, System.getenv());+ }++ static Optional<List<String>> withDnsSuffixes(Optional<List<String>> configured, Map<String, String> env) {+ if (!enabled(env)) {+ return configured;+ }+ Set<String> suffixes = new LinkedHashSet<>(configured.orElse(List.of()));+ suffixes.addAll(PARITY_SUFFIXES);+ return Optional.of(List.copyOf(suffixes));+ }++ private static List<Mapping> mappings(Map<String, String> env) {+ List<Mapping> out = new ArrayList<>();+ if (!enabled(env)) {+ return out;+ }++ String persist = firstSet(env, "PERSISTENCE", "PERSIST_STATE");+ if ("1".equals(persist) || "true".equals(persist)) {+ put(out, env, "FLOCI_STORAGE_MODE", "floci.storage.mode", "persistent");+ }++ // LocalStack listens on GATEWAY_LISTEN with no further opt-in, so it also gives the+ // consent Floci requires for a non-loopback address. Its first entry may carry a port,+ // which stands in for EDGE_PORT when that is unset.+ // An empty host (":4566") keeps Floci's own bind address and takes just the port.+ String gatewayListen = env.get("GATEWAY_LISTEN");+ HostAndPort gateway = isSet(gatewayListen)+ ? parseHostAndPort(gatewayListen.split(",")[0])+ : new HostAndPort(null, null);+ String gatewayHost = gateway.host();++ put(out, env, "FLOCI_PORT", "floci.port", isSet(env.get("EDGE_PORT")) ? env.get("EDGE_PORT") : gateway.port());+ // LOCALSTACK_HOST is <hostname>:<port> (default localhost.localstack.cloud:4566); Floci's+ // hostname is the host alone, its port comes from floci.port.+ String localstackHost = firstSet(env, "LOCALSTACK_HOST", "LOCALSTACK_HOSTNAME");+ put(out, env, "FLOCI_HOSTNAME", "floci.hostname",+ isSet(localstackHost) ? parseHostAndPort(localstackHost).host() : null);++ if (isSet(gatewayHost)) {+ put(out, env, "QUARKUS_HTTP_HOST", "quarkus.http.host", gatewayHost);+ put(out, env, "FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE",+ "floci.security.allow-unsafe-network-exposure", "true");+ }++ String lsLog = env.get("LS_LOG");+ if (isSet(lsLog)) {+ put(out, env, "QUARKUS_LOG_LEVEL", "quarkus.log.level", lsLog);+ } else if ("1".equals(env.get("DEBUG"))) {+ put(out, env, "QUARKUS_LOG_LEVEL", "quarkus.log.level", "DEBUG");+ }++ put(out, env, "FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK", "floci.services.lambda.docker-network",+ env.get("LAMBDA_DOCKER_NETWORK"));+ String removeContainers = env.get("LAMBDA_REMOVE_CONTAINERS");+ if ("1".equals(removeContainers) || "true".equals(removeContainers)) {+ put(out, env, "FLOCI_SERVICES_LAMBDA_EPHEMERAL", "floci.services.lambda.ephemeral", "true");+ }+ if (isSet(env.get("LAMBDA_REMOTE_DOCKER"))) {+ LOG.warn("LAMBDA_REMOTE_DOCKER is not fully supported by Floci. Use S3Bucket=hot-reload per function"+ + " instead. See https://floci.io/docs/services/lambda");+ }++ put(out, env, "FLOCI_DOCKER_DOCKER_HOST", "floci.docker.docker-host", env.get("DOCKER_HOST"));+ // Shared by every container-backed service; per-service networks still take precedence.+ put(out, env, "FLOCI_SERVICES_DOCKER_NETWORK", "floci.services.docker-network", env.get("DOCKER_NETWORK"));++ if ("1".equals(env.get("USE_SSL"))) {+ put(out, env, "FLOCI_TLS_ENABLED", "floci.tls.enabled", "true");+ }+ // LocalStack takes one combined PEM (certificate and key); Floci accepts it in both fields.+ String customCert = env.get("CUSTOM_SSL_CERT_PATH");+ put(out, env, "FLOCI_TLS_CERT_PATH", "floci.tls.cert-path", customCert);+ put(out, env, "FLOCI_TLS_KEY_PATH", "floci.tls.key-path", customCert);++ // LAMBDA_EXECUTOR and SERVICES are intentionally ignored.+ return out;+ }++ /**+ * Parses the forms LocalStack's {@code HostAndPort.parse} accepts: {@code host:port},+ * {@code host}, {@code :port}, {@code [v6]:port} and {@code [v6]}. A missing part is null.+ */+ static HostAndPort parseHostAndPort(String input) {+ String value = input.trim();+ Matcher ipv6 = BRACKETED_IPV6.matcher(value);+ if (ipv6.matches()) {+ return new HostAndPort(ipv6.group(1), ipv6.group(2));+ }+ int colon = value.indexOf(':');+ if (colon < 0) {+ return new HostAndPort(value.isEmpty() ? null : value, null);+ }+ String host = value.substring(0, colon).trim();+ String port = value.substring(colon + 1).trim();+ return new HostAndPort(host.isEmpty() ? null : host, port.isEmpty() ? null : port);+ }++ private static void put(List<Mapping> out, Map<String, String> env, String flociVariable,+ String property, String value) {+ if (isSet(value) && !isSet(env.get(flociVariable))) {+ out.add(new Mapping(flociVariable, property, value));+ }+ }++ private static String firstSet(Map<String, String> env, String first, String second) {+ String value = env.get(first);+ return isSet(value) ? value : env.get(second);+ }++ private static boolean isSet(String value) {+ return value != null && !value.isEmpty();+ }+}diff --git a/src/main/java/io/github/hectorvent/floci/config/LocalStackParityConfigSource.java b/src/main/java/io/github/hectorvent/floci/config/LocalStackParityConfigSource.javanew file mode 100644index 0000000000..2e8299f738--- /dev/null+++ b/src/main/java/io/github/hectorvent/floci/config/LocalStackParityConfigSource.java@@ -0,0 +1,56 @@+package io.github.hectorvent.floci.config;++import org.eclipse.microprofile.config.spi.ConfigSource;++import java.util.Map;+import java.util.Set;++/**+ * Serves {@link LocalStackParity}'s translation as configuration.+ *+ * <p>The ordinal (299) sits just below environment variables (300), and above {@code .env} (295)+ * and {@code config/application.yml} (265), as the {@code FLOCI_*} variables the replaced shell+ * script exported did. A translated key is only present when its Floci variable is unset, so it+ * never shadows one. Staying below 300 also keeps {@link TlsConfigSource}'s loopback pin of+ * {@code quarkus.http.host} in force when TLS is on and {@code GATEWAY_LISTEN} names the public+ * address, which {@link NetworkExposureGuard#publicHost} still reads from here.+ */+public class LocalStackParityConfigSource implements ConfigSource {++ static final int ORDINAL = 299;++ private final Map<String, String> properties;++ public LocalStackParityConfigSource() {+ this(LocalStackParity.forCurrentEnvironment());+ }++ LocalStackParityConfigSource(Map<String, String> properties) {+ this.properties = Map.copyOf(properties);+ }++ @Override+ public Map<String, String> getProperties() {+ return properties;+ }++ @Override+ public Set<String> getPropertyNames() {+ return properties.keySet();+ }++ @Override+ public String getValue(String propertyName) {+ return properties.get(propertyName);+ }++ @Override+ public String getName() {+ return "floci-localstack-parity";+ }++ @Override+ public int getOrdinal() {+ return ORDINAL;+ }+}diff --git a/src/main/java/io/github/hectorvent/floci/config/TlsCertificateManager.java b/src/main/java/io/github/hectorvent/floci/config/TlsCertificateManager.javaindex cdc2124538..46d7ae0e4a 100644--- a/src/main/java/io/github/hectorvent/floci/config/TlsCertificateManager.java+++ b/src/main/java/io/github/hectorvent/floci/config/TlsCertificateManager.java@@ -250,7 +250,7 @@ public class TlsCertificateManager implements Resettable {} catch (RuntimeException e) {LOG.debugv("TLS: floci.base-url {0} has no usable host: {1}", config.baseUrl(), e.getMessage());}- config.dns().extraSuffixes().ifPresent(list -> list.forEach(s -> suffixes.add(s.toLowerCase(Locale.ROOT))));+ LocalStackParity.withDnsSuffixes(config.dns().extraSuffixes()).ifPresent(list -> list.forEach(s -> suffixes.add(s.toLowerCase(Locale.ROOT))));String bare = name.startsWith("*.") ? name.substring(2) : name;for (String suffix : suffixes) {if (DomainNames.isWithin(bare, suffix)) {diff --git a/src/main/java/io/github/hectorvent/floci/config/TlsConfigSource.java b/src/main/java/io/github/hectorvent/floci/config/TlsConfigSource.javaindex dfc85f7938..b6f7416a97 100644--- a/src/main/java/io/github/hectorvent/floci/config/TlsConfigSource.java+++ b/src/main/java/io/github/hectorvent/floci/config/TlsConfigSource.java@@ -207,6 +207,11 @@ public class TlsConfigSource implements ConfigSource {if (value != null && !value.isBlank())return value;+ // 3. A LocalStack variable that means the same thing (USE_SSL, CUSTOM_SSL_CERT_PATH)+ value = LocalStackParity.forCurrentEnvironment().get(key);+ if (value != null && !value.isBlank())+ return value;+return defaultValue;}diff --git a/src/main/java/io/github/hectorvent/floci/core/common/dns/EmbeddedDnsServer.java b/src/main/java/io/github/hectorvent/floci/core/common/dns/EmbeddedDnsServer.javaindex 289a395812..8bb457325a 100644--- a/src/main/java/io/github/hectorvent/floci/core/common/dns/EmbeddedDnsServer.java+++ b/src/main/java/io/github/hectorvent/floci/core/common/dns/EmbeddedDnsServer.java@@ -1,6 +1,7 @@package io.github.hectorvent.floci.core.common.dns;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.config.LocalStackParity;import io.github.hectorvent.floci.config.TlsConfigSource;import io.github.hectorvent.floci.core.common.DomainNames;import io.github.hectorvent.floci.core.common.RegionResolver;@@ -157,7 +158,7 @@ public class EmbeddedDnsServer {suffixes.addAll(BUILTIN_SUFFIXES);config.hostname().ifPresent(suffixes::add);- config.dns().extraSuffixes().ifPresent(suffixes::addAll);+ LocalStackParity.withDnsSuffixes(config.dns().extraSuffixes()).ifPresent(suffixes::addAll);if (config.dns().spoofAwsEndpoints()) {suffixes.addAll(TlsConfigSource.awsEndpointSuffixes());if (shouldWarnSpoofInvisibleToTls(true, TlsConfigSource.tlsEnabledVisibleToTls(),diff --git a/src/main/java/io/github/hectorvent/floci/lifecycle/inithook/HookScriptExecutor.java b/src/main/java/io/github/hectorvent/floci/lifecycle/inithook/HookScriptExecutor.javaindex 9b4740aabe..ec0d83df43 100644--- a/src/main/java/io/github/hectorvent/floci/lifecycle/inithook/HookScriptExecutor.java+++ b/src/main/java/io/github/hectorvent/floci/lifecycle/inithook/HookScriptExecutor.java@@ -1,6 +1,7 @@package io.github.hectorvent.floci.lifecycle.inithook;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.config.LocalStackParity;import jakarta.enterprise.context.ApplicationScoped;import jakarta.inject.Inject;import org.jboss.logging.Logger;@@ -39,7 +40,11 @@ public class HookScriptExecutor {LOG.debugv("Executing hook script {0} via {1}", scriptFileName, command.getFirst());// Inherit parent I/O so script output is streamed directly and does not block on unconsumed buffers.- final Process process = new ProcessBuilder(command).directory(hookDirectory).inheritIO().start();+ final ProcessBuilder builder = new ProcessBuilder(command).directory(hookDirectory).inheritIO();+ // The entrypoint script used to export the translated LocalStack settings as FLOCI_*+ // variables, and hooks read them; the translation now lives in Java, so pass it on.+ LocalStackParity.environment(System.getenv()).forEach(builder.environment()::putIfAbsent);+ final Process process = builder.start();run(process, scriptFileName);}diff --git a/src/main/java/io/github/hectorvent/floci/services/cloudfront/CloudFrontService.java b/src/main/java/io/github/hectorvent/floci/services/cloudfront/CloudFrontService.javaindex d0a8b83ce1..7619a6bd18 100644--- a/src/main/java/io/github/hectorvent/floci/services/cloudfront/CloudFrontService.java+++ b/src/main/java/io/github/hectorvent/floci/services/cloudfront/CloudFrontService.java@@ -2,6 +2,7 @@ package io.github.hectorvent.floci.services.cloudfront;import com.fasterxml.jackson.core.type.TypeReference;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.config.LocalStackParity;import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.core.common.CloudFrontEdgeDomain;import io.github.hectorvent.floci.core.common.RegionResolver;@@ -473,7 +474,7 @@ public class CloudFrontService implements ServerCertificateReferenceProvider {endpointHosts.add("localhost");EmbeddedDnsServer.BUILTIN_SUFFIXES.forEach(endpointHosts::add);config.hostname().ifPresent(endpointHosts::add);- config.dns().extraSuffixes().ifPresent(endpointHosts::addAll);+ LocalStackParity.withDnsSuffixes(config.dns().extraSuffixes()).ifPresent(endpointHosts::addAll);return endpointHosts.stream().map(host -> ".cloudfront." + host.toLowerCase(Locale.ROOT)).toList();diff --git a/src/main/java/io/github/hectorvent/floci/services/route53/Route53DnsRecordSource.java b/src/main/java/io/github/hectorvent/floci/services/route53/Route53DnsRecordSource.javaindex 1ac74c648f..b6b1880904 100644--- a/src/main/java/io/github/hectorvent/floci/services/route53/Route53DnsRecordSource.java+++ b/src/main/java/io/github/hectorvent/floci/services/route53/Route53DnsRecordSource.java@@ -1,6 +1,7 @@package io.github.hectorvent.floci.services.route53;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.config.LocalStackParity;import io.github.hectorvent.floci.core.common.DomainNames;import io.github.hectorvent.floci.core.common.dns.DnsAnswer;import io.github.hectorvent.floci.core.common.dns.DnsLookupHelper;@@ -60,7 +61,7 @@ public class Route53DnsRecordSource implements DnsRecordSource {if (config != null) {config.hostname().ifPresent(this.flociSuffixes::add);if (config.dns() != null) {- config.dns().extraSuffixes().ifPresent(this.flociSuffixes::addAll);+ LocalStackParity.withDnsSuffixes(config.dns().extraSuffixes()).ifPresent(this.flociSuffixes::addAll);}}}diff --git a/src/main/java/io/github/hectorvent/floci/services/s3/S3VirtualHostFilter.java b/src/main/java/io/github/hectorvent/floci/services/s3/S3VirtualHostFilter.javaindex f6f246bb5a..73e083e207 100644--- a/src/main/java/io/github/hectorvent/floci/services/s3/S3VirtualHostFilter.java+++ b/src/main/java/io/github/hectorvent/floci/services/s3/S3VirtualHostFilter.java@@ -1,6 +1,7 @@package io.github.hectorvent.floci.services.s3;import io.github.hectorvent.floci.config.EmulatorConfig;+import io.github.hectorvent.floci.config.LocalStackParity;import io.github.hectorvent.floci.core.common.AwsPartitions;import io.github.hectorvent.floci.core.common.AwsRegions;import io.github.hectorvent.floci.core.common.RequestHost;@@ -76,7 +77,7 @@ public class S3VirtualHostFilter implements ContainerRequestFilter {.orElseGet(() -> containerDetector.isRunningInContainer()? EmbeddedDnsServer.DEFAULT_SUFFIX: extractHostnameFromUrl(config.baseUrl()));- this.serviceHostSuffixes = buildServiceHostSuffixes(config.hostname(), config.dns().extraSuffixes());+ this.serviceHostSuffixes = buildServiceHostSuffixes(config.hostname(), LocalStackParity.withDnsSuffixes(config.dns().extraSuffixes()));this.s3ServiceInstance = s3ServiceInstance;}diff --git a/src/main/resources/META-INF/services/org.eclipse.microprofile.config.spi.ConfigSource b/src/main/resources/META-INF/services/org.eclipse.microprofile.config.spi.ConfigSourceindex 52c0f16b32..628e8e2d4c 100644--- a/src/main/resources/META-INF/services/org.eclipse.microprofile.config.spi.ConfigSource+++ b/src/main/resources/META-INF/services/org.eclipse.microprofile.config.spi.ConfigSource@@ -1,2 +1,3 @@io.github.hectorvent.floci.config.TlsConfigSourceio.github.hectorvent.floci.config.HostDefaultsConfigSource+io.github.hectorvent.floci.config.LocalStackParityConfigSourcediff --git a/src/test/java/io/github/hectorvent/floci/config/LocalStackParityTest.java b/src/test/java/io/github/hectorvent/floci/config/LocalStackParityTest.javanew file mode 100644index 0000000000..e64372cfad--- /dev/null+++ b/src/test/java/io/github/hectorvent/floci/config/LocalStackParityTest.java@@ -0,0 +1,186 @@+package io.github.hectorvent.floci.config;++import org.junit.jupiter.api.Test;++import java.util.HashMap;+import java.util.List;+import java.util.Map;+import java.util.Optional;+import java.util.Set;++import static org.hamcrest.MatcherAssert.assertThat;+import static org.hamcrest.Matchers.aMapWithSize;+import static org.hamcrest.Matchers.allOf;+import static org.hamcrest.Matchers.anEmptyMap;+import static org.hamcrest.Matchers.equalTo;+import static org.hamcrest.Matchers.greaterThan;+import static org.hamcrest.Matchers.hasKey;+import static org.hamcrest.Matchers.lessThan;+import static org.hamcrest.Matchers.not;+import static org.hamcrest.Matchers.nullValue;++/** The cases of the former docker/test-localstack-parity.sh, plus the TLS mappings it did not cover. */+class LocalStackParityTest {++ private static String value(String property, String... env) {+ Map<String, String> map = new HashMap<>();+ for (int i = 0; i < env.length; i += 2) {+ map.put(env[i], env[i + 1]);+ }+ return LocalStackParity.translate(map).get(property);+ }++ @Test+ void persistence() {+ assertThat(value("floci.storage.mode", "PERSISTENCE", "1"), equalTo("persistent"));+ assertThat(value("floci.storage.mode", "PERSISTENCE", "true"), equalTo("persistent"));+ assertThat(value("floci.storage.mode", "PERSIST_STATE", "1"), equalTo("persistent"));+ assertThat(value("floci.storage.mode", "PERSISTENCE", "0"), nullValue());+ assertThat(value("floci.storage.mode", "PERSISTENCE", "1", "FLOCI_STORAGE_MODE", "hybrid"), nullValue());+ }++ @Test+ void edgePort() {+ assertThat(value("floci.port", "EDGE_PORT", "4567"), equalTo("4567"));+ assertThat(value("floci.port", "EDGE_PORT", "4567", "FLOCI_PORT", "4568"), nullValue());+ }++ @Test+ void hostname() {+ assertThat(value("floci.hostname", "LOCALSTACK_HOST", "myhost"), equalTo("myhost"));+ assertThat(value("floci.hostname", "LOCALSTACK_HOSTNAME", "myhost2"), equalTo("myhost2"));+ assertThat(value("floci.hostname", "LOCALSTACK_HOST", "primary", "LOCALSTACK_HOSTNAME", "secondary"),+ equalTo("primary"));+ assertThat(value("floci.hostname", "LOCALSTACK_HOST", "myhost", "FLOCI_HOSTNAME", "explicit"), nullValue());+ }++ @Test+ void gatewayListen() {+ assertThat(value("quarkus.http.host", "GATEWAY_LISTEN", "0.0.0.0"), equalTo("0.0.0.0"));+ assertThat(value("floci.security.allow-unsafe-network-exposure", "GATEWAY_LISTEN", "0.0.0.0"), equalTo("true"));+ assertThat(value("floci.security.allow-unsafe-network-exposure", "GATEWAY_LISTEN", "0.0.0.0",+ "FLOCI_SECURITY_ALLOW_UNSAFE_NETWORK_EXPOSURE", "false"), nullValue());+ assertThat(value("floci.security.allow-unsafe-network-exposure"), nullValue());+ }++ @Test+ void logLevel() {+ assertThat(value("quarkus.log.level", "LS_LOG", "WARN"), equalTo("WARN"));+ assertThat(value("quarkus.log.level", "DEBUG", "1"), equalTo("DEBUG"));+ assertThat(value("quarkus.log.level", "LS_LOG", "TRACE", "DEBUG", "1"), equalTo("TRACE"));+ assertThat(value("quarkus.log.level", "LS_LOG", "DEBUG", "QUARKUS_LOG_LEVEL", "INFO"), nullValue());+ }++ @Test+ void lambda() {+ assertThat(value("floci.services.lambda.docker-network", "LAMBDA_DOCKER_NETWORK", "mynet"), equalTo("mynet"));+ assertThat(value("floci.services.lambda.docker-network", "LAMBDA_DOCKER_NETWORK", "mynet",+ "FLOCI_SERVICES_LAMBDA_DOCKER_NETWORK", "floci-net"), nullValue());+ assertThat(value("floci.services.lambda.ephemeral", "LAMBDA_REMOVE_CONTAINERS", "1"), equalTo("true"));+ assertThat(value("floci.services.lambda.ephemeral", "LAMBDA_REMOVE_CONTAINERS", "true"), equalTo("true"));+ assertThat(value("floci.services.lambda.ephemeral", "LAMBDA_REMOVE_CONTAINERS", "1",+ "FLOCI_SERVICES_LAMBDA_EPHEMERAL", "false"), nullValue());+ }++ @Test+ void dockerHostAndNetwork() {+ assertThat(value("floci.docker.docker-host", "DOCKER_HOST", "unix:///var/run/docker.sock"),+ equalTo("unix:///var/run/docker.sock"));+ assertThat(value("floci.services.docker-network", "DOCKER_NETWORK", "shared"), equalTo("shared"));+ assertThat(value("floci.services.docker-network", "DOCKER_NETWORK", "shared",+ "FLOCI_SERVICES_DOCKER_NETWORK", "override"), nullValue());+ }++ @Test+ void dnsSuffixesAreAppendedToWhateverIsConfigured() {+ // Not a translated property: it would outrank and replace suffixes set in application.yml.+ assertThat(value("floci.dns.extra-suffixes"), nullValue());+ assertThat(LocalStackParity.withDnsSuffixes(Optional.empty(), Map.of()),+ equalTo(Optional.of(List.of("localhost.localstack.cloud", "localhost.floci.io"))));+ assertThat(LocalStackParity.withDnsSuffixes(Optional.of(List.of("custom.internal", "localhost.floci.io")),+ Map.of()),+ equalTo(Optional.of(List.of("custom.internal", "localhost.floci.io", "localhost.localstack.cloud"))));+ assertThat(LocalStackParity.withDnsSuffixes(Optional.of(List.of("custom.internal")),+ Map.of("LOCALSTACK_PARITY", "false")),+ equalTo(Optional.of(List.of("custom.internal"))));+ }++ @Test+ void gatewayListenWithAPortGivesTheHostAndThePort() {+ assertThat(value("quarkus.http.host", "GATEWAY_LISTEN", "0.0.0.0:4566"), equalTo("0.0.0.0"));+ assertThat(value("floci.port", "GATEWAY_LISTEN", "0.0.0.0:4567"), equalTo("4567"));+ assertThat(value("quarkus.http.host", "GATEWAY_LISTEN", "[::]:4566,0.0.0.0:443"), equalTo("::"));+ assertThat(value("quarkus.http.host", "GATEWAY_LISTEN", "0.0.0.0"), equalTo("0.0.0.0"));+ assertThat(value("floci.port", "GATEWAY_LISTEN", "0.0.0.0:4567", "EDGE_PORT", "4570"), equalTo("4570"));+ assertThat(value("floci.port", "GATEWAY_LISTEN", "0.0.0.0:4567", "FLOCI_PORT", "4571"), nullValue());+ }++ @Test+ void gatewayListenWithOnlyAPortKeepsFlociBindAddress() {+ assertThat(value("floci.port", "GATEWAY_LISTEN", ":4566"), equalTo("4566"));+ assertThat(value("quarkus.http.host", "GATEWAY_LISTEN", ":4566"), nullValue());+ assertThat(value("floci.security.allow-unsafe-network-exposure", "GATEWAY_LISTEN", ":4566"), nullValue());+ assertThat(value("quarkus.http.host", "GATEWAY_LISTEN", "[::1]"), equalTo("::1"));+ }++ @Test+ void localstackHostDropsItsPort() {+ assertThat(value("floci.hostname", "LOCALSTACK_HOST", "localhost.localstack.cloud:4566"),+ equalTo("localhost.localstack.cloud"));+ assertThat(value("floci.hostname", "LOCALSTACK_HOSTNAME", "myhost:4567"), equalTo("myhost"));+ assertThat(value("floci.hostname", "LOCALSTACK_HOST", ":4566"), nullValue());+ }++ @Test+ void hostAndPortFollowLocalStacksForms() {+ assertThat(LocalStackParity.parseHostAndPort("0.0.0.0:4566"),+ equalTo(new LocalStackParity.HostAndPort("0.0.0.0", "4566")));+ assertThat(LocalStackParity.parseHostAndPort("0.0.0.0"), equalTo(new LocalStackParity.HostAndPort("0.0.0.0", null)));+ assertThat(LocalStackParity.parseHostAndPort(":4566"), equalTo(new LocalStackParity.HostAndPort(null, "4566")));+ assertThat(LocalStackParity.parseHostAndPort("[::]:4566"), equalTo(new LocalStackParity.HostAndPort("::", "4566")));+ assertThat(LocalStackParity.parseHostAndPort("[::1]"), equalTo(new LocalStackParity.HostAndPort("::1", null)));+ }++ @Test+ void hooksGetTheTranslationAsVariables() {+ Map<String, String> env = LocalStackParity.environment(Map.of("EDGE_PORT", "4567", "PERSISTENCE", "1"));+ assertThat(env.get("FLOCI_PORT"), equalTo("4567"));+ assertThat(env.get("FLOCI_STORAGE_MODE"), equalTo("persistent"));+ assertThat(env.get("FLOCI_DNS_EXTRA_SUFFIXES"), equalTo("localhost.localstack.cloud,localhost.floci.io"));+ assertThat(LocalStackParity.environment(Map.of("EDGE_PORT", "4567", "FLOCI_PORT", "4568")),+ not(hasKey("FLOCI_PORT")));+ assertThat(LocalStackParity.environment(Map.of("LOCALSTACK_PARITY", "false", "EDGE_PORT", "4567")),+ anEmptyMap());+ }++ @Test+ void tls() {+ assertThat(value("floci.tls.enabled", "USE_SSL", "1"), equalTo("true"));+ assertThat(value("floci.tls.enabled", "USE_SSL", "0"), nullValue());+ assertThat(value("floci.tls.enabled", "USE_SSL", "1", "FLOCI_TLS_ENABLED", "false"), nullValue());+ assertThat(value("floci.tls.cert-path", "CUSTOM_SSL_CERT_PATH", "/certs/ls.pem"), equalTo("/certs/ls.pem"));+ assertThat(value("floci.tls.key-path", "CUSTOM_SSL_CERT_PATH", "/certs/ls.pem"), equalTo("/certs/ls.pem"));+ }++ @Test+ void disabledTranslatesNothing() {+ assertThat(LocalStackParity.translate(Map.of("LOCALSTACK_PARITY", "false", "EDGE_PORT", "4567")),+ aMapWithSize(0));+ assertThat(LocalStackParity.translate(Map.of("LOCALSTACK_PARITY", "true", "EDGE_PORT", "4567")),+ hasKey("floci.port"));+ }++ @Test+ void ignoredVariablesProduceNothing() {+ Map<String, String> out = LocalStackParity.translate(Map.of("LAMBDA_EXECUTOR", "local", "SERVICES", "s3"));+ assertThat(out.keySet(), equalTo(Set.of()));+ assertThat(out, not(hasKey("floci.services.lambda.executor")));+ }++ @Test+ void ordinalSitsBelowEnvironmentAndTlsButAboveTheConfigFiles() {+ // .env is 295, config/application.yml 265; environment variables and TlsConfigSource are 300.+ assertThat(new LocalStackParityConfigSource(Map.of()).getOrdinal(), allOf(greaterThan(295), lessThan(300)));+ assertThat(new TlsConfigSource().getOrdinal(), greaterThan(new LocalStackParityConfigSource(Map.of()).getOrdinal()));+ }+}