Skip to content

Latest commit

 

History

History
47 lines (34 loc) · 3.35 KB

File metadata and controls

47 lines (34 loc) · 3.35 KB

Οδηγός Αυτόματων Ελέγχων (CI Map)

Το παρόν έγγραφο περιγράφει τη δομή και τις λειτουργίες των αυτοματοποιημένων ελέγχων (GitHub Actions) στο ZeroClaw.

1. Έλεγχοι Υποχρεωτικής Έγκρισης (Merge-Blocking)

Αυτοί οι έλεγχοι είναι ντετερμινιστικοί και αποτελούν προϋπόθεση για τη συγχώνευση οποιασδήποτε αλλαγής στον κλάδο main.

  • CI (ci-run.yml)
    • Σκοπός: Επαλήθευση σύνταξης Rust, εκτέλεση test suite και ποιοτικός έλεγχος τεκμηρίωσης (docs).
    • Σημείωση: Αλλαγές στο CI απαιτούν ρητή έγκριση από τους Maintainers.
  • Workflow Sanity (workflow-sanity.yml)
    • Σκοπός: Επαλήθευση της ακεραιότητας των αρχείων YAML των GitHub Actions.
  • PR Intake Checks (pr-intake-checks.yml)
    • Σκοπός: Ταχεία διαλογή PR, έλεγχος πληρότητας πληροφοριών και συμμόρφωση με τα πρότυπα κώδικα (linting).

2. Προαιρετικοί και Συμπληρωματικοί Έλεγχοι

  • Docker (pub-docker-img.yml): Επαλήθευση containerization και κατασκευή images για πολλαπλές αρχιτεκτονικές.
  • Security Audit (sec-audit.yml): Σάρωση εξαρτήσεων για γνωστές ευπάθειες.
  • CodeQL Analysis (sec-codeql.yml): Στατική ανάλυση κώδικα για τον εντοπισμό κινδύνων ασφαλείας.
  • Release Automation (pub-release.yml): Διαδικασία δημιουργίας επίσημων releases.

3. Αυτοματοποίηση Διεργασιών

  • PR Labeler: Αυτόματη ταξινόμηση PR βάσει μεγέθους (size:*) και κινδύνου (risk:*).
  • PR Auto Responder: Αυτοματοποιημένη υποδοχή νέων συνεισφερόντων.
  • Stale Manager: Διαχείριση ανενεργών Issues και PRs.
  • Dependabot: Αυτόματη ενημέρωση εξαρτήσεων.

4. Προγραμματισμός Εκτέλεσης

Έλεγχος Συχνότητα / Ερέθισμα
CI / Security Push, Pull Request
Docker / Release Tag Push (v*)
Hygiene (Stale) Καθημερινά

5. Οδηγίες Αντιμετώπισης Αποτυχιών

  1. CI Gate Failure: Ανατρέξτε στα logs της εργασίας ci-run.yml.
  2. Docker Build Failure: Ελέγξτε το pub-docker-img.yml για σφάλματα στο Dockerfile.
  3. Security Findings: Συμβουλευτείτε την αναφορά του sec-audit.yml για απαρχαιωμένες βιβλιοθήκες.
  4. Documentation Issues: Ελέγξτε την ενότητα docs-quality στο ci-run.yml.

Important

Οι έλεγχοι Merge-Blocking πρέπει να παραμένουν σταθεροί και γρήγοροι. Αποφύγετε την προσθήκη χρονοβόρων διαδικασιών στην κύρια ροή του CI.