poetry

كل وسم هو فهرس متعدد المعماريات (amd64 + arm64) مثبّت بالبصمة. موسوم بالإصدار، وليس أبدًا :latest.

استخدمها كصورة أساس

أشِر إليها في سطر FROM داخل ملف Dockerfile. تعمل بدون صلاحيات الجذر، بنظام ملفات جذر للقراءة فقط، ومبنية لـ amd64 و arm64.

FROM ghcr.io/quenchworks/images/poetry:2.4.1

أو اسحبها مباشرة

docker pull ghcr.io/quenchworks/images/poetry:2.4.1

خط الإصدار

2.4.1

الخط الأحدث

2.4.1, 2.3.4, 2.4.0

المعماريات

amd64, arm64

تعمل كـ

nonroot (uid 1001)

نظام الملفات الجذر

للقراءة فقط

الرخصة

MIT

تحقّق من سلسلة التوريد

هذه الصورة موقّعة بـ cosign وتحمل قائمة مكوّنات SPDX SBOM وشهادة منشأ بناء SLSA على البصمة نفسها. تحقّق من الثلاثة جميعها قبل أن تبني عليها:

# 1. signature — built and signed by QuenchWorks CI
cosign verify ghcr.io/quenchworks/images/poetry:2.4.1 \
  --certificate-identity-regexp 'https://github.com/quenchworks/.+' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

# 2. SLSA build provenance — which workflow built it, from what
cosign verify-attestation --type https://slsa.dev/provenance/v1 ghcr.io/quenchworks/images/poetry:2.4.1 \
  --certificate-identity-regexp 'https://github.com/quenchworks/.+' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

# 3. SPDX SBOM — the package inventory
cosign verify-attestation --type https://spdx.dev/Document/v2.3 ghcr.io/quenchworks/images/poetry:2.4.1 \
  --certificate-identity-regexp 'https://github.com/quenchworks/.+' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

راجع دليل SBOM والمنشأ لقراءة قائمة المكوّنات واستخدام هذه الفحوص في التكامل المستمر.

أفضل ممارسة لملف Dockerfile لـ 2.4.1

Poetry leads: it installs the locked, production-only dependency set into an in-project venv, then a clean python base receives that venv and the app. Poetry never ships in the runtime image.

1
# Build stage: Poetry installs the main group into an in-project venv.
2
FROM ghcr.io/quenchworks/images/poetry:2.4.1 AS build
3
USER root
4
WORKDIR /app
5
ENV POETRY_VIRTUALENVS_IN_PROJECT=true \
6
    POETRY_NO_INTERACTION=1 \
7
    POETRY_CACHE_DIR=/tmp/poetry
8

9
COPY pyproject.toml poetry.lock ./
10
RUN ["poetry", "install", "--only", "main", "--no-root"]
11
COPY . .
12
RUN ["poetry", "install", "--only", "main"]
13

14
# Runtime stage: copy the venv + app onto a clean python base, nonroot.
15
FROM ghcr.io/quenchworks/images/python:3.14.7 AS runtime
16
WORKDIR /app
17
ENV PATH="/app/.venv/bin:$PATH" \
18
    PYTHONUNBUFFERED=1
19
COPY --from=build /app/.venv /app/.venv
20
COPY --from=build /app /app
21
USER 1001
22
EXPOSE 8000
23
CMD ["python", "-m", "app"]

هذا الملف Dockerfile مثبّت على خط 2.4.1 . للاطّلاع على شرح سطرًا بسطر وعلى متغيّرات المنظومات (npm/Yarn، pip/uv/Poetry، Maven/Gradle)، راجع دليل ابنِ تطبيق Python.