Implementation:Ray project Ray Build Docker Script

Knowledge Sources	Ray
Domains	Build_Systems, Containerization
Last Updated	2026-02-13 17:00 GMT

Overview

External tool documentation for the build-docker.sh script that builds Ray Docker images.

Description

build-docker.sh (L1-116) uses Docker BuildKit to build two images: rayproject/base-deps:dev (OS + Python deps) and rayproject/ray:dev (full Ray). Supports --gpu flag for CUDA-enabled images, --python-version, --base-image override, and --no-cache-build. Downloads pre-built wheels from S3.

Usage

Run with appropriate flags for CPU or GPU image builds.

Code Reference

Source Location

• Repository: ray-project/ray
• File: build-docker.sh (L1-116)

Signature

./build-docker.sh [--gpu] [--base-image IMAGE] [--python-version VER] [--no-cache-build] [--shas-only]

I/O Contract

Inputs

Name	Type	Required	Description
--gpu	Flag	No	Build CUDA-enabled GPU image
--python-version	String	No	Python version (default: 3.10)
--base-image	String	No	Override base Docker image

Outputs

Name	Type	Description
Docker images	Images	rayproject/base-deps:dev and rayproject/ray:dev (plus -gpu variants)

Usage Examples

Build CPU Image

./build-docker.sh

Build GPU Image

./build-docker.sh --gpu

Related Pages

Implements Principle

• Principle:Ray_project_Ray_Docker_Image_Building

Requires Environment

• Environment:Ray_project_Ray_CI_Build_Matrix_Environment