GRM-172: docs: document pre-pull image usage guidelines

Co-authored-by: emo <emo@oblachno.com>
2026-08-27 16:04:45 +00:00
parent 7816733e5e
commit d9dae396bc
2 changed files with 47 additions and 0 deletions
@@ -8,6 +8,15 @@
 #
 # Set gitea_runner_pre_pull_images to a list of image refs to pull, or
 # empty list to skip pre-pulling.
+#
+# IMPORTANT: Do NOT use this mechanism for:
+#   - CI runner container images (e.g. ci-full) — these are already
+#     cached by the runner setup task and pulling them here is redundant.
+#   - Images that molecule tests pull themselves — molecule prepare/converge
+#     steps handle their own image pulls; pre-pulling them here wastes time
+#     and disk space.
+# This mechanism is intended only for images that are needed by the runner
+# itself but not pulled by any molecule scenario or runner setup step.

 - name: Pre-pull Docker images for CI runner
  ansible.builtin.command: "docker pull {{ item }}"