Introduce mirrored reads [RHELDST-28332]

This commit modifies exodus-cdn's lookup behavior to enable mirrored
reads. This means, that when exodus-cdn looks up content to be served
for a path with a $releasever alias in effect, exodus-cdn attempts to
look up content on both sides of the alias. (Previously, exodus-cdn
only performed a content lookup on the destination side.)

The mirrored reads are enabled by default, but they can be disabled
by setting the new config option "mirrored_reads" to false (0, '0',
or 'False', where 'False' is not case sensitive.)

Author: crungehottman

configuration/lambda_config.template

@@ -17,6 +17,7 @@
   "headers": {
     "max_age": $EXODUS_HEADERS_MAX_AGE
   },
+  "mirror_reads": "$EXODUS_MIRROR_READS",
   "lambda_version": "$EXODUS_LAMBDA_VERSION",
   "index_filename": "$EXODUS_INDEX_FILENAME",
   "logging": {

exodus_lambda/functions/base.py

@@ -59,6 +59,15 @@ def lambda_version(self):
     def index(self):
         return self.conf["index_filename"]
 
+    @property
+    def mirror_reads(self):
+        if str(self.conf.get("mirror_reads", "true")).lower() in (
+            "0",
+            "false",
+        ):
+            return False
+        return True
+
     def set_lambda_version(self, response):
         response.setdefault("headers", {})["x-exodus-version"] = [
             {"key": "X-Exodus-Version", "value": self.lambda_version}

exodus_lambda/functions/origin_request.py

@@ -126,12 +126,14 @@ def uri_alias(self, uri, aliases, ignore_exclusions=False):
 
         return uri
 
-    def resolve_aliases(self, uri, ignore_exclusions=False):
+    def resolve_aliases(
+        self, uri, ignore_exclusions=False, ignore_releasever=False
+    ):
         # aliases relating to origin, e.g. content/origin <=> origin
-
         uri = self.uri_alias(
             uri, self.definitions.get("origin_alias"), ignore_exclusions
         )
+
         # aliases relating to rhui; listing files are a special exemption
         # because they must be allowed to differ for rhui vs non-rhui.
         if not uri.endswith("/listing"):
@@ -140,9 +142,12 @@ def resolve_aliases(self, uri, ignore_exclusions=False):
             )
 
         # aliases relating to releasever; e.g. /content/dist/rhel8/8 <=> /content/dist/rhel8/8.5
-        uri = self.uri_alias(
-            uri, self.definitions.get("releasever_alias"), ignore_exclusions
-        )
+        if not ignore_releasever:
+            uri = self.uri_alias(
+                uri,
+                self.definitions.get("releasever_alias"),
+                ignore_exclusions,
+            )
 
         self.logger.debug("Resolved request URI: %s", uri)
 
@@ -393,6 +398,23 @@ def handler(self, event, context):
         if preferred_uri != fallback_uri:
             uris.append(fallback_uri)
 
+        # When exodus-cdn is looking up content to be served for a path having a
+        # $releasever alias in effect, it should attempt to look up content on
+        # both sides of the alias.
+        if self.mirror_reads:
+            # Attempt to look up content on the other side of the alias (the original
+            # path.)
+            # Note: Only the releasever alias is left unresolved. Other alias types
+            # (rhui and origin aliases) are resolved.
+            for ignore_exclusions in (False, True):
+                mirrored_uri = self.resolve_aliases(
+                    request["uri"],
+                    ignore_exclusions=ignore_exclusions,
+                    ignore_releasever=True,
+                )
+                if mirrored_uri not in uris:
+                    uris.append(mirrored_uri)
+
         for uri in uris:
             if listing_response := self.handle_listing_request(uri):
                 self.set_cache_control(uri, listing_response)

scripts/mk-config

@@ -12,6 +12,7 @@ export ENV_TYPE=${ENV_TYPE:-dev}
 export EXODUS_TABLE=${EXODUS_TABLE:-$PROJECT-cdn-$ENV_TYPE}
 export EXODUS_CONFIG_TABLE=${EXODUS_CONFIG_TABLE:-$PROJECT-config-$ENV_TYPE}
 export EXODUS_INDEX_FILENAME=${EXODUS_INDEX_FILENAME:-.__exodus_autoindex}
+export EXODUS_MIRROR_READS=${EXODUS_MIRROR_READS:-true}
 
 REVISION="${CODEBUILD_RESOLVED_SOURCE_VERSION:-$(git rev-parse HEAD)}"
 export EXODUS_LAMBDA_VERSION="${EXODUS_LAMBDA_VERSION:-$(date -u --iso=s) ${REVISION}}"

tests/conftest.py

@@ -86,6 +86,7 @@ def mock_conf_file():
     test_env["ORIGIN_REQUEST_LOGGER_LEVEL"] = "DEBUG"
     test_env["EXODUS_LAMBDA_VERSION"] = "fake version"
     test_env["EXODUS_INDEX_FILENAME"] = ".__exodus_autoindex"
+    test_env["EXODUS_MIRRORED_READS"] = ""
 
     subprocess.run(
         ["envsubst"],

tests/functions/test_base.py

@@ -133,3 +133,34 @@ def test_json_logger_configurable_datefmt(caplog):
             "response": None,
         },
     ]
+
+
+@pytest.mark.parametrize(
+    "config_value,enabled",
+    [
+        ("", True),
+        ("True", True),
+        ("true", True),
+        (1, True),
+        ("1", True),
+        ("false", False),
+        ("0", False),
+        (0, False),
+    ],
+    ids=[
+        "empty string, unset",
+        "mixed case true",
+        "lowercase true",
+        "int 1",
+        "string 1",
+        "false string",
+        "string 0",
+        "int 0",
+    ],
+)
+def test_mirrored_reads(config_value, enabled):
+    """Verify that the mirror_reads config value produces the expected
+    mirror_reads property."""
+    conf = copy.deepcopy(TEST_CONF)
+    conf["mirror_reads"] = config_value
+    assert LambdaBase(conf_file=conf).mirror_reads == enabled