Remote Docker Gateway¶

Once you have Racetrack up and running somewhere, you might want to connect it to remote Docker Daemon host to keep your Jobs there. In other words, you can distribute services between 2 separate infrastructures:

Main Hub - hosting core Racetrack services
Remote Jobs cluster - an infrastructure hosting jobs and remote Pub gateway.

To do that, you need to deploy Jobs gateway and configure infrastructure target. Remote Pub gateway protects Jobs from unauthorized access.

Requirements¶

Python 3.8+ with pip and venv
Docker v20.10 (or higher) managed by a non-root user
curl

Install Remote Gateway¶

Pick an installation directory:

mkdir -p ~/racetrack && cd ~/racetrack

and run

sh <(curl -fsSL https://raw.githubusercontent.com/TheRacetrack/racetrack/master/utils/standalone-wizard/runner.sh)

Follow the installation steps. Choose remote-docker infrastructure target.

Install plugin¶

On your Racetrack's "Main Hub", install remote Docker plugin. You can do it with:

racetrack plugin install github.com/TheRacetrack/plugin-remote-docker

Next, fill plugin's configuration with the content that has been given to you by installer:

infrastructure_targets:
  remote-docker-daemon:
    remote_gateway_url: 'http://1.2.3.4:7105/pub'
    remote_gateway_token: '5tr0nG_PA55VoRD'

docker:
  docker_registry: 'docker.registry.example.com'
  username: 'DOCKER_USERNAME'
  password: 'READ_WRITE_TOKEN'

After that, you should see a new infrastructure target available in Racetrack.