
مكون GitLab CI لفحص Trivy
مكوّن GitLab CI لـ Trivy — الماسح الأمني الشامل الذي يغطي صور الحاويات وأنظمة الملفات والمستودعات وعناقيد Kubernetes وملفات SBOM والامتثال للتراخيص. أدخل هذه القوالب مباشرةً في خطوط أنابيبك للحصول على عمليات فحص قابلة للتكرار وتقارير أصلية في GitLab ومخرجات قابلة للنقل دون الحاجة تقريبًا إلى كتابة أي أوامر shell.
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
stages:
- test
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
inputs:
job_name: "security:remote"
TRIVY_SCAN_REMOTE_IMAGE: "registry.gitlab.com/group/app:latest"
severity: "CRITICAL,HIGH,MEDIUM"
exit_on_vulnerability: true
stages:
- test
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
inputs:
job_name: "security:local"
TRIVY_SCAN_LOCAL_IMAGES: "dist/"
TRIVY_SCANNERS: "vuln,secret"
exit_on_vulnerability: false
stages:
- test
تسرد كل قالب أدناه مدخلاته المتاحة وقيمه الافتراضية كما هي محددة في مواصفات المكوّن، يليها مثال عملي بسيط.
templates/main.yml| المدخل | الوصف | الافتراضي |
|---|---|---|
job_name | اسم مهمة CI | "trivy scanning" |
stage | مرحلة خط الأنابيب | "test" |
image | صورة الحاوية التي تشغّل Trivy | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_NEEDED_STAGE | المرحلة التي يجب أن تكتمل قبل تشغيل Trivy | "build" |
TRIVY_SCAN_REMOTE_IMAGE | الصورة البعيدة المراد فحصها | "" |
TRIVY_SCAN_LOCAL_IMAGES | مسار مدخلات tar/OCI (يبحث في . عند تركه فارغًا) | "" |
TRIVY_SCANNERS | أدوات الفحص مفصولة بفواصل | "vuln,secret,misconfig" |
severity | مستويات الخطورة المراد تضمينها | "CRITICAL,HIGH" |
exit_on_vulnerability | إفشال المهمة عند العثور على مشكلات | true |
TRIVY_EXTRA_ARGS | أعلام CLI إضافية | "" |
allow_failure | السماح بفشل المهمة دون إفشال خط الأنابيب | false |
مثال
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
inputs:
job_name: "trivy:basic"
TRIVY_SCAN_REMOTE_IMAGE: "nginx:latest"
templates/target_container.yml| المُدخل | الوصف | القيمة الافتراضية |
|---|---|---|
job_name | اسم مهمة CI | "trivy:scan:containers" |
stage | مرحلة خط الأنابيب | "test" |
image | صورة حاوية Trivy | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_SCAN_REMOTE_IMAGE | مرجع الصورة البعيدة | "" |
TRIVY_SCAN_LOCAL_IMAGES | دليل/tar للفحوصات المحلية | "" |
TRIVY_SCANNERS | الفاحصات المفعّلة | "vuln,secret,misconfig" |
TRIVY_IMAGE_SRC | الواجهة الخلفية لمصدر الصورة (remote/docker/...) | "" |
severity | درجات الخطورة | "CRITICAL,HIGH" |
exit_on_vulnerability | الفشل عند مطابقة درجة الخطورة | true |
TRIVY_IGNORE_UNFIXED | تجاهل المشكلات التي لا تتوفر لها إصلاحات | true |
TRIVY_PKG_TYPES | أنواع الحزم | "os,library" |
TRIVY_VULN_TYPE | اسم بديل مهمَل لأنواع الحزم | "" |
TRIVY_TIMEOUT | مهلة الأمر | "10m" |
TRIVY_EXTRA_ARGS | وسائط CLI إضافية | "" |
TRIVY_DB_REPOSITORY | مرآة قاعدة بيانات مخصصة | "" |
TRIVY_JAVA_DB_REPOSITORY | مرآة قاعدة بيانات Java مخصصة | "" |
TRIVY_SKIP_FILES | استثناءات أنماط الملفات | "" |
TRIVY_SKIP_DIRS | استثناءات الأدلة | "" |
allow_failure | السماح بالفشل دون إفشال خط الأنابيب | false |
مثال
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_container@latest
inputs:
job_name: "trivy:containers"
TRIVY_SCAN_REMOTE_IMAGE: "registry.gitlab.com/group/service:latest"
TRIVY_SCANNERS: "vuln,secret"
exit_on_vulnerability: true
templates/target_filesystem.yml| المُدخل | الوصف | القيمة الافتراضية |
|---|---|---|
job_name | اسم مهمة CI | "trivy:scan:filesystem" |
stage | مرحلة خط الأنابيب | "test" |
image | صورة Trivy | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_FS_PATH | الملف أو الدليل المراد فحصه | "." |
TRIVY_SCANNERS | الماسحات المفعّلة | "vuln,secret" |
severity | درجات الخطورة | "CRITICAL,HIGH" |
exit_on_vulnerability | الفشل عند مطابقة درجة الخطورة | true |
TRIVY_IGNORE_UNFIXED | تجاهل المشكلات غير المُصلحة | true |
TRIVY_PKG_TYPES | أنواع الحزم | "os,library" |
TRIVY_TIMEOUT | المهلة الزمنية | "10m" |
TRIVY_SKIP_FILES | أنماط glob للملفات المراد تخطيها | "" |
TRIVY_SKIP_DIRS | الأدلة المراد تخطيها | "" |
TRIVY_EXTRA_ARGS | وسائط CLI إضافية | "" |
TRIVY_REPORT_BASENAME | الاسم الأساسي للمُخرَج | "filesystem-scan" |
allow_failure | السماح بفشل المهمة | false |
مثال
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_filesystem@latest
inputs:
TRIVY_FS_PATH: "services/api"
TRIVY_SCANNERS: "vuln,misconfig,secret"
templates/target_rootfs.yml| المُدخل | الوصف | القيمة الافتراضية |
|---|---|---|
job_name | اسم المهمة | "trivy:scan:rootfs" |
stage | المرحلة | "test" |
image | صورة Trivy | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_ROOTFS_PATH | مسار نظام الملفات الجذري | "/" |
TRIVY_SCANNERS | الماسحات الضوئية | "vuln,secret" |
severity | درجات الخطورة | "CRITICAL,HIGH" |
exit_on_vulnerability | إفشال المهمة عند وجود نتائج | true |
TRIVY_IGNORE_UNFIXED | تجاهل ما لم يُصلَح | true |
TRIVY_PKG_TYPES | أنواع الحزم | "os,library" |
TRIVY_TIMEOUT | المهلة الزمنية | "10m" |
TRIVY_SKIP_FILES | الملفات المراد تخطيها | "" |
TRIVY_SKIP_DIRS | الدلائل المراد تخطيها | "" |
TRIVY_EXTRA_ARGS | وسائط إضافية | "" |
TRIVY_REPORT_BASENAME | الاسم الأساسي للمُخرَج | "rootfs-scan" |
allow_failure | السماح بالفشل | false |
مثال
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_rootfs@latest
inputs:
TRIVY_ROOTFS_PATH: "/mnt/root"
TRIVY_SCANNERS: "vuln"
templates/target_repository.yml| المُدخل | الوصف | القيمة الافتراضية |
|---|---|---|
job_name | اسم المهمة | "trivy:scan:repo" |
stage | المرحلة | "test" |
image | صورة Trivy | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_REPO_TARGET | مسار محلي أو عنوان URL لـ Git | "." |
TRIVY_REPO_BRANCH | الفرع البعيد | "" |
TRIVY_REPO_COMMIT | تجزئة الـ commit | "" |
TRIVY_REPO_TAG | اسم الوسم | "" |
TRIVY_SCANNERS | الماسحات الضوئية | "vuln,secret" |
severity | درجات الخطورة | "CRITICAL,HIGH" |
exit_on_vulnerability | إفشال المهمة عند وجود نتائج | true |
TRIVY_IGNORE_UNFIXED | تجاهل ما لم يُصلَح | true |
TRIVY_TIMEOUT | المهلة الزمنية | "10m" |
TRIVY_SKIP_FILES | الملفات المراد تخطيها | "" |
TRIVY_SKIP_DIRS | المجلدات المراد تخطيها | "" |
TRIVY_EXTRA_ARGS | وسائط إضافية | "" |
TRIVY_REPORT_BASENAME | الاسم الأساسي للمُخرَج | "repo-scan" |
allow_failure | السماح بالفشل | false |
مثال
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_repository@latest
inputs:
TRIVY_REPO_TARGET: "https://github.com/aquasecurity/trivy"
TRIVY_REPO_BRANCH: "main"
templates/target_vm.yml