[ci] add RayImage model and image type config (build_image.py)

[andrew-anyscale]

Add core data model for local Docker image building: RayImage dataclass, IMAGE_TYPE_CONFIG loaded from ray-images.yaml, wanda spec path mapping, and validation logic.

Topic: build-image-model
Relative: ray-images-use
Signed-off-by: andrew andrew@anyscale.com

[andrew-anyscale]

Reviews in this chain:
└#61285 [ci] Add ray-images.yaml schema and validation test
　└#61286 [ci] Use ray-images.yaml for Docker image constants
　　└#61336 [ci] add RayImage model and image type config (build_image.py)
　　　└#61337 [ci] add ImageBuildConfig and ImageBuilder for local Docker builds
　　　　└#61338 [ci] add CLI for local Docker image builder (build_image.py)
　　　　　└#61042 [build] feat: add top-level build-image.sh

[andrew-anyscale]

#	head	base	diff	date	summary
0	d4af784e	4cdd0e0c	diff	Feb 25 17:43 PM	3 files changed, 242 insertions(+)
1	bdf50095	242338e8	diff	Feb 25 17:45 PM	0 files changed
2	19bae4fa	242338e8	diff	Feb 25 18:40 PM	2 files changed, 71 insertions(+), 14 deletions(-)
3	868d99de	8023fc7b	rebase	Feb 25 18:57 PM	0 files changed
4	e0dc1b6d	392777e4	rebase	Feb 25 20:36 PM	0 files changed
5	b014c7e7	688d850d	rebase	Feb 25 20:38 PM	0 files changed
6	d11c348f	fd1bdfb0	rebase	Feb 25 20:42 PM	0 files changed
7	ef50e0f0	92554d19	diff	Feb 25 20:53 PM	2 files changed, 13 insertions(+), 2 deletions(-)
8	dc1385e3	92554d19	diff	Feb 26 6:40 AM	1 file changed, 1 insertion(+), 3 deletions(-)

[gemini-code-assist]

Code Review

This pull request introduces a core data model for local Docker image building, including the RayImage dataclass and configuration loading from ray-images.yaml. The changes are well-structured and include corresponding tests.

My review includes two main suggestions for ci/build/build_image.py:

1. Improve the robustness of file path resolution by using the existing find_ray_root() utility.
2. Enhance the design by encapsulating the logic for mapping an image platform to a Wanda spec file, which will make the module more self-contained and easier to use.

Overall, this is a good addition that sets a solid foundation for image building logic.

[gemini-code-assist]

Instead of hardcoding the relative path to the repository root (../../..), please use the find_ray_root() function from build_common. This makes path resolution more robust against file moves.

You'll also need to update the import on line 16 to include find_ray_root:
from ci.build.build_common import BuildError, find_ray_root

Suggested change

	path = Path(__file__).resolve().parent.parent.parent / "ray-images.yaml"
	path = find_ray_root() / "ray-images.yaml"

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.