Merge pull request #379 from aminya/alpine

feat: support Alpine + add setup-alpine package + detect externally managed python

Author: aminya

.github/workflows/CI.yml

@@ -244,6 +244,7 @@ jobs:
           - { distro: "ubuntu", image: "setup-cpp-ubuntu", BASE_VERSION: "20.04", tag: "20.04-1.3.0" }
           - { distro: "fedora", image: "setup-cpp-fedora", tag: "40-1.3.0" }
           - { distro: "arch", image: "setup-cpp-arch", tag: "base-1.3.0" }
+          - { distro: "alpine", image: "setup-cpp-alpine", BASE_VERSION: "22-alpine3.21", tag: "3.21-1.3.0" }
         include:
           - os: ubuntu-24.04-arm
             platform: linux/arm64
@@ -254,6 +255,9 @@ jobs:
           - os: ubuntu-24.04-arm
             platform: linux/arm64
             container: { distro: "ubuntu", image: "setup-cpp-ubuntu", BASE_VERSION: "20.04", tag: "20.04-1.3.0" }
+          - os: ubuntu-24.04-arm
+            platform: linux/arm64
+            container: { distro: "alpine", image: "setup-cpp-alpine", BASE_VERSION: "22-alpine3.21", tag: "3.21-1.3.0" }
     steps:
       - uses: actions/checkout@v4
         with:
@@ -300,7 +304,7 @@ jobs:
           docker tag aminya/${{ matrix.container.image }}:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}:latest
 
       - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'alpine' }}
         run: docker push aminya/${{ matrix.container.image }}:latest
 
       - name: Docker Readme for setup-cpp-${{matrix.container.distro }}
@@ -331,7 +335,7 @@ jobs:
           docker tag aminya/${{ matrix.container.image }}-llvm:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}-llvm:latest
 
       - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'alpine' }}
         run: docker push aminya/${{ matrix.container.image }}-llvm:latest
 
       - name: Docker Readme for setup-cpp-${{matrix.container.distro }}-llvm
@@ -372,7 +376,7 @@ jobs:
           docker tag aminya/${{ matrix.container.image }}-gcc:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}-gcc:latest
 
       - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'alpine' }}
         run: docker push aminya/${{ matrix.container.image }}-gcc:latest
 
       - name: Docker Readme for setup-cpp-${{matrix.container.distro }}-gcc
@@ -396,7 +400,7 @@ jobs:
 
       - name: Build setup-cpp-${{matrix.container.distro }}-mingw
         id: build_mingw
-        if: ${{ matrix.container.distro != 'fedora' }}
+        if: ${{ matrix.container.distro != 'fedora' && !(matrix.container.distro == 'alpine' && matrix.platform == 'linux/arm64') }}
         uses: docker/build-push-action@v6
         with:
           context: .
@@ -410,16 +414,16 @@ jobs:
           cache-to: type=inline
 
       - name: Tag latest locally
-        if: ${{ matrix.container.distro != 'fedora' }}
+        if: ${{ matrix.container.distro != 'fedora' && !(matrix.container.distro == 'alpine' && matrix.platform == 'linux/arm64') }}
         run: |
           docker tag aminya/${{ matrix.container.image }}-mingw:${{ matrix.container.tag }}-${{ steps.platform.outputs.suffix }} aminya/${{ matrix.container.image }}-mingw:latest
 
       - name: Push latest to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'fedora' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'ubuntu' && matrix.container.distro != 'fedora' && matrix.container.distro != 'alpine' }}
         run: docker push aminya/${{ matrix.container.image }}-mingw:latest
 
       - name: Docker Readme for setup-cpp-${{matrix.container.distro }}-mingw
-        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'fedora' }}
+        if: ${{ github.event_name != 'pull_request' && matrix.container.distro != 'fedora' && !(matrix.container.distro == 'alpine' && matrix.platform == 'linux/arm64') }}
         uses: peter-evans/dockerhub-description@v4
         with:
           username: aminya
@@ -428,7 +432,7 @@ jobs:
           readme-filepath: ./README_DOCKER.md
 
       - name: Test Mingw
-        if: ${{ !contains(github.event.head_commit.message, '[skip test]') && matrix.container.distro != 'fedora' }}
+        if: ${{ !contains(github.event.head_commit.message, '[skip test]') && matrix.container.distro != 'fedora' && matrix.container.distro != 'alpine' }}
         uses: docker/build-push-action@v6
         with:
           context: .
