Add C++ profile to Docker Compose and Updatecli

Fixes #376

Add a new profile in the Docker Compose file for building C++ source code with Jenkins.

* **Docker Compose Files:**
  * Add a `cpp` profile in `docker-compose.yaml` and `build-docker-compose.yaml`.
  * Include necessary service definitions, dependencies, healthcheck, and volume configurations.
* **Dockerfile:**
  * Create `dockerfiles/cpp/Dockerfile` with necessary C++ build tools including `build-essential`, `cmake`, `gcc`, `g++`, `clang`, `make`, `libstdc++-dev`, and `pkg-config`.
  * Set environment variables and ensure ownership of the Jenkins agent home directory.
* **Updatecli Manifest:**
  * Add `updatecli/updatecli.d/cpp.yaml` for managing the C++ Dockerfile.
  * Ensure the manifest includes the necessary dependencies for the C++ build environment.
* **GitHub Actions:**
  * Modify `.github/workflows/github-docker-registry-push.yml` to add a new job for building and pushing the C++ Docker image to ghcr.

---

For more details, open the [Copilot Workspace session](https://copilot-workspace.githubnext.com/gounthar/quickstart-tutorials/issues/376?shareId=XXXX-XXXX-XXXX-XXXX).

Author: gounthar

.github/workflows/github-docker-registry-push.yml

@@ -204,3 +204,13 @@ jobs:
           platforms: linux/amd64, linux/arm64
           push: true
           tags: ghcr.io/${{ env.REPO_NAME }}/jenkinsci-tutorials:golang_${{ env.BRANCH }}
+
+      - name: Build and push the jenkins agent for cpp tutorial
+        # This step builds and pushes the Jenkins agent for the C++ tutorial
+        if: contains(env.files, 'dockerfiles/cpp/Dockerfile')
+        uses: docker/build-push-action@v6
+        with:
+          context: ./dockerfiles/cpp
+          platforms: linux/amd64, linux/aarch64
+          push: true
+          tags: ghcr.io/${{ env.REPO_NAME }}/jenkinsci-tutorials:cpp_agent_${{ env.BRANCH }}

build-docker-compose.yaml

@@ -205,6 +205,23 @@ services:
       retries: 5
     volumes:
       - agent-ssh-dir:/home/jenkins/.ssh:ro # Mounts the agent-ssh-dir volume to the /home/jenkins/.ssh path inside the container as read-only
+  cpp:
+    build: dockerfiles/cpp/.
+    container_name: desktop-jenkins_agent-1-cpp
+    profiles:
+      - cpp
+    depends_on:
+      sidekick_service:
+        condition: service_completed_successfully
+      jenkins_controller:
+        condition: service_started
+    healthcheck:
+      test: ["CMD-SHELL", "[ -f /home/jenkins/.ssh/authorized_keys ] || exit 1"]
+      interval: 5s
+      timeout: 10s
+      retries: 5
+    volumes:
+      - agent-ssh-dir:/home/jenkins/.ssh:ro
 volumes:
   jenkins_home: null
   agent-ssh-dir:

docker-compose.yaml

@@ -281,6 +281,23 @@ services:
       retries: 5
     volumes:
       - agent-ssh-dir:/home/jenkins/.ssh:ro # Mounts the agent-ssh-dir volume to the /home/jenkins/.ssh path inside the container as read-only
+  cpp:
+    image: ${IMAGE_PREFIX}/${GHCR_USERNAME}/quickstart-tutorials/jenkinsci-tutorials:cpp_agent_${BRANCH_SUFFIX}
+    container_name: desktop-jenkins_agent-1-cpp
+    profiles:
+      - cpp
+    depends_on:
+      sidekick_service:
+        condition: service_completed_successfully
+      jenkins_controller:
+        condition: service_started
+    healthcheck:
+      test: ["CMD-SHELL", "[ -f /home/jenkins/.ssh/authorized_keys ] || exit 1"]
+      interval: 5s
+      timeout: 10s
+      retries: 5
+    volumes:
+      - agent-ssh-dir:/home/jenkins/.ssh:ro
 volumes:
   jenkins_home: null
   empty_jenkins_home: null

dockerfiles/cpp/Dockerfile

@@ -0,0 +1,19 @@
+FROM jenkins/ssh-agent:6.9.0
+
+# Install necessary C++ build tools
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    cmake \
+    gcc \
+    g++ \
+    clang \
+    make \
+    libstdc++-dev \
+    pkg-config \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set environment variables
+ENV PATH="/usr/local/bin:$PATH"
+
+# Ensure the ownership of the Jenkins agent home directory is set to the Jenkins user
+RUN chown -R jenkins:jenkins "${JENKINS_AGENT_HOME}"

updatecli/updatecli.d/cpp.yaml

@@ -0,0 +1,42 @@
+name: "deps: update C++ build environment"
+
+scms:
+  default:
+    kind: github
+    spec:
+      user: "{{ .github.user }}"
+      email: "{{ .github.email }}"
+      owner: "{{ .github.owner }}"
+      repository: "{{ .github.repository }}"
+      token: "{{ requiredEnv .github.token }}"
+      username: "{{ .github.username }}"
+      branch: "{{ .github.branch }}"
+
+sources:
+  cpp:
+    name: Get latest C++ build environment dependencies
+    kind: shell
+    spec:
+      command: echo "build-essential cmake gcc g++ clang make libstdc++-dev pkg-config"
+
+targets:
+  cpp:
+    name: 'deps(dockerfile): update C++ build environment dependencies'
+    scmid: default
+    kind: dockerfile
+    spec:
+      file: dockerfiles/cpp/Dockerfile
+      instruction:
+        keyword: RUN
+        matcher: apt-get install -y --no-install-recommends
+    sourceid: cpp
+
+actions:
+  default:
+    kind: github/pullrequest
+    scmid: default
+    title: Update C++ build environment dependencies to {{ source "cpp" }}
+    spec:
+      labels:
+        - dependencies
+        - cpp