content: # Copyright 2021 Google LLC
  #
  # Licensed 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
  #
  #     https://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.
  
  FROM ubuntu:focal
  ARG NCPU=4
  
  ## [BEGIN packaging.md]
  
  # Install the minimal development tools, libcurl, OpenSSL and libc-ares:
  
  # ```bash
  ENV DEBIAN_FRONTEND=noninteractive
  RUN apt-get update && \
      apt-get --no-install-recommends install -y apt-transport-https apt-utils \
          automake build-essential cmake ca-certificates curl git \
          gcc g++ libc-ares-dev libc-ares2 libcurl4-openssl-dev \
          libssl-dev m4 make pkg-config tar wget zlib1g-dev
  # ```
  
  # #### Abseil
  
  # We need a recent version of Abseil. Enabling `ABSL_PROPAGATE_CXX_STD` 
  # propagates the version of C++ used to compile Abseil to anything that depends
  # on Abseil.
  
  # ```bash
  WORKDIR /var/tmp/build/abseil-cpp
  RUN curl -fsSL https://github.com/abseil/abseil-cpp/archive/20250127.1.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake \
        -DCMAKE_BUILD_TYPE=Release \
        -DABSL_BUILD_TESTING=OFF \
        -DABSL_PROPAGATE_CXX_STD=ON \
        -DBUILD_SHARED_LIBS=yes \
        -S . -B cmake-out && \
      cmake --build cmake-out -- -j ${NCPU:-4} && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  # #### Protobuf
  
  # We need to install a version of Protobuf that is recent enough to support the
  # Google Cloud Platform proto files:
  
  # ```bash
  WORKDIR /var/tmp/build/protobuf
  RUN curl -fsSL https://github.com/protocolbuffers/protobuf/archive/v29.4.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake \
          -DCMAKE_BUILD_TYPE=Release \
          -DBUILD_SHARED_LIBS=yes \
          -Dprotobuf_BUILD_TESTS=OFF \
          -Dprotobuf_ABSL_PROVIDER=package \
          -S . -B cmake-out && \
      cmake --build cmake-out -- -j ${NCPU:-4} && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  # #### RE2
  
  # The version of RE2 included with this distro hard-codes C++11 in its
  # pkg-config file. You can skip this build and use the system's package if
  # you are not planning to use pkg-config.
  
  # ```bash
  WORKDIR /var/tmp/build/re2
  RUN curl -fsSL https://github.com/google/re2/archive/2025-07-22.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake -DCMAKE_BUILD_TYPE=Release \
          -DBUILD_SHARED_LIBS=ON \
          -DRE2_BUILD_TESTING=OFF \
          -S . -B cmake-out && \
      cmake --build cmake-out -- -j ${NCPU:-4} && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  # #### gRPC
  
  # We also need a version of gRPC that is recent enough to support the Google
  # Cloud Platform proto files. We install it using:
  
  # ```bash
  WORKDIR /var/tmp/build/grpc
  RUN curl -fsSL https://github.com/grpc/grpc/archive/v1.69.0.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake \
          -DCMAKE_BUILD_TYPE=Release \
          -DBUILD_SHARED_LIBS=yes \
          -DgRPC_INSTALL=ON \
          -DgRPC_BUILD_TESTS=OFF \
          -DgRPC_ABSL_PROVIDER=package \
          -DgRPC_CARES_PROVIDER=package \
          -DgRPC_PROTOBUF_PROVIDER=package \
          -DgRPC_RE2_PROVIDER=package \
          -DgRPC_SSL_PROVIDER=package \
          -DgRPC_ZLIB_PROVIDER=package \
          -S . -B cmake-out && \
      cmake --build cmake-out -- -j ${NCPU:-4} && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  # #### crc32c
  
  # The project depends on the Crc32c library, we need to compile this from
  # source:
  
  # ```bash
  WORKDIR /var/tmp/build/crc32c
  RUN curl -fsSL https://github.com/google/crc32c/archive/1.1.2.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake \
          -DCMAKE_BUILD_TYPE=Release \
          -DBUILD_SHARED_LIBS=yes \
          -DCRC32C_BUILD_TESTS=OFF \
          -DCRC32C_BUILD_BENCHMARKS=OFF \
          -DCRC32C_USE_GLOG=OFF \
          -S . -B cmake-out && \
      cmake --build cmake-out -- -j ${NCPU:-4} && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  # #### nlohmann_json library
  
  # The project depends on the nlohmann_json library. We use CMake to
  # install it as this installs the necessary CMake configuration files.
  # Note that this is a header-only library, and often installed manually.
  # This leaves your environment without support for CMake pkg-config.
  
  # ```bash
  WORKDIR /var/tmp/build/json
  RUN curl -fsSL https://github.com/nlohmann/json/archive/v3.11.3.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake \
        -DCMAKE_BUILD_TYPE=Release \
        -DBUILD_SHARED_LIBS=yes \
        -DBUILD_TESTING=OFF \
        -DJSON_BuildTests=OFF \
        -S . -B cmake-out && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  # #### opentelemetry-cpp
  
  # The project has an **optional** dependency on the OpenTelemetry library.
  # We recommend installing this library because:
  # - the dependency will become required in the google-cloud-cpp v3.x series.
  # - it is needed to produce distributed traces of the library.
  
  # ```bash
  WORKDIR /var/tmp/build/opentelemetry-cpp
  RUN curl -fsSL https://github.com/open-telemetry/opentelemetry-cpp/archive/v1.20.0.tar.gz | \
      tar -xzf - --strip-components=1 && \
      cmake \
          -DCMAKE_BUILD_TYPE=Release \
          -DBUILD_SHARED_LIBS=yes \
          -DWITH_EXAMPLES=OFF \
          -DWITH_STL=CXX14 \
          -DWITH_ABSEIL=ON \
          -DBUILD_TESTING=OFF \
          -DOPENTELEMETRY_INSTALL=ON \
          -DOPENTELEMETRY_ABI_VERSION_NO=2 \
          -S . -B cmake-out && \
      cmake --build cmake-out --target install -- -j ${NCPU:-4} && \
      ldconfig
  # ```
  
  ## [DONE packaging.md]
  
  WORKDIR /var/tmp/sccache
  RUN curl -fsSL https://github.com/mozilla/sccache/releases/download/v0.10.0/sccache-v0.10.0-x86_64-unknown-linux-musl.tar.gz | \
      tar -zxf - --strip-components=1 && \
      mkdir -p /usr/local/bin && \
      mv sccache /usr/local/bin/sccache && \
      chmod +x /usr/local/bin/sccache
  
  # Update the ld.conf cache in case any libraries were installed in /usr/local/lib*
  RUN ldconfig /usr/local/lib*
  