This commit is contained in:
2026-07-27 10:51:50 +08:00
parent 3527975794
commit 5809cb2374
3 changed files with 299 additions and 0 deletions
+38
View File
@@ -0,0 +1,38 @@
.venv/
.venv.bak/
__pycache__/
*.py[cod]
*.egg-info/
.pytest_cache/
.mypy_cache/
.ruff_cache/
.idea/
.vscode/
.DS_Store
# 凭据与本地配置
.env
.env.*
!.env.example
# 运行时产物
logs/
.probe/
# 测试不进镜像(Jenkinsfile 里单独跑)
tests/
# 仓库元数据与文档
.git/
.gitignore
.gitattributes
.mcp.json
README.md
*.md
# CI / 部署文件本身
Dockerfile
.dockerignore
Jenkinsfile
docker-compose*.yml
deploy/
+115
View File
@@ -0,0 +1,115 @@
# syntax=docker/dockerfile:1.7
#
# 多阶段构建:
# builder —— 装 uv、跑 uv sync 拿到 .venv(含 browser 兜底的 playwright)
# runtime —— 仅保留 .venv + app + Chromium 二进制;非 root 运行
#
# 镜像默认包含 Playwright 浏览器兜底(与 .env.example 的
# RAKUTEN_BROWSER_FALLBACK_ENABLED=true 对齐),首次构建多约 400MB。
# 若要裁剪,可改为 uv sync --no-dev(去掉 --extra browser)。
# ----------------------------- builder -----------------------------
FROM registry.jerryyan.top/library/python:3.13-slim AS builder
ENV PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1 \
UV_LINK_MODE=copy \
UV_COMPILE_BYTECODE=1 \
# 国内 PyPI 镜像:uv sync / uv pip install 走阿里云,避免从官方 PyPI 拉包缓慢
UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
# uv pin 一个已知版本,保证构建可复现
COPY --from=registry-ghcr.jerryyan.top/astral-sh/uv:python3.13-bookworm-slim /uv /uvx /usr/local/bin/
WORKDIR /app
# 先拷锁文件 + 元数据,让依赖层独立缓存
COPY uv.lock pyproject.toml ./
RUN --mount=type=cache,target=/root/.cache/uv \
uv sync --frozen --no-dev --extra browser
# 再拷源码并 install(这样改 app/ 不会重下依赖)
COPY app ./app
RUN --mount=type=cache,target=/root/.cache/uv \
uv sync --frozen --no-dev --extra browser
# ----------------------------- runtime -----------------------------
FROM registry.jerryyan.top/library/python:3.13-slim AS runtime
ENV PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1 \
VIRTUAL_ENV=/app/.venv \
PATH="/app/.venv/bin:${PATH}" \
PLAYWRIGHT_BROWSERS_PATH=/ms-playwright \
# Playwright 浏览器二进制走 npmmirror 镜像,避免从 azureedge 拉取缓慢
PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright \
RAKUTEN_APP_HOST=0.0.0.0 \
RAKUTEN_APP_PORT=31107
# Chromium 运行所需的最小系统依赖。
# 这里显式列出而不是用 `playwright install-deps`,是因为后者要求 root + apt
# 且版本敏感;锁版本后构建更稳。当前用 libasound2(bookworm 命名);
# 若基础镜像切到 trixie,需改为 libasound2t64。
RUN set -e; \
{ \
if [ -f /etc/apt/sources.list ]; then \
sed -i 's|deb.debian.org|mirrors.aliyun.com|g; s|security.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list; \
fi; \
if [ -f /etc/apt/sources.list.d/debian.sources ]; then \
sed -i 's|deb.debian.org|mirrors.aliyun.com|g; s|security.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources; \
fi; \
} && \
apt-get update && apt-get install -y --no-install-recommends \
ca-certificates \
curl \
fonts-liberation \
libasound2 \
libatk-bridge2.0-0 \
libatk1.0-0 \
libcairo2 \
libcups2 \
libdbus-1-3 \
libdrm2 \
libgbm1 \
libglib2.0-0 \
libnspr4 \
libnss3 \
libpango-1.0-0 \
libx11-6 \
libxcb1 \
libxcomposite1 \
libxdamage1 \
libxext6 \
libxfixes3 \
libxkbcommon0 \
libxrandr2 \
xdg-utils \
&& rm -rf /var/lib/apt/lists/*
# 非 root 账号
RUN groupadd --system --gid 10001 rakuten \
&& useradd --system --uid 10001 --gid rakuten --no-create-home --shell /usr/sbin/nologin rakuten
WORKDIR /app
# venv + 源码
COPY --from=builder /app/.venv /app/.venv
COPY --from=builder /app/app /app/app
# 可写目录:logs(Loguru)、浏览器二进制(~300MB)
RUN mkdir -p /app/logs /ms-playwright \
&& chown -R rakuten:rakuten /app /ms-playwright
USER rakuten
# 下载 Chromium(仅二进制,不再装系统依赖)
RUN /app/.venv/bin/playwright install chromium
# 健康检查走应用自带的 /health(轻量、不会触发真实抓取)
HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
CMD curl -fsS http://127.0.0.1:${RAKUTEN_APP_PORT}/health || exit 1
EXPOSE 31107
# 配置走环境变量(生产请挂 .env 或用 k8s ConfigMap/Secret 注入)
CMD ["python", "-m", "app.main"]
Vendored
+146
View File
@@ -0,0 +1,146 @@
// Jenkinsfile —— jp-rakuten(乐天 / ラクマ 抓取服务)
//
// 默认 registry: git.jerryyan.net/jp/rakuten-api
// 构建参数说明见各 stage 顶部;首次使用前请在 Jenkins 里配置凭据:
// - git-credentials : 拉代码的 SSH / HTTPS 凭据
// - gitea-registry : docker login git.jerryyan.net 的凭据(username/password)
pipeline {
agent any
options {
timestamps()
timeout(time: 30, unit: 'MINUTES')
disableConcurrentBuilds()
buildDiscarder(logRotator(numToKeepStr: '20', daysToKeepStr: '14'))
}
parameters {
string(name: 'IMAGE_NAME',
defaultValue: 'git.jerryyan.net/jp/rakuten-api',
description: '镜像完整名(含 registry host)')
string(name: 'IMAGE_TAG',
defaultValue: '',
description: '自定义 tag;留空则用 <BUILD_NUMBER>-<git short sha>')
booleanParam(name: 'SKIP_TEST',
defaultValue: false,
description: '跳过单测(紧急发版用,正常构建不要勾)')
booleanParam(name: 'PUSH_LATEST',
defaultValue: true,
description: '同时打 :latest 并推送')
}
environment {
// 让 docker build 看到 BuildKit 缓存挂载等特性
DOCKER_BUILDKIT = '1'
// 禁掉 pip 警告、Jenkins 写 .pyc
PYTHONUNBUFFERED = '1'
PYTHONDONTWRITEBYTECODE = '1'
// 国内镜像:uv / pip 拉包走阿里云 PyPI 镜像,避免拉取缓慢
UV_INDEX_URL = 'https://mirrors.aliyun.com/pypi/simple/'
}
stages {
stage('Checkout') {
steps {
checkout scm
script {
env.GIT_SHA = sh(script: 'git rev-parse --short HEAD', returnStdout: true).trim()
env.GIT_TAG = sh(script: 'git describe --tags --always --dirty 2>/dev/null || echo ""', returnStdout: true).trim()
if (!params.IMAGE_TAG?.trim()) {
env.IMAGE_TAG = "${env.BUILD_NUMBER}-${env.GIT_SHA}"
}
echo "镜像目标: ${env.IMAGE_NAME}:${env.IMAGE_TAG}(git=${env.GIT_SHA})"
}
}
}
stage('Test') {
// 跳过逻辑:SKIP_TEST=true 时整个 stage 不跑
when {
expression { return !params.SKIP_TEST }
}
// 在官方 Python 镜像里跑测试,避免污染宿主机;只装 dev extra,不装 browser
agent {
docker {
image 'registry.jerryyan.top/library/python:3.13-slim'
reuseNode true
}
}
steps {
sh '''
set -e
# 阿里云 PyPI 镜像,UV_INDEX_URL 由 pipeline environment 注入
python -m pip install --quiet --upgrade pip -i "$UV_INDEX_URL"
pip install --quiet uv -i "$UV_INDEX_URL"
uv sync --frozen --extra dev
.venv/bin/python -m pytest -q
'''
}
}
stage('Build image') {
steps {
script {
// 同时打两个 tag:精确 tag + 可选 latest
def tags = ["-t ${env.IMAGE_NAME}:${env.IMAGE_TAG}"]
if (params.PUSH_LATEST) {
tags << "-t ${env.IMAGE_NAME}:latest"
}
sh """
docker build ${tags.join(' ')} \
--label org.opencontainers.image.revision=${env.GIT_SHA} \
--label org.opencontainers.image.version=${env.IMAGE_TAG} \
-f Dockerfile .
"""
}
}
}
stage('Push image') {
// 只在 master / 手动构建时推送;PR 构建只产镜像不推
when {
anyOf {
branch 'master'
branch 'main'
buildingTag()
expression { return !params.IMAGE_TAG?.trim().isEmpty() && params.IMAGE_TAG != "${env.BUILD_NUMBER}-${env.GIT_SHA}" }
}
}
steps {
withCredentials([usernamePassword(
credentialsId: 'gitea-registry',
usernameVariable: 'REGISTRY_USER',
passwordVariable: 'REGISTRY_PASS',
)]) {
sh """
echo "\$REGISTRY_PASS" | docker login git.jerryyan.net -u "\$REGISTRY_USER" --password-stdin
docker push ${env.IMAGE_NAME}:${env.IMAGE_TAG}
"""
script {
if (params.PUSH_LATEST) {
sh "docker push ${env.IMAGE_NAME}:latest"
}
}
}
}
}
}
post {
always {
// 清理本次构建产生的镜像,避免 Jenkins agent 磁盘膨胀
sh """
docker rmi -f ${env.IMAGE_NAME}:${env.IMAGE_TAG} 2>/dev/null || true
docker rmi -f ${env.IMAGE_NAME}:latest 2>/dev/null || true
"""
}
success {
echo "构建成功:${env.IMAGE_NAME}:${env.IMAGE_TAG}"
}
failure {
echo "构建失败,请查看上方日志"
}
}
}