Merged in feature/service-accounts-1 (pull request #227)

Support for service accounts with static credentials

* feature complete

* tests and docs

* lint fix

scripts/local-deployments.yml

@@ -11,16 +11,19 @@ vars:
 
 tasks:
   build:test:
+    desc: "Build containers using compose.test.yaml"
     cmds:
       - task: build
         vars:
           COMPOSE_FILE: "{{.TEST_COMPOSE_FILE}}"
   build:generate:
+    desc: "Build containers using compose.generate.yaml (used by code generation)"
     cmds:
       - task: build
         vars:
           COMPOSE_FILE: "{{.GENERATE_COMPOSE_FILE}}"
   build:
+    desc: "Build containers for the local compose stack (default: compose.local.yaml)"
     vars:
       COMPOSE_FILE: "{{.COMPOSE_FILE | default .LOCAL_COMPOSE_FILE}}"
     cmds:
@@ -39,16 +42,19 @@ tasks:
     cmds:
       - docker compose -f {{.COMPOSE_FILE}} up localstack db prometheus -d --wait
   up:test:
+    desc: "Bring up the test compose stack in the background"
     cmds:
       - task: up:cmd
         vars:
           COMPOSE_FILE: "{{.TEST_COMPOSE_FILE}}"
   up:generate:
+    desc: "Bring up the generate compose stack (postgres used by db:generate)"
     run: once
     cmd: |
       docker compose -f {{.GENERATE_COMPOSE_FILE}} up \
       --wait -d
   up:aws:
+    desc: "Build and start the local AWS-services compose stack (localstack-backed)"
     cmds:
       - task deps:tidy
       - task docker:build
@@ -58,6 +64,7 @@ tasks:
           COMPOSE_FILE: "{{.AWS_COMPOSE_FILE}}"
       - task: init
   up:
+    desc: "Tidy deps, build images, and bring up the full local compose stack"
     cmds:
       - task deps:tidy
       - task docker:build
@@ -66,6 +73,7 @@ tasks:
       - task: init
       - task: up:cmd
   refresh:
+    desc: "Rebuild images and recycle the local stack (down then up:infra + services)"
     cmds:
       - task deps:tidy
       - task docker:build
@@ -98,31 +106,37 @@ tasks:
             }]
         }'
   down:test:
+    desc: "Stop containers from the test compose stack"
     cmds:
       - task: down
         vars:
           COMPOSE_FILE: "{{.TEST_COMPOSE_FILE}}"
   down:aws:
+    desc: "Stop containers from the AWS-services compose stack"
     cmds:
       - task: down
         vars:
           COMPOSE_FILE: "{{.AWS_COMPOSE_FILE}}"
   down:
+    desc: "Stop containers for the local compose stack (run before fullsuite:ci)"
     vars:
       COMPOSE_FILE: "{{.COMPOSE_FILE | default .LOCAL_COMPOSE_FILE}}"
     cmds:
       - docker compose -f {{.COMPOSE_FILE}} down
   clean:
+    desc: "Stop and remove containers AND volumes for the local compose stack"
     vars:
       COMPOSE_FILE: "{{.COMPOSE_FILE | default .LOCAL_COMPOSE_FILE}}"
     cmds:
       - docker compose -f {{.COMPOSE_FILE}} down -v
   clean:test:
+    desc: "Stop and remove containers AND volumes for the test compose stack"
     cmds:
       - task: clean
         vars:
           COMPOSE_FILE: "{{.TEST_COMPOSE_FILE}}"
   clean:aws:
+    desc: "Stop and remove containers AND volumes for the AWS compose stack"
     run: once
     cmds:
       - task: clean
@@ -135,6 +149,7 @@ tasks:
     cmds:
       - docker compose -f {{.COMPOSE_FILE}} config -q
   lint:
+    desc: "Validate all compose files (local, test, generate, aws) with `compose config`"
     deps:
       - task: lint:cmd
         vars: