testcontainers / testcontainers/testcontainers-python
New Container: Spark Connect
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 2.3k
- Forks
- 386
- Avg merge
- 4h 40m
- Merged PRs (30d)
- 1
Description
What is the new container you'd like to have?
Spark connect introduces a decoupled client-server architecture to allow remote connectivity to spark server, official documentation is here.
It's used by data engineers to distribute data transformation jobs into multiple clusters. Spark connect is an addition to spark with leverages the jvm.
Benefits of having this in container would enable data engineers:
- to be able to tests their workflows without having to go through a cloud provider like Databricks
- prevent the manual setup of jvm which can be quite cumbersome
The most commonly used docker image is apache/spark.
Why not just use a generic container for this?
The implementation of the spark connect server with DockerContainer would expose extra configurations. On corporate projects, the following implementation is required
kwargs = {
"entrypoint": "/opt/spark/sbin/start-connect-server.sh org.apache.spark.deploy.master.Master --packages org.apache.spark:spark-connect_2.12:3.5.2,io.delta:delta-core_2.12:2.3.0 --conf spark.driver.extraJavaOptions='-Divy.cache.dir=/tmp -Divy.home=/tmp' --conf spark.connect.grpc.binding.port=8081",
}
with (
DockerContainer(
"apache/spark",
)
.with_bind_ports(8081, 8081)
.with_env("SPARK_NO_DAEMONIZE", "True")
.with_volume_mapping(pytest_tmp_dir, pytest_tmp_dir, "rw")
.with_kwargs(**kwargs) as container
):
_ = wait_for_logs(container, "SparkConnectServer: Spark Connect server started at")
yield container
The added complexity is due to configuration of the entrypoint, one would need to have expertise in spark connect to launch the server and ensure the proper port exports. There is a compatibility versions to guarantee between spark and the delta-core jar package.
Other references:
Some resources here
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the existing container integrations and the DockerContainer API used in the example. Review the apache/spark image, the Spark Connect entrypoint, port 8081, and wait_for_logs usage. Done means a Spark Connect container can be started with the required configuration and its startup can be detected reliably.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, python, spark
- Domain
- data-engineering, devops
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100