Update example orch (#38)

* Add uv pyproject.toml; updates to compose.yaml

Started to bring things up-to-date and deal with some TODO items

* tag overrides; sql template gitignore; doc updates

* Create netbox SQL schema template (speed-up start)

Author: Sparrow1029

docker-compose.yml

@@ -35,7 +35,7 @@ services:
       POSTGRES_DB: orchestrator-core
     volumes:
       - db-data:/var/lib/postgresql/data/
-      - ./docker/postgresql/init.sql:/docker-entrypoint-initdb.d/init.sql
+      - ./docker/postgresql:/docker-entrypoint-initdb.d
     healthcheck:
       test:
         [
@@ -144,7 +144,7 @@ services:
 
   orchestrator-ui:
     container_name: orchestrator-ui
-    image: "ghcr.io/workfloworchestrator/example-orchestrator-ui:3.4.0"  # TODO make it possible to override the tag
+    image: ${ORCH_UI_TAG:-ghcr.io/workfloworchestrator/example-orchestrator-ui:5.3.4}
     env_file:
       - ./docker/orchestrator-ui/orchestrator-ui.env
       - path: ./docker/overrides/orchestrator-ui/orchestrator-ui.env
@@ -157,7 +157,7 @@ services:
 
   orchestrator:
     container_name: orchestrator
-    image: "ghcr.io/workfloworchestrator/orchestrator-core:latest"  # TODO make it possible to override the tag
+    image: ${ORCH_BACKEND_TAG:-ghcr.io/workfloworchestrator/orchestrator-core:latest}
     env_file:
       - ./docker/orchestrator/orchestrator.env
       - path: ./docker/overrides/orchestrator/orchestrator.env

docker/orchestrator-ui/orchestrator-ui.env

@@ -19,3 +19,5 @@ NEXTAUTH_PROVIDER_NAME=""
 NEXTAUTH_AUTHORIZATION_SCOPE_OVERRIDE=""
 OIDC_CONF_FULL_WELL_KNOWN_URL=""
 OAUTH2_ACTIVE=false
+AO_STACK_STATUS_URL=""
+ENABLE_AO_STACK_STATUS=false

docker/overrides/configuration.md

@@ -26,3 +26,18 @@ CORE_DIR=/path/to/my/orchestrator-core
 This orchestrator-core version is then installed into the container with hot reloading enabled.
 
 **Note**: before changing CORE_DIR, any new database migrations should be manually reverted.
+
+## Orchestrator UI & backend docker image overrides
+
+In [docker-compose.yml](../../docker-compose.yml), the `orchestrator` and
+`orchestrator-ui` services use pre-built images to spin up their respective
+applications (i.e., there is no `build:` directive specified). The docker image
+tag defaults to use the artifacts built in the workfloworchestrator project's
+Github Container Registry, but can be overridden by setting environment
+variables.
+
+### For Example
+
+```bash
+ORCH_UI_IMAGE=my-local-image:tag docker compose up -d --force-recreate
+```

docker/postgresql/.gitignore

@@ -0,0 +1,2 @@
+*.sql
+!init.sql