-
Notifications
You must be signed in to change notification settings - Fork 28.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[SPARK-50011][INFRA] Add a separate docker file for doc build
### What changes were proposed in this pull request? Add a separate docker file for doc build ### Why are the changes needed? currently we only have single test image, for `pyspark`, `sparkr`, `lint` and `docs`, it has two major issues: 1, disk space limitation: we are adding more and more packages in it, the disk space left for testing is very limited, and cause `No space left on device` from time to time; 2, environment conflicts: for example, even though we already install some packages for `docs` in the docker file, we still need to install some additional python packages in `build_and_test`, due to the conflicts between `docs` and `pyspark`. It is hard to maintain because the related packages are installed in two different places. so I am thinking of spinning off some installations (e.g. `docs`) from the base image, so that: 1, we can completely cache all the dependencies for `docs`; 2, the related installations are centralized; 3, we can free up disk space on the base image (after we spin off other dependency, we can remove unneeded packages from it); Furthermore, if we want to apply multiple images, we can easily support different environments, e.g. adding a separate image for old versions of `pandas/pyarrow/etc`. ### Does this PR introduce _any_ user-facing change? no, infra-only ### How was this patch tested? ci ### Was this patch authored or co-authored using generative AI tooling? no Closes #48690 from zhengruifeng/infra_separate_doc. Authored-by: Ruifeng Zheng <[email protected]> Signed-off-by: Ruifeng Zheng <[email protected]>
- Loading branch information
1 parent
36410f0
commit 0ee2659
Showing
3 changed files
with
140 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,91 @@ | ||
| # | ||
| # Licensed to the Apache Software Foundation (ASF) under one or more | ||
| # contributor license agreements. See the NOTICE file distributed with | ||
| # this work for additional information regarding copyright ownership. | ||
| # The ASF licenses this file to You under the Apache License, Version 2.0 | ||
| # (the "License"); you may not use this file except in compliance with | ||
| # the License. You may obtain a copy of the License at | ||
| # | ||
| # http://www.apache.org/licenses/LICENSE-2.0 | ||
| # | ||
| # Unless required by applicable law or agreed to in writing, software | ||
| # distributed under the License is distributed on an "AS IS" BASIS, | ||
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
| # See the License for the specific language governing permissions and | ||
| # limitations under the License. | ||
| # | ||
|
|
||
| # Image for building and testing Spark branches. Based on Ubuntu 22.04. | ||
| # See also in https://hub.docker.com/_/ubuntu | ||
| FROM ubuntu:jammy-20240911.1 | ||
| LABEL org.opencontainers.image.authors="Apache Spark project <[email protected]>" | ||
| LABEL org.opencontainers.image.licenses="Apache-2.0" | ||
| LABEL org.opencontainers.image.ref.name="Apache Spark Infra Image for Documentation" | ||
| # Overwrite this label to avoid exposing the underlying Ubuntu OS version label | ||
| LABEL org.opencontainers.image.version="" | ||
|
|
||
| ENV FULL_REFRESH_DATE 20241029 | ||
|
|
||
| ENV DEBIAN_FRONTEND noninteractive | ||
| ENV DEBCONF_NONINTERACTIVE_SEEN true | ||
|
|
||
| RUN apt-get update && apt-get install -y \ | ||
| build-essential \ | ||
| ca-certificates \ | ||
| curl \ | ||
| gfortran \ | ||
| git \ | ||
| gnupg \ | ||
| libcurl4-openssl-dev \ | ||
| libfontconfig1-dev \ | ||
| libfreetype6-dev \ | ||
| libfribidi-dev \ | ||
| libgit2-dev \ | ||
| libharfbuzz-dev \ | ||
| libjpeg-dev \ | ||
| liblapack-dev \ | ||
| libopenblas-dev \ | ||
| libpng-dev \ | ||
| libpython3-dev \ | ||
| libssl-dev \ | ||
| libtiff5-dev \ | ||
| libxml2-dev \ | ||
| nodejs \ | ||
| npm \ | ||
| openjdk-17-jdk-headless \ | ||
| pandoc \ | ||
| pkg-config \ | ||
| qpdf \ | ||
| r-base \ | ||
| ruby \ | ||
| ruby-dev \ | ||
| software-properties-common \ | ||
| wget \ | ||
| zlib1g-dev \ | ||
| && rm -rf /var/lib/apt/lists/* | ||
|
|
||
|
|
||
| # See more in SPARK-39959, roxygen2 < 7.2.1 | ||
| RUN Rscript -e "install.packages(c('devtools', 'knitr', 'markdown', 'rmarkdown', 'testthat'), repos='https://cloud.r-project.org/')" && \ | ||
| Rscript -e "devtools::install_version('roxygen2', version='7.2.0', repos='https://cloud.r-project.org')" && \ | ||
| Rscript -e "devtools::install_version('pkgdown', version='2.0.1', repos='https://cloud.r-project.org')" && \ | ||
| Rscript -e "devtools::install_version('preferably', version='0.4', repos='https://cloud.r-project.org')" | ||
|
|
||
| # See more in SPARK-39735 | ||
| ENV R_LIBS_SITE "/usr/local/lib/R/site-library:${R_LIBS_SITE}:/usr/lib/R/library" | ||
|
|
||
| # Install Python 3.9 | ||
| RUN add-apt-repository ppa:deadsnakes/ppa | ||
| RUN apt-get update && apt-get install -y python3.9 python3.9-distutils \ | ||
| && rm -rf /var/lib/apt/lists/* | ||
| RUN curl -sS https://bootstrap.pypa.io/get-pip.py | python3.9 | ||
|
|
||
| # Should unpin 'sphinxcontrib-*' after upgrading sphinx>5 | ||
| # See 'ipython_genutils' in SPARK-38517 | ||
| # See 'docutils<0.18.0' in SPARK-39421 | ||
| RUN python3.9 -m pip install 'sphinx==4.5.0' mkdocs 'pydata_sphinx_theme>=0.13' sphinx-copybutton nbsphinx numpydoc jinja2 markupsafe 'pyzmq<24.0.0' \ | ||
| ipython ipython_genutils sphinx_plotly_directive 'numpy>=1.20.0' pyarrow pandas 'plotly>=4.8' 'docutils<0.18.0' \ | ||
| 'flake8==3.9.0' 'mypy==1.8.0' 'pytest==7.1.3' 'pytest-mypy-plugins==1.9.3' 'black==23.9.1' \ | ||
| 'pandas-stubs==1.2.0.53' 'grpcio==1.62.0' 'grpcio-status==1.62.0' 'grpc-stubs==1.24.11' 'googleapis-common-protos-stubs==2.2.0' \ | ||
| 'sphinxcontrib-applehelp==1.0.4' 'sphinxcontrib-devhelp==1.0.2' 'sphinxcontrib-htmlhelp==2.0.1' 'sphinxcontrib-qthelp==1.0.3' 'sphinxcontrib-serializinghtml==1.1.5' \ | ||
| && python3.9 -m pip cache purge |