celeborn/cpp/README.md
HolyLow 71bd45577a [CELEBORN-1724][CIP-14] Add environment setup tools for CppClient development
### What changes were proposed in this pull request?
This PR adds environment setup tools, docker image & container especially, for CppClient development.

### Why are the changes needed?
To develop CppClient functionality and solve library dependencies.

### Does this PR introduce _any_ user-facing change?
No.

### How was this patch tested?
E2E.

Closes #2927 from HolyLow/issue/celeborn-1724-add-cppClient-devTools.

Authored-by: HolyLow <jiaming.xie7@gmail.com>
Signed-off-by: mingji <fengmingxiao.fmx@alibaba-inc.com>
2024-11-22 19:58:45 +08:00

1.1 KiB

[WIP] Celeborn Cpp Support

Environment Setup

We provide several methods to setup dev environment for CelebornCpp. Note that currently the scripts only take care of the cpp-related dependencies, and java dependencies are not included.

Use container with prebuilt image

We provide a pre-built image ready to be pulled and used so you could launch a container directly:

export PROJECT_DIR=/your/path/to/celeborn/dir
docker run \
    -v ${PROJECT_DIR}:/celeborn \
    -w /celeborn \
    -it --rm \
    --name celeborn-cpp-dev-container \
    holylow/celeborn-cpp-dev:0.1 \
    /bin/bash

Build image and use container

We provide the dev image building scripts so you could build the image and launch a container as follows:

cd scripts

# build image
bash ./build-docker-image.sh

# launch container with image above
bash ./launch-docker-container.sh

Build on local machine (Ubuntu-Only)

Currently, we only provide the dev-environment setup script for Ubuntu:

cd scripts
bash setup-ubuntu.sh

Other platforms are not supported yet, and you could use the container above as your dev environment.