@@ -459,6 +463,11 @@ jobs:
           - { distro: "ubuntu", image: "setup-cpp-ubuntu", tag: "24.04-1.3.0", suffix: "-llvm", latest: true }
           - { distro: "ubuntu", image: "setup-cpp-ubuntu", tag: "24.04-1.3.0", suffix: "-gcc", latest: true }
           - { distro: "ubuntu", image: "setup-cpp-ubuntu", tag: "24.04-1.3.0", suffix: "-mingw", latest: true }
+
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "", latest: true }
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "-llvm", latest: true }
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "-gcc", latest: true }
+          - { distro: "alpine", image: "setup-cpp-alpine", tag: "3.21-1.3.0", suffix: "-mingw", latest: true }
     steps:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3

dev/docker/ci/alpine-gcc.dockerfile

@@ -0,0 +1,10 @@
+FROM aminya/setup-cpp-alpine:latest AS setup-cpp-alpine-gcc
+
+# install gcc
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+    --compiler gcc && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]

dev/docker/ci/alpine-llvm.dockerfile

@@ -0,0 +1,10 @@
+FROM aminya/setup-cpp-alpine:latest AS setup-cpp-alpine-llvm
+
+# install llvm
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+    --compiler llvm && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]

dev/docker/ci/alpine-mingw.dockerfile

@@ -0,0 +1,11 @@
+FROM aminya/setup-cpp-alpine:latest AS setup-cpp-alpine-mingw
+
+# install mingw/powershell
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+    --compiler mingw \
+    --powershell true && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]

dev/docker/ci/alpine.dockerfile

@@ -0,0 +1,34 @@
+ARG BASE_VERSION=22-alpine3.21
+
+#### Base Image with Node.js
+FROM --platform=$BUILDPLATFORM node:${BASE_VERSION} AS alpine-nodejs
+
+#### Base Image with Tools
+FROM alpine-nodejs AS setup-cpp-alpine
+
+COPY "./dist/modern" "/usr/lib/setup-cpp/"
+
+# install the cpp tools
+RUN node --enable-source-maps /usr/lib/setup-cpp/setup-cpp.mjs \
+        --cmake true \
+        --ninja true \
+        --task true \
+        --python true \
+        --make true \
+        --cppcheck true \
+        --gcovr true \
+        --doxygen true \
+        --vcpkg true \
+        --ccache true \
+        --conan true \
+        --cmakelang true \
+        --meson true && \
+# cleanup
+    rm -rf /var/cache/apk/*
+
+# Custom entrypoint due to bash -l limitations on Alpine
+RUN printf '#!/bin/bash\nsource $HOME/.cpprc\nexec "$@"\n' > /entrypoint.sh && \
+    chmod +x /entrypoint.sh
+
+SHELL ["/entrypoint.sh", "/bin/sh", "-c"]
+ENTRYPOINT ["/entrypoint.sh", "/bin/sh"]

dev/docker/examples/alpine-gcc.dockerfile

@@ -0,0 +1,15 @@
+#### Building (example)
+FROM aminya/setup-cpp-alpine-gcc AS builder
+
+COPY ./dev/cpp_vcpkg_project /home/app
+WORKDIR /home/app
+RUN task build
+
+#### Running environment
+# use a fresh image as the runner
+FROM alpine:3.21 AS runner
+
+# copy the built binaries and their runtime dependencies
+COPY --from=builder /home/app/build/my_exe/Release/ /home/app/
+WORKDIR /home/app/
+ENTRYPOINT ["./my_exe"]

dev/docker/examples/alpine-llvm.dockerfile

@@ -0,0 +1,15 @@
+#### Building (example)
+FROM aminya/setup-cpp-alpine-llvm AS builder
+
+COPY ./dev/cpp_vcpkg_project /home/app
+WORKDIR /home/app
+RUN task build
+
+#### Running environment
+# use a fresh image as the runner
+FROM alpine:3.21 AS runner
+
+# copy the built binaries and their runtime dependencies
+COPY --from=builder /home/app/build/my_exe/Release/ /home/app/
+WORKDIR /home/app/
+ENTRYPOINT ["./my_exe"]

dev/docker/examples/alpine-mingw.dockerfile

@@ -0,0 +1,7 @@
+#### Cross Building (example)
+FROM aminya/setup-cpp-alpine-mingw AS builder-mingw
+
+COPY ./dev/cpp_vcpkg_project /home/app
+WORKDIR /home/app
+RUN bash -c 'source ~/.cpprc \
+    && task build_cross_mingw'