Task & service examples

services:
  postgresql:
    name: PostgreSQL
    description: Development database
    triggeredBy:
      - postDevcontainerStart
    commands:
      start: docker run --rm --name postgres -e POSTGRES_PASSWORD=postgres -p 5432:5432 postgres:15
      ready: docker exec postgres pg_isready -U postgres
      stop: docker stop postgres

tasks:
  seed:
    name: Seed database
    triggeredBy:
      - manual
    command: ./scripts/seed-dev-db.sh

services:
  redis:
    name: Redis
    description: In-memory cache
    triggeredBy:
      - postDevcontainerStart
    commands:
      start: |
        if docker inspect redis >/dev/null 2>&1; then
          docker start -a redis
        else
          docker run --name redis -p 6379:6379 \
            -e REDIS_MAXMEMORY=256mb \
            -e REDIS_MAXMEMORY_POLICY=allkeys-lru \
            redis:7-alpine
        fi
      ready: docker exec redis redis-cli ping | grep -q PONG
      stop: docker stop redis

  elasticsearch:
    name: Elasticsearch
    description: Search engine
    triggeredBy:
      - manual
    commands:
      start: |
        if docker inspect elasticsearch >/dev/null 2>&1; then
          docker start -a elasticsearch
        else
          docker run --name elasticsearch -p 9200:9200 \
            -e discovery.type=single-node \
            -e xpack.security.enabled=false \
            -e ES_JAVA_OPTS="-Xms512m -Xmx512m" \
            elasticsearch:8.11.0
        fi
      ready: curl -sf http://localhost:9200/_cluster/health
      stop: docker stop elasticsearch

tasks:
  install-deps:
    name: Install dependencies
    description: Install and cache all dependencies
    triggeredBy:
      - prebuild
    command: |
      npm ci
      go mod download
      pip install -r requirements.txt

  build-assets:
    name: Build static assets
    description: Compile CSS and bundle JavaScript
    triggeredBy:
      - prebuild
    dependsOn:
      - install-deps
    command: npm run build:assets

  warm-cache:
    name: Warm build cache
    description: Pre-compile common modules
    triggeredBy:
      - prebuild
    dependsOn:
      - install-deps
    command: go build -v ./...

tasks:
  build:
    name: Build
    command: yarn && yarn build

  test:
    name: Run tests
    dependsOn:
      - build
    command: yarn test

  setup:
    name: Full setup
    dependsOn:
      - build
      - test
    triggeredBy:
      - postDevcontainerStart
    command: echo "Ready to develop"

tasks:
  aws-auth:
    name: AWS Auth
    triggeredBy:
      - postEnvironmentStart
    command: ona idp login aws --role arn:aws:iam::123456789:role/dev-role

services:
  preview:
    name: Preview server
    triggeredBy:
      - postDevcontainerStart
    commands:
      start: |
        npm install
        npm run build
        npx serve -p 3000 ./build
      ready: curl -sf http://localhost:3000 > /dev/null

services:
  jupyter:
    name: Jupyter Notebook
    triggeredBy:
      - manual
    commands:
      start: |
        pip install jupyter pandas numpy matplotlib
        jupyter notebook --ip=0.0.0.0 --no-browser
      ready: curl -sf http://localhost:8888 > /dev/null

services:
  storybook:
    name: Storybook
    triggeredBy:
      - manual
    commands:
      start: yarn storybook
      ready: curl -sf http://localhost:6006 > /dev/null

services:
  pg14:
    name: Postgres 14
    commands:
      start: docker run --rm --name pg14 -p 5432:5432 postgres:14
      ready: docker exec pg14 pg_isready
      stop: docker stop pg14

  pg15:
    name: Postgres 15
    commands:
      start: docker run --rm --name pg15 -p 5433:5432 postgres:15
      ready: docker exec pg15 pg_isready
      stop: docker stop pg15

tasks:
  test-compat:
    name: Compatibility tests
    triggeredBy:
      - manual
    command: |
      DATABASE_URL=postgres://localhost:5432 npm test
      DATABASE_URL=postgres://localhost:5433 npm test

tasks:
  troubleshoot:
    name: Setup troubleshooting
    triggeredBy:
      - manual
    command: |
      sudo apt-get update && sudo apt-get install -y htop iftop
      ./scripts/setup-vpn.sh