From 5f63f0dd9e4fa0b5f3936b8588f8dc69cc112336 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Thu, 9 Apr 2026 08:13:19 +0000 Subject: [PATCH] chore(i18n): refresh it translations --- docs/it/ci.md | 69 ++++++++++++++++++++++++++------------------------- 1 file changed, 35 insertions(+), 34 deletions(-) diff --git a/docs/it/ci.md b/docs/it/ci.md index d154baf96..80f67274e 100644 --- a/docs/it/ci.md +++ b/docs/it/ci.md @@ -1,73 +1,74 @@ --- read_when: - - Devi capire perché un job CI è stato eseguito o no + - Devi capire perché un job CI è stato eseguito o non è stato eseguito - Stai eseguendo il debug di controlli GitHub Actions non riusciti -summary: Grafo dei job CI, gate per ambito e comandi locali equivalenti +summary: Grafo dei job CI, gate di ambito ed equivalenti dei comandi locali title: Pipeline CI x-i18n: - generated_at: "2026-04-05T13:46:39Z" + generated_at: "2026-04-09T08:13:18Z" model: gpt-5.4 provider: openai - source_hash: 5a95b6e584b4309bc249866ea436b4dfe30e0298ab8916eadbc344edae3d1194 + source_hash: d104f2510fadd674d7952aa08ad73e10f685afebea8d7f19adc1d428e2bdc908 source_path: ci.md workflow: 15 --- # Pipeline CI -La CI viene eseguita a ogni push su `main` e per ogni pull request. Usa uno scoping intelligente per saltare i job costosi quando sono cambiate solo aree non correlate. +La CI viene eseguita a ogni push su `main` e a ogni pull request. Usa uno scope intelligente per saltare i job costosi quando sono cambiate solo aree non correlate. ## Panoramica dei job -| Job | Scopo | Quando viene eseguito | -| ------------------------ | --------------------------------------------------------------------------------------------------- | ----------------------------------- | -| `preflight` | Rileva modifiche solo alla documentazione, ambiti cambiati, estensioni cambiate e costruisce il manifest CI | Sempre su push e PR non draft | -| `security-fast` | Rilevamento di chiavi private, audit dei workflow tramite `zizmor`, audit delle dipendenze di produzione | Sempre su push e PR non draft | -| `build-artifacts` | Esegue la build di `dist/` e della Control UI una volta, carica artefatti riutilizzabili per i job downstream | Modifiche rilevanti per Node | -| `checks-fast-core` | Lane Linux rapide di correttezza come controlli bundled/plugin-contract/protocol | Modifiche rilevanti per Node | -| `checks-fast-extensions` | Aggrega le lane shard delle estensioni dopo il completamento di `checks-fast-extensions-shard` | Modifiche rilevanti per Node | -| `extension-fast` | Test mirati solo per i bundled plugin modificati | Quando vengono rilevate modifiche alle estensioni | -| `check` | Gate locale principale nella CI: `pnpm check` più `pnpm build:strict-smoke` | Modifiche rilevanti per Node | -| `check-additional` | Guardrail di architettura e boundary più l'harness di regressione gateway watch | Modifiche rilevanti per Node | -| `build-smoke` | Smoke test della CLI buildata e smoke test della memoria all'avvio | Modifiche rilevanti per Node | -| `checks` | Lane Linux Node più pesanti: test completi, test dei canali e compatibilità Node 22 solo per push | Modifiche rilevanti per Node | -| `check-docs` | Controlli di formattazione, lint e link non funzionanti della documentazione | Documentazione modificata | -| `skills-python` | Ruff + pytest per gli Skills basati su Python | Modifiche rilevanti per skill Python | -| `checks-windows` | Lane di test specifiche per Windows | Modifiche rilevanti per Windows | -| `macos-node` | Lane di test TypeScript su macOS che usa gli artefatti buildati condivisi | Modifiche rilevanti per macOS | -| `macos-swift` | Lint, build e test Swift per l'app macOS | Modifiche rilevanti per macOS | -| `android` | Matrice di build e test Android | Modifiche rilevanti per Android | +| Job | Scopo | Quando viene eseguito | +| ------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------- | +| `preflight` | Rileva modifiche solo alla documentazione, scope modificati, estensioni modificate e genera il manifest CI | Sempre su push e PR non bozza | +| `security-fast` | Rilevamento di chiavi private, audit dei workflow tramite `zizmor`, audit delle dipendenze di produzione | Sempre su push e PR non bozza | +| `build-artifacts` | Compila `dist/` e la Control UI una sola volta, carica artefatti riutilizzabili per i job downstream | Modifiche rilevanti per Node | +| `checks-fast-core` | Corse rapide di correttezza su Linux, come controlli bundled/plugin-contract/protocol | Modifiche rilevanti per Node | +| `checks-fast-extensions` | Aggrega le lane shard delle estensioni dopo il completamento di `checks-fast-extensions-shard` | Modifiche rilevanti per Node | +| `extension-fast` | Test mirati solo per i bundled plugin modificati | Quando vengono rilevate modifiche alle estensioni | +| `check` | Gate locale principale nella CI: `pnpm check` più `pnpm build:strict-smoke` | Modifiche rilevanti per Node | +| `check-additional` | Guardrail di architettura, boundary e cicli di import più l'harness di regressione watch del gateway | Modifiche rilevanti per Node | +| `build-smoke` | Smoke test della CLI compilata e smoke test della memoria all'avvio | Modifiche rilevanti per Node | +| `checks` | Lane Linux Node più pesanti: test completi, test dei canali e compatibilità Node 22 solo per push | Modifiche rilevanti per Node | +| `check-docs` | Controlli di formattazione, lint e link non funzionanti della documentazione | Documentazione modificata | +| `skills-python` | Ruff + pytest per le Skills basate su Python | Modifiche rilevanti per Skills Python | +| `checks-windows` | Lane di test specifiche per Windows | Modifiche rilevanti per Windows | +| `macos-node` | Lane di test TypeScript su macOS che usa gli artefatti compilati condivisi | Modifiche rilevanti per macOS | +| `macos-swift` | Lint, build e test Swift per l'app macOS | Modifiche rilevanti per macOS | +| `android` | Matrice di build e test Android | Modifiche rilevanti per Android | ## Ordine fail-fast -I job sono ordinati in modo che i controlli economici falliscano prima che vengano eseguiti quelli più costosi: +I job sono ordinati in modo che i controlli economici falliscano prima che vengano eseguiti quelli costosi: -1. `preflight` decide quali lane esistono del tutto. La logica `docs-scope` e `changed-scope` è composta da step interni a questo job, non da job separati. -2. `security-fast`, `check`, `check-additional`, `check-docs` e `skills-python` falliscono rapidamente senza aspettare i job più pesanti della matrice artefatti e piattaforme. -3. `build-artifacts` si sovrappone alle lane Linux rapide, così i consumer downstream possono iniziare non appena la build condivisa è pronta. +1. `preflight` decide quali lane esistono del tutto. La logica `docs-scope` e `changed-scope` è costituita da step interni a questo job, non da job autonomi. +2. `security-fast`, `check`, `check-additional`, `check-docs` e `skills-python` falliscono rapidamente senza attendere i job più pesanti della matrice di artefatti e piattaforme. +3. `build-artifacts` si sovrappone alle lane Linux rapide così i consumer downstream possono iniziare non appena la build condivisa è pronta. 4. Successivamente si diramano le lane più pesanti di piattaforma e runtime: `checks-fast-core`, `checks-fast-extensions`, `extension-fast`, `checks`, `checks-windows`, `macos-node`, `macos-swift` e `android`. -La logica di ambito si trova in `scripts/ci-changed-scope.mjs` ed è coperta da unit test in `src/scripts/ci-changed-scope.test.ts`. -Il workflow separato `install-smoke` riutilizza lo stesso script di ambito tramite il proprio job `preflight`. Calcola `run_install_smoke` a partire dal segnale changed-smoke più ristretto, quindi lo smoke Docker/install viene eseguito solo per modifiche rilevanti per installazione, packaging e container. +La logica di scope si trova in `scripts/ci-changed-scope.mjs` ed è coperta da unit test in `src/scripts/ci-changed-scope.test.ts`. +Il workflow separato `install-smoke` riutilizza lo stesso script di scope tramite il proprio job `preflight`. Calcola `run_install_smoke` a partire dal segnale changed-smoke più ristretto, quindi lo smoke Docker/install viene eseguito solo per modifiche rilevanti per installazione, packaging e container. -Sui push, la matrice `checks` aggiunge la lane `compat-node22`, eseguita solo sui push. Sulle pull request, quella lane viene saltata e la matrice resta focalizzata sulle normali lane di test/canali. +Sui push, la matrice `checks` aggiunge la lane `compat-node22` solo per push. Sulle pull request, quella lane viene saltata e la matrice resta focalizzata sulle normali lane di test/canali. ## Runner | Runner | Job | | -------------------------------- | ---------------------------------------------------------------------------------------------------- | -| `blacksmith-16vcpu-ubuntu-2404` | `preflight`, `security-fast`, `build-artifacts`, controlli Linux, controlli documentazione, skill Python, `android` | +| `blacksmith-16vcpu-ubuntu-2404` | `preflight`, `security-fast`, `build-artifacts`, controlli Linux, controlli docs, Skills Python, `android` | | `blacksmith-32vcpu-windows-2025` | `checks-windows` | | `macos-latest` | `macos-node`, `macos-swift` | ## Equivalenti locali ```bash -pnpm check # tipi + lint + format +pnpm check # tipi + lint + formato pnpm build:strict-smoke +pnpm check:import-cycles pnpm test:gateway:watch-regression pnpm test # test vitest pnpm test:channels -pnpm check:docs # format documentazione + lint + link non funzionanti -pnpm build # build di dist quando contano le lane CI artifact/build-smoke +pnpm check:docs # formato docs + lint + link non funzionanti +pnpm build # compila dist quando contano le lane CI artifact/build-smoke ```