opentelemetry-cpp/.devcontainer
Doug Barker 1ede230d0f
[CI] build iwyu (#3459)
2025-06-04 09:31:25 +02:00
..
Dockerfile.conan Harden Github actions - pinned-dependencies (part -1) (#3380) 2025-04-25 05:15:53 +00:00
Dockerfile.dev [CI] build iwyu (#3459) 2025-06-04 09:31:25 +02:00
README.md [DEVCONTAINER] expose cmake version setting as docker arg and environment variable (#3347) 2025-04-06 18:08:41 +02:00
customize_container.sh [DEVCONTAINER] support customization and run as non-root user (#3270) 2025-02-21 13:47:20 +01:00
devcontainer.json [DEVCONTAINER] expose cmake version setting as docker arg and environment variable (#3347) 2025-04-06 18:08:41 +02:00

README.md

Customizing Your Dev Container

Customize your dev container using build arguments (for direct Docker builds) or environment variables (for evaluation in devcontainer.json).

  • CMake version: The version of cmake to install. (Default: 3.31.6)

    • Docker ARG: CMAKE_VERSION
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_CMAKE_VERSION
  • CXX standard: This is the C++ standard to build from (eg: 17, 20, ...). (Default: 17)

    • Docker ARG: CXX_STANDARD
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_CXX_STANDARD
  • abseil-cpp version: This is the version of abseil-cpp that will be used to build protobuf, gRPC, and opentelemetry-cpp.

    • Docker ARG: ABSEIL_CPP_VERSION
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_ABSEIL_CPP_VERSION
  • Protobuf version:

    • Docker ARG: PROTOBUF_VERSION
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_PROTOBUF_VERSION
  • gRPC version:

    • Docker ARG: GRPC_VERSION
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_GRPC_VERSION
  • User ID (UID): User ID (Default: 1000)

    • Docker ARG: USER_UID
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_USER_UID
  • Group ID (GID): User group ID (Default: 1000)

    • Docker ARG: USER_GID
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_USER_GID
  • Install Packages: These are the additional packages that will be installed via apt install in the devcontainer. This is a space separated list.

    • Docker ARG: INSTALL_PACKAGES (Default: ``)
    • Host Environment Variable: OTEL_CPP_DEVCONTAINER_INSTALL_PACKAGES (Default: ``)

Examples

  • docker build --build-arg CXX_STANDARD="20" --build-arg INSTALL_PACKAGES="nano gitk"...
  • export OTEL_CPP_DEVCONTAINER_CXX_STANDARD=20
  • export OTEL_CPP_DEVCONTAINER_INSTALL_PACKAGES="nano gitk"