Run LocalCloud in team CI

name: localcloud-integration-tests
on: [pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Start LocalCloud
        run: |
          # Public preview permits non-production internal organization and team CI.
          # Pin an image digest when the workflow must be repeatable.
          docker volume create localcloud-data

          docker run -d --name localcloud \
            -p 127.0.0.1:5380-5405:5380-5405 \
            -m 4g \
            -v localcloud-data:/var/lib/localcloud \
            agentcloud/localcloud:latest
          for i in $(seq 1 60); do curl -fsS http://localhost:5380/readiness && exit 0; sleep 2; done
          docker logs localcloud
          exit 1
      - name: Export emulator env and test
        run: |
          eval "$(curl -fsS 'http://localhost:5380/env?format=shell')"
          ./scripts/integration-test.sh

The GitHub Actions workflow guide covers the readiness gate and why the job needs no Google Cloud credentials.

integration-tests:
  image: python:3.12
  services:
    - name: agentcloud/localcloud:latest
      alias: localcloud
  variables:
    BIGQUERY_EMULATOR_HOST: http://localcloud:5388
    PUBSUB_EMULATOR_HOST: localcloud:5383
  before_script:
    - pip install -r requirements.txt
    - |
      for i in $(seq 1 30); do
        if curl -fsS http://localcloud:5380/health; then exit 0; fi
        sleep 2
      done
      exit 1
  script:
    - pytest tests/integration/

pipeline {
  agent { docker { image 'python:3.12' } }
  stages {
    stage('Integration Tests') {
      steps {
        docker.image('agentcloud/localcloud:latest')
          .withRun('--memory 4g -p 5388:5388 -p 5383:5383') { c ->
            docker.image('appropriate/curl')
              .inside("--link ${c.id}:localcloud") {
                sh """
                  for i in $(seq 1 30); do
                    if curl -fsS http://localcloud:5380/health; then exit 0; fi
                    sleep 2
                  done
                  exit 1
                """
              }
            withEnv([
              'BIGQUERY_EMULATOR_HOST=http://localcloud:5388',
              'PUBSUB_EMULATOR_HOST=localcloud:5383'
            ]) {
              sh 'pytest tests/integration/'
            }
          }
      }
    }
  }
}