✨(backend) introduce an external API router

Prepare for the introduction of new endpoints reserved for external
applications. Configure the required router and update the Helm chart to ensure
that the Kubernetes ingress properly routes traffic to these new endpoints.

It is important to support independent versioning of both APIs.
Base route’s name aligns with PR #195 on lasuite/drive, opened by @lunika

src/backend/core/external_api/__init__.py

@@ -0,0 +1 @@
+"""Meet core external API endpoints"""

src/backend/core/urls.py

@@ -17,6 +17,9 @@ router.register(
     "resource-accesses", viewsets.ResourceAccessViewSet, basename="resource_accesses"
 )
 
+# - External API
+external_router = DefaultRouter()
+
 urlpatterns = [
     path(
         f"api/{settings.API_VERSION}/",
@@ -28,4 +31,12 @@ urlpatterns = [
             ]
         ),
     ),
+    path(
+        f"external-api/{settings.EXTERNAL_API_VERSION}/",
+        include(
+            [
+                *external_router.urls,
+            ]
+        ),
+    ),
 ]

src/backend/meet/settings.py

@@ -69,6 +69,7 @@ class Base(Configuration):
     USE_SWAGGER = False
 
     API_VERSION = "v1.0"
+    EXTERNAL_API_VERSION = "v1.0"
 
     DATA_DIR = values.Value(path.join("/", "data"), environ_name="DATA_DIR")
 

src/helm/meet/Chart.yaml

@@ -1,4 +1,4 @@
 apiVersion: v2
 type: application
 name: meet
-version: 0.0.12
+version: 0.0.13-beta.1

src/helm/meet/templates/ingress.yaml

@@ -74,6 +74,20 @@ spec:
               serviceName: {{ include "meet.backend.fullname" . }}
               servicePort: {{ .Values.backend.service.port }}
             {{- end }}
+          - path: /external-api/
+            {{- if semverCompare ">=1.18-0" $.Capabilities.KubeVersion.GitVersion }}
+            pathType: Prefix
+            {{- end }}
+            backend:
+              {{- if semverCompare ">=1.19-0" $.Capabilities.KubeVersion.GitVersion }}
+              service:
+                name: {{ include "meet.backend.fullname" . }}
+                port:
+                  number: {{ .Values.backend.service.port }}
+              {{- else }}
+              serviceName: {{ include "meet.backend.fullname" . }}
+              servicePort: {{ .Values.backend.service.port }}
+            {{- end }}
           {{- with .Values.ingress.customBackends }}
             {{- toYaml . | nindent 10 }}
           {{- end }}
@@ -110,6 +124,20 @@ spec:
               serviceName: {{ include "meet.backend.fullname" $ }}
               servicePort: {{ $.Values.backend.service.port }}
             {{- end }}
+          - path: /external-api/
+            {{- if semverCompare ">=1.18-0" $.Capabilities.KubeVersion.GitVersion }}
+            pathType: Prefix
+            {{- end }}
+            backend:
+              {{- if semverCompare ">=1.19-0" $.Capabilities.KubeVersion.GitVersion }}
+              service:
+                name: {{ include "meet.backend.fullname" $ }}
+                port:
+                  number: {{ $.Values.backend.service.port }}
+              {{- else }}
+              serviceName: {{ include "meet.backend.fullname" $ }}
+              servicePort: {{ $.Values.backend.service.port }}
+            {{- end }}
           {{- with $.Values.ingress.customBackends }}
             {{- toYaml . | nindent 10 }}
           {{- end }}