Add devcontainer workflow for local builds and integration tests

[pawelchcki]

Adds a .devcontainer/ image definition and a thin Makefile + runner script so developers can reproduce the GitLab build + integration-test pipeline locally. The image bakes in the LLVM+musl sysroot, Rust+cbindgen for RUM, uv, and a prebuilt httpd.

Two non-obvious bits in the runner script:

• UV_PROJECT_ENVIRONMENT points outside the bind-mounted repo, so a host-side uv sync on darwin can't leave mac wheels in .venv/ that the container's Linux Python then tries to import.
• Pytest options use --flag=VALUE — the space-separated form is captured by pytest's early arg parser as a positional test path before conftest registers the custom option, which silently skips conftest.

The GitLab build-ci-image job's hash input and Dockerfile path are retargeted to the new .devcontainer/ location.

[pawelchcki]

• Rewrite readiness-probe comment to be bug-agnostic #64
• Fix integration-test hang and stale proxy.conf directive #63
• Add devcontainer workflow for local builds and integration tests #60 👈 (View in Graphite)
• Respect child-scope override for tracing directives #62
• Switch inject-browser-sdk to submodule; consolidate deps #61
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[datadog-official]

🎯 Code Coverage (details)
• Patch Coverage: 100.00%
• Overall Coverage: 50.93% (+0.00%)

_{This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 1b72823 | Docs | Datadog PR Page | Give us feedback!}

[Copilot]

Pull request overview

Adds a reproducible devcontainer-based environment and local runner to mirror the GitLab build + integration-test pipeline, while retargeting GitLab CI’s image build inputs from .gitlab/ to .devcontainer/.

Changes:

• Introduces a .devcontainer/ Dockerfile + devcontainer configuration for local builds/tests.
• Adds a Makefile include + helper devcontainer.mk targets to build/pull the image, open a shell, and run integration tests.
• Updates .gitlab-ci.yml to build/tag the devcontainer image from .devcontainer/ inputs and use it for build/test jobs.

Reviewed changes

Copilot reviewed 6 out of 8 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
Makefile	Switches to including .devcontainer/devcontainer.mk as the primary entrypoint for dev workflows.
.gitlab-ci.yml	Retargets CI image build inputs to .devcontainer/, adds nydus conversion in the per-arch build job, and updates downstream jobs to use the devcontainer image.
.gitignore	Ignores container-specific build/dist outputs and logs generated by the new runner.
.devcontainer/run-integration-tests.sh	New script to build (optionally) and run integration tests inside the devcontainer image, with uv/pytest configuration.
.devcontainer/devcontainer.mk	New Make targets for pulling/building the devcontainer image, launching shells, and running tests.
.devcontainer/devcontainer.json	Devcontainer definition for VS Code / devcontainer tooling.
.devcontainer/Dockerfile	New image definition baking in LLVM+musl sysroot, Rust+cbindgen, uv, and a built httpd tree.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[xlamorlette-datadog]

nit: simplification:

ifneq ($(filter $(DEV_CONTAINER_HOST_ARCH),arm64 aarch64),)
DEV_CONTAINER_ARCH := aarch64
DEV_CONTAINER_PLATFORM := linux/arm64

[xlamorlette-datadog]

nit, opt: indent (with spaces, not tabs) for improved readability:

ifneq ($(filter $(DEV_CONTAINER_HOST_ARCH),arm64 aarch64),)
  DEV_CONTAINER_ARCH := aarch64
  DEV_CONTAINER_PLATFORM := linux/arm64
else
  DEV_CONTAINER_ARCH := x86_64
  DEV_CONTAINER_PLATFORM := linux/amd64
endif

Some in other small conditionals, lines 22, 56-58.

[xlamorlette-datadog]

nit, opt: This is a big conditional. I think it's worth adding a comment in the else line 14, and in the endif line 111.

[xlamorlette-datadog]

I think we can replace lines 73-77 to a call to dev-image-clean:

		$(MAKE) --no-print-directory dev-image-clean; \

[xlamorlette-datadog]

Lines 62-65 are the same than lines 95-98. This could be factorized in a variable such as DEV_CONTAINER_MOUNTS.

[xlamorlette-datadog]

This could be simplified as:

ifeq ($(wildcard $(DEV_CONTAINER_REPO_ROOT)/deps/nginx-datadog/build_env),)

[xlamorlette-datadog]

Maybe add a clean DIST_DIR before this to be more deterministic:

rm -rf "$DIST_DIR"

[xlamorlette-datadog]

This comment is repeated in 4 locations (also in .github/workflows/release.yml and .github/workflows/system-tests.yml). Please try to find a common place to avoid duplication.
Also:

• Could these commands be put in make target (as before) or in a shell script?
• Could you please update the related internal documentation page (but maybe this is not the most adequate place for such documentation)?

[xlamorlette-datadog]

To avoid duplication (and so possible divergence), the hash computing could be factorized in a dedicated script:

.devcontainer/compute-image-hash.sh:

#!/bin/sh
set -eu

REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
cd "$REPO_ROOT"

find .devcontainer/Dockerfile \
     .devcontainer/compute-image-hash.sh \
     deps/nginx-datadog/build_env/ \
     scripts/setup-httpd.py \
     -type f | sort | \
while IFS= read -r f; do
  printf -- '--- %s ---\n' "$f"
  cat "$f"
done | \
  (command -v sha256sum >/dev/null 2>&1 && sha256sum || shasum -a 256) | \
  cut -d' ' -f1

Then, in devcontainer/devcontainer.mk (line 28):

DEV_CONTAINER_HASH := $(shell $(DEV_CONTAINER_REPO_ROOT)/.devcontainer/compute-image-hash.sh)

In .gitlab/devcontainer.yml (line 29):

HASH=$(.devcontainer/compute-image-hash.sh)

[xlamorlette-datadog]

This duplicated block can be factorized in:

.needs-devcontainer-amd64: &needs-devcontainer-amd64
  job: devcontainer-image
  parallel:
    matrix:
      - ARCH: amd64
        TOOLCHAIN_ARCH: x86_64
  artifacts: true