···

       
1
       
 
       
# syntax=docker/dockerfile:1

     

       
2
       
-
       
# Since we're building against edge at risk, it is important to note

     

       
3
       
-
       
# that anything might go wrong.

     

       
4
       
-
       
FROM alpine:edge AS buildkit

     

       
5
       
 
       


     

       
6
       
 
       
# Since hadolint isn't in the package repos for Alpine yet, we'll copying from the offical

     

       
7
       
 
       
# Docker image instead.

     

       
8
       
 
       
COPY --from=ghcr.io/hadolint/hadolint:latest-alpine /bin/hadolint /usr/bin/hadolint

     

       
9
       
 
       


     

       
10
       
-
       
ENV PACKAGES=/usr/local/lib/python3.11/site-packages

     

       
11
       
-
       
ENV PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/root/.local/bin

     

       
12
       
-
       
ENV PYTHONDONTWRITEBYTECODE=1

     

       
13
       
 
       


     

       
14
       
 
       
# https://squidfunk.github.io/mkdocs-material/setup/setting-up-social-cards/#linux but for Alpine

     

       
15
       
 
       
# Also installs Doppler CLI for accessing secrets securely within CI

     
···

       
23
       
 
       
     zlib-dev \

     

       
24
       
 
       
     bash \

     

       
25
       
 
       
     coreutils \

     

       
26
       
-
       
     python3 \

     

       
27
       
-
       
     py3-pip \

     

       
28
       
-
       
     pipx \

     

       
29
       
-
       
     py3-wheel \

     

       
30
       
 
       
     shellcheck \

     

       
31
       
 
       
     gcc \

     

       
32
       
 
       
     libffi-dev \

     
···

       
46
       
 
       
    | sh

     

       
47
       
 
       


     

       
48
       
 
       
# See https://www.jeffgeerling.com/blog/2023/how-solve-error-externally-managed-environment-when-installing-pip3

     

       
49
       
-
       
# for context behind removing the EXTERNALLY-MANAGED file

     

       
50
       
-
       
RUN rm -rv /usr/lib/python3*/EXTERNALLY-MANAGED \

     

       
51
       
-
       
  && pip install --no-cache \

     

       
52
       
 
       
      mkdocs-material \

     

       
53
       
 
       
      mkdocs-git-committers-plugin-2 \

     

       
54
       
 
       
      mkdocs-git-revision-date-localized-plugin \

     
···

       
57
       
 
       
      mkdocs-rss-plugin \

     

       
58
       
 
       
      pillow \

     

       
59
       
 
       
      cairosvg \

     

       
60
       
-
       
      pipenv

     

       
0
       
 
       

     

       
61
       
 
       


     

       
62
       
 
       
# Trust directory, required for git >= 2.35.2

     

       
63
       
 
       
# Follows the docs for the Docker-based site build setup

     

···

       
1
       
 
       
# syntax=docker/dockerfile:1

     

       
2
       
+
       
# Instead of using Alpine base image and then installing Python from pkgs.al.o,

     

       
3
       
+
       
# we'll go with the official images instead.

     

       
4
       
+
       
FROM python:3.12-alpine AS buildkit

     

       
5
       
 
       


     

       
6
       
 
       
# Since hadolint isn't in the package repos for Alpine yet, we'll copying from the offical

     

       
7
       
 
       
# Docker image instead.

     

       
8
       
 
       
COPY --from=ghcr.io/hadolint/hadolint:latest-alpine /bin/hadolint /usr/bin/hadolint

     

       
9
       
 
       


     

       
10
       
+
       
ENV PACKAGES=/usr/local/lib/python3.11/site-packages PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/root/.local/bin PYTHONDONTWRITEBYTECODE=1

     

       
11
       
+
       
LABEL org.opencontainers.image.description="GitLab CI image for custom mkdocs-material Docker image, alongside tools @ajhalili2006 use."

     

       
0
       
 
       

     

       
12
       
 
       


     

       
13
       
 
       
# https://squidfunk.github.io/mkdocs-material/setup/setting-up-social-cards/#linux but for Alpine

     

       
14
       
 
       
# Also installs Doppler CLI for accessing secrets securely within CI

     
···

       
22
       
 
       
     zlib-dev \

     

       
23
       
 
       
     bash \

     

       
24
       
 
       
     coreutils \

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
25
       
 
       
     shellcheck \

     

       
26
       
 
       
     gcc \

     

       
27
       
 
       
     libffi-dev \

     
···

       
41
       
 
       
    | sh

     

       
42
       
 
       


     

       
43
       
 
       
# See https://www.jeffgeerling.com/blog/2023/how-solve-error-externally-managed-environment-when-installing-pip3

     

       
44
       
+
       
# for context behind removing the EXTERNALLY-MANAGED file on distribution-built CPython binary releases

     

       
45
       
+
       
RUN pip install --no-cache \

     

       
0
       
 
       

     

       
46
       
 
       
      mkdocs-material \

     

       
47
       
 
       
      mkdocs-git-committers-plugin-2 \

     

       
48
       
 
       
      mkdocs-git-revision-date-localized-plugin \

     
···

       
51
       
 
       
      mkdocs-rss-plugin \

     

       
52
       
 
       
      pillow \

     

       
53
       
 
       
      cairosvg \

     

       
54
       
+
       
      pipenv \

     

       
55
       
+
       
      pipx

     

       
56
       
 
       


     

       
57
       
 
       
# Trust directory, required for git >= 2.35.2

     

       
58
       
 
       
# Follows the docs for the Docker-based site build setup