
Trivy स्कैनिंग के लिए GitLab CI घटक
Trivy के लिए एक GitLab CI कंपोनेंट — एक ऑल-इन-वन सुरक्षा स्कैनर जो कंटेनर इमेज, फाइलसिस्टम, रिपॉज़िटरी, Kubernetes क्लस्टर, SBOM और लाइसेंस अनुपालन को कवर करता है। इन टेम्पलेट्स को सीधे अपनी पाइपलाइन में जोड़ें ताकि लगभग बिना किसी शेल स्क्रिप्टिंग के दोहराने योग्य स्कैन, GitLab-नेटिव रिपोर्ट और पोर्टेबल आर्टिफैक्ट प्राप्त हो सकें।
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 | pkg प्रकारों के लिए अप्रचलित उपनाम | "" |
TRIVY_TIMEOUT | कमांड टाइमआउट | "10m" |
TRIVY_EXTRA_ARGS | अतिरिक्त CLI आर्ग्युमेंट | "" |
TRIVY_DB_REPOSITORY | कस्टम DB मिरर | "" |
TRIVY_JAVA_DB_REPOSITORY | कस्टम Java DB मिरर | "" |
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 | छोड़ने के लिए फ़ाइल ग्लोब | "" |
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 | स्थानीय पथ या Git URL | "." |
TRIVY_REPO_BRANCH | रिमोट ब्रांच | "" |
TRIVY_REPO_COMMIT | कमिट हैश | "" |
TRIVY_REPO_TAG | टैग का नाम | "" |
TRIVY_SCANNERS | स्कैनर | "vuln,secret" |
severity | गंभीरता स्तर | "CRITICAL,HIGH" |
exit_on_vulnerability | निष्कर्ष मिलने पर जॉब विफल करें | true |
TRIVY_IGNORE_UNFIXED | अपरिवर्तित (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"