docker-compose-dev.yml

services:

  # Named volumes (fast, native filesystem) for the npm download
  # caches below are created root-owned by Docker on first use, which the
  # non-root *host-user containers can't write into - chown them once here
  # before anything else starts.
  zendro-cache-init:
    container_name: zendro-cache-init
    image: busybox
    volumes:
      - gql_npm_cache:/cache/gql-npm
      - spa_npm_cache:/cache/spa-npm
      - giql_npm_cache:/cache/giql-npm
    command:
      - sh
      - -c
      - |
        chown -R "${UID_GID}" /cache/gql-npm /cache/spa-npm /cache/giql-npm

  zendro-keycloak-postgres:
    container_name: zendro-keycloak-postgres
    image: postgres
    volumes:
      - keycloak_pg_data:/var/lib/postgresql
    environment:
      POSTGRES_DB: ${KEYCLOAK_DATABASE_NAME}
      POSTGRES_USER: ${KEYCLOAK_DATABASE_USER}
      POSTGRES_PASSWORD: ${KEYCLOAK_DATABASE_PASSWORD}
    networks:
      zendro:

  zendro-keycloak:
    container_name: zendro-keycloak
    image: quay.io/keycloak/keycloak:26.2.0
    entrypoint: ["/opt/keycloak/bin/kc.sh", "start-dev"]
    ports:
      - ${KEYCLOAK_HOSTNAME_PORT}:${KEYCLOAK_HOSTNAME_PORT}
    environment:
      KC_DB: ${KEYCLOAK_DATABASE_VENDOR}
      KC_DB_URL_HOST: ${KEYCLOAK_DATABASE_HOST}
      KC_DB_URL_DATABASE: ${KEYCLOAK_DATABASE_NAME}
      KC_DB_USERNAME: ${KEYCLOAK_DATABASE_USER}
      KC_DB_SCHEMA: ${KEYCLOAK_DATABASE_SCHEMA}
      KC_DB_PASSWORD: ${KEYCLOAK_DATABASE_PASSWORD}
      KC_BOOTSTRAP_ADMIN_USERNAME: ${KEYCLOAK_ADMIN_USER}
      KC_BOOTSTRAP_ADMIN_PASSWORD: ${KEYCLOAK_ADMIN_PASSWORD}
      KC_HTTP_RELATIVE_PATH: ${KEYCLOAK_HTTP_RELATIVE_PATH}
      KC_HTTP_PORT: ${KEYCLOAK_HOSTNAME_PORT}
      KC_HOSTNAME: http://${KEYCLOAK_HOSTNAME}:${KEYCLOAK_HOSTNAME_PORT}${KEYCLOAK_HTTP_RELATIVE_PATH}
      KC_HOSTNAME_BACKCHANNEL_DYNAMIC: true
    depends_on:
      - zendro-keycloak-postgres
    networks:
      zendro:

  zendro-graphql-server-migrations:
    container_name: zendro-graphql-server-migrations
    depends_on:
      zendro-keycloak:
        condition: service_started
      zendro-cache-init:
        condition: service_completed_successfully
    build: &gql-server-build
      context: ./contexts
      dockerfile: Dockerfile.graphql_server
    volumes: &gql-server-volumes
      - ./graphql-server:/usr/graphql-server
      # override default default config with Starterpack config
      - ./config/data_models_storage_config.json:/usr/graphql-server/config/data_models_storage_config.json
      - ./graphiql-auth/.env:/usr/graphiql-auth/.env
      - ./single-page-app/.env.development:/usr/single-page-app/.env.development
      - ./single-page-app/.env.production:/usr/single-page-app/.env.production
      # npm's own download cache (package tarballs/metadata) - separate
      # from node_modules above. A named volume, not a path inside the
      # bind mount above: node_modules and this repo live on a Windows
      # drive bind-mounted through WSL2 (9p/drvfs), which is slow for the
      # high volume of small-file I/O a populated npm cache involves -
      # confirmed this was causing real ESOCKETTIMEDOUT install failures
      # under load. A named volume is native filesystem, no such penalty.
      - gql_npm_cache:/usr/graphql-server/.npm-cache
    # Run as the host user so files written to the bind-mounted volumes above
    # (e.g. node_modules) are not owned by root on the host.
    user: &host-user "${UID_GID}"
    environment: &host-user-env
      # With HOME unset, npm would default its cache to $HOME/.npm, which
      # isn't guaranteed to be writable for an arbitrary host UID with no
      # /etc/passwd entry - point it at the named volume mounted above
      # instead.
      HOME: /tmp
      npm_config_cache: /usr/graphql-server/.npm-cache
    # Await POSTGRES role and DB creation, migrate schema, then start web
    # server:
    networks: &gql-server-networks
      zendro:
      datastores:
    command:
      - /bin/sh
      - -c
      - |
        set -e
        npm install
        # @vscode/sqlite3 (graphql-server's sqlite driver, replacing the
        # now-archived sqlite3) has no working prebuilt-binary fetch path -
        # it always compiles from source via node-gyp, and its own install
        # script is blocked by graphql-server's allowScripts, so it has to
        # be rebuilt explicitly here.
        npm rebuild @vscode/sqlite3
        npm run build:graphiql
        node migrateDb.js up

  zendro-graphql-server:
    container_name: zendro-graphql-server
    depends_on: &migrations
      zendro-graphql-server-migrations:
        condition: service_completed_successfully
        restart: true
    build: *gql-server-build
    ports:
      - 3000:3000
    volumes: *gql-server-volumes
    user: *host-user
    environment: *host-user-env

    # Await POSTGRES role and DB creation, migrate schema, then start web
    # server:
    networks: *gql-server-networks
    command:
      - /bin/sh
      - -c
      - |
        node startServer.js dev

  zendro-spa-install:
    container_name: zendro-spa-install
    # Workaround. See https://github.com/facebook/create-react-app/issues/8688
    depends_on:
      <<: *migrations
      zendro-cache-init:
        condition: service_completed_successfully
    build: &spa-build
      context: ./contexts
      dockerfile: Dockerfile.spa
    volumes: &spa-volumes
      - ./single-page-app:/usr/single-page-app
      - ./data_model_definitions:/usr/data_model_definitions
      # See the npm_config_cache comment on zendro-graphql-server-migrations
      # above.
      - spa_npm_cache:/usr/single-page-app/.npm-cache
    user: *host-user
    environment: &spa-env
      HOME: /tmp
      npm_config_cache: /usr/single-page-app/.npm-cache
    command:
      - /bin/sh
      - -c
      - |
        set -e
        npm install
        rm -rf .next

  zendro-spa:
    container_name: zendro-spa
    # Workaround. See https://github.com/facebook/create-react-app/issues/8688
    stdin_open: true
    depends_on:
      zendro-spa-install:
        condition: service_completed_successfully
        restart: true
    build: *spa-build
    ports:
      - 8080:8080
    volumes: *spa-volumes
    user: *host-user
    environment: *spa-env
    networks:
      zendro:
    # Install dependencies and start single-page-app-server in development
    # mode.
    command:
      - /bin/sh
      - -c
      - |
        npm run dev

  zendro-graphiql-install:
    container_name: zendro-graphiql-install
    depends_on:
      <<: *migrations
      zendro-cache-init:
        condition: service_completed_successfully
    build: &giql-build
      context: ./contexts
      dockerfile: Dockerfile.graphiql
    volumes: &giql-volumes
      - ./graphiql-auth:/usr/graphiql-auth
      # See the npm_config_cache comment on zendro-graphql-server-migrations
      # above.
      - giql_npm_cache:/usr/graphiql-auth/.npm-cache
    user: *host-user
    environment: &giql-env
      HOME: /tmp
      npm_config_cache: /usr/graphiql-auth/.npm-cache
    command:
      - /bin/sh
      - -c
      - |
        set -e
        npm install
        npm run build:graphiql

  zendro-graphiql:
    container_name: zendro-graphiql
    # Workaround. See https://github.com/facebook/create-react-app/issues/8688
    stdin_open: true
    depends_on:
      zendro-graphiql-install:
        condition: service_completed_successfully
        restart: true
    build: *giql-build
    ports:
      - 7070:7070
    volumes: *giql-volumes
    user: *host-user
    environment: *giql-env
    # Install dependencies and start single-page-app-server in development
    # mode.
    networks:
      zendro:
    command:
      - /bin/sh
      - -c
      - |
        npm run dev

volumes:
  zendro_db_data:
  keycloak_pg_data:
  gql_npm_cache:
  spa_npm_cache:
  giql_npm_cache:

networks:
  zendro:
  datastores: