Tam sürüm doğrulaması

Full Release Validation, sürüm doğrulamasının üst çatısıdır: sürüm öncesi kanıt için tek manuel giriş noktasıdır. Çalışmaların çoğu alt iş akışlarında gerçekleşir; böylece başarısız olan bir ortam, tüm sürüm süreci yeniden başlatılmadan tekrar çalıştırılabilir.

Bunu güvenilir bir iş akışı referansından, normalde main üzerinden çalıştırın ve sürüm dalını, etiketini veya tam commit SHA'sını ref olarak iletin:

gh workflow run full-release-validation.yml \  --ref main \  -f ref=release/YYYY.M.PATCH \  -f provider=openai \  -f mode=both \  -f release_profile=stable

provider, işletim sistemleri arası ilk kurulum ve uçtan uca ajan turu için anthropic veya minimax değerlerini de kabul eder. Yeniden kullanılabilir alt işler, çağrılan iş akışı düzeneğini job.workflow_repository ve job.workflow_sha üzerinden çözümlerken ref girdisi test edilecek adayı seçer. Böylece eski bir sürüm dalı veya etiketi doğrulanırken güncel ve güvenilir doğrulama mantığı kullanılabilir.

Tetiklenen her alt iş, üst Full Release Validation çalıştırmasıyla aynı iş akışı SHA'sını bildirmelidir. Üst ve alt işlerin tetiklenmesi arasında main ilerlerse, alt işin kendisi başarılı olsa bile üst çatı güvenli biçimde başarısız olur. Değişmez ve tam commit kanıtı için pnpm ci:full-release --sha <target-sha> kullanın. Yardımcı, güvenilir güncel origin/main sürümüne sabitlenmiş geçici bir release-ci/* referansı oluşturur, hedef SHA'yı yalnızca aday ref olarak iletir, mevcut olduğunda kesin hedefe ait katı kanıtı yeniden kullanır ve doğrulamadan sonra referansı siler. Yeni bir çalıştırmayı zorlamak için -f reuse_evidence=false, güncel origin/main üzerinden hâlâ erişilebilen daha eski bir iş akışı commit'ini seçmek için --workflow-sha <trusted-main-sha> iletin. İş akışının kendisi depo referanslarını hiçbir zaman oluşturmaz veya güncellemez.

release_profile=stable ve release_profile=full, kapsamlı canlı/Docker dayanıklılık testini her zaman çalıştırır. Aynı dayanıklılık hatlarını beta profiline dahil etmek için run_release_soak=true iletin. Kararlı sürüm yayımlama işlemi, bu dayanıklılık testi ve engelleyici ürün performansı kanıtı bulunmayan bir doğrulama manifestini reddeder.

Package Acceptance normalde aday tarball paketini çözümlenen ref üzerinden oluşturur; buna pnpm ci:full-release ile tetiklenen tam SHA çalıştırmaları da dahildir. Bir beta yayımlandıktan sonra, yayımlanmış npm paketini sürüm denetimleri, Package Acceptance, işletim sistemleri arası testler, sürüm yolu Docker testleri ve paket Telegram testleri genelinde yeniden kullanmak için release_package_spec=openclaw@YYYY.M.PATCH-beta.N iletin. package_acceptance_package_spec değerini yalnızca Package Acceptance'ın bilinçli olarak farklı bir paketi kanıtlaması gerektiğinde kullanın. Codex Plugin canlı paket hattı aynı durumu izler: yayımlanmış release_package_spec değerlerinden codex_plugin_spec=npm:@openclaw/codex@<version> türetilir; SHA/yapıt çalıştırmaları seçilen referanstaki extensions/codex dizinini paketler; operatörler ise npm:, npm-pack: veya git: Plugin kaynakları için codex_plugin_spec değerini doğrudan ayarlayabilir. Hat, bu Plugin tarafından gerekli kılınan açık Codex CLI kurulum onayını verir; ardından Codex CLI ön kontrolünü ve aynı oturumdaki OpenAI ajan turlarını çalıştırır.

Üst düzey aşamalar

rerun_group=all için önce bir Check for reusable validation evidence işi çalışır: tamamen aynı hedef SHA, sürüm profili, etkin dayanıklılık ayarı ve doğrulama girdilerine ait önceki en yeni başarılı tam doğrulamayı arar. Böyle bir kanıt mevcutsa tüm hatlar atlanır ve üst çatı doğrulayıcısı değişmez üst yapıtı, alt çalıştırmaları ve tetikleme günlüklerini yeniden denetler. Bu yalnızca aynı adayın yeniden çalıştırılmasını kurtarmaya yöneliktir; farklı SHA'lar arasında yeniden kullanıma izin vermez. Aday değiştiğinde bu değişiklikten etkilenen her paket, yapıt, kurulum, Docker veya sağlayıcı geçidini yeniden çalıştırın. Baştan yeni bir tam çalıştırmayı zorlamak için reuse_evidence=false iletin. Kanıt yeniden kullanımı yalnızca main üzerinden veya iş akışı commit'i güvenilir main geçmişinde kalmaya devam eden, SHA'ya sabitlenmiş standart bir release-ci/* referansı üzerinden çalışır; diğer iş akışı referansları seçilen hatları yeniden çalıştırır.

Ayrıca rerun_group=all için bir Verify Docker runtime image assets işi, OPENCLAW_EXTENSIONS=diagnostics-otel,codex ile runtime-assets Docker hedefini oluşturur. Diğer aşamalarla paralel çalışır ve üst çatı doğrulayıcısı tarafından zorunlu tutulur; hatlar artık tetiklenmeden önce bunun tamamlanmasını beklemez. Daha dar bir rerun_group bu ön kontrolü atlar.

Üst çatı, ürün performansını her zaman yalnızca yapıt modunda tetikler. OpenClaw Performance, rapor yayımlamaya yalnızca zamanlanmış çalıştırmalarda veya publish_reports=true değerini açıkça ayarlayan manuel tetiklemelerde izin verir. Yalnızca yapıt koruması başarıyla tamamlanmalı ve yayımlayıcı işinin atlanmış kaldığını kanıtlamalıdır. Yeni ve yeniden kullanılan kanıtlar controls.performanceReportPublication=artifact-only kaydını içerir; doğrulayıcı ve yeniden kullanım seçicisi, eşleşen normalleştirilmiş performans alt işi kanıtı bulunmayan kanıtları reddeder.

Doğrulayıcı, standart manifesti full-release-validation-<run-id>-<run-attempt> adıyla yükler. Kanıt araçları, tam olarak bu yapıt kimliğini indirmeden önce yapıtın kimliğini, özetini, üretici çalıştırmasını ve deneme numarasını doğrular. İndirilen ZIP boyutunu sınırlar, baytlarını REST sha256: özetiyle karşılaştırarak doğrular ve arşivi çıkarmadan izin verilen tek sınırlı manifest girdisini akış halinde okur. Eski yayımlama tüketicileri için sabit adlı bir takma ad geçici olarak korunur. Doğrulayıcı her zaman deneme niteleyicili yapıtı tercih eder; geçiş sürecinde sabit adı yalnızca 1. denemedeki manifest v2 üreticisi için kabul eder. Sonraki denemelerde ve manifest v3'te bu eski adı reddeder.

rerun_group=all ile ref=main için, release/* referansları için ve Tideclaw alfa referansları için daha yeni bir üst çatı çalıştırması, aynı referansa ve yeniden çalıştırma grubuna sahip eski çalıştırmanın yerini alır. Üst çalıştırma iptal edildiğinde izleyicisi, önceden tetiklediği tüm alt iş akışlarını iptal eder. Etiket ve sabitlenmiş SHA doğrulama çalıştırmaları birbirini iptal etmez.

Sürüm denetimi aşamaları

OpenClaw Release Checks en büyük alt iş akışıdır. Hedefi bir kez çözümler ve paket ya da Docker odaklı aşamalar gerektirdiğinde paylaşılan bir release-package-under-test yapıtı hazırlar.

Docker sürüm yolu parçaları

Docker sürüm yolu aşaması, live_suite_filter boş olduğunda şu parçaları çalıştırır:

Yalnızca bir Docker hattı başarısız olduğunda yeniden kullanılabilir canlı/E2E iş akışında hedeflenmiş docker_lanes=<lane[,lane]> kullanın. Sürüm yapıtları, kullanılabilir olduğunda paket yapıtı ve imaj yeniden kullanım girdilerini içeren hat başına yeniden çalıştırma komutlarını içerir.

Sürüm profilleri

release_profile, sürüm denetimlerindeki canlı/sağlayıcı kapsamını büyük ölçüde kontrol eder. Normal tam CI, Plugin Ön Sürüm, kurulum duman testi, paket kabulü veya QA Lab'i kaldırmaz. Kararlı ve tam profiller her zaman kapsamlı depo/canlı E2E ve Docker sürüm yolu dayanıklılık kapsamını çalıştırır. Beta profili run_release_soak=true ile bunu etkinleştirebilir. Paket Kabulü, her tam aday için standart paket Telegram E2E'sini sağlar; bu nedenle şemsiye iş akışı söz konusu canlı yoklayıcıyı yinelemez.

Yalnızca tam profile eklenenler

Bu test paketleri stable tarafından atlanır, full tarafından dahil edilir:

stable, native-live-src-gateway-profiles-anthropic-smoke ve native-live-src-gateway-profiles-opencode-go-smoke öğelerini içerir; full ise bunların yerine daha geniş Anthropic ve OpenCode Go model parçalarını kullanır. Odaklı yeniden çalıştırmalar yine de toplu native-live-src-gateway-profiles-anthropic veya native-live-src-gateway-profiles-opencode-go tanıtıcılarını kullanabilir.

Odaklı yeniden çalıştırmalar

İlgisiz sürüm kutularını yinelemekten kaçınmak için rerun_group kullanın:

Tek bir canlı test paketi başarısız olduğunda rerun_group=live-e2e ile live_suite_filter kullanın. Geçerli filtre kimlikleri, yeniden kullanılabilir canlı/E2E iş akışında tanımlanır; bunlar arasında docker-live-models, live-gateway-docker, live-gateway-anthropic-docker, live-gateway-google-docker, live-gateway-minimax-docker, live-gateway-advisory-docker, live-cli-backend-docker, live-acp-bind-docker ve live-codex-harness-docker bulunur.

live-gateway-advisory-docker tanıtıcısı, üç sağlayıcı parçası için toplu bir yeniden çalıştırma tanıtıcısıdır; bu nedenle yine de tüm bilgilendirici Docker gateway işlerine dağılır.

İşletim sistemleri arası tek bir hat başarısız olduğunda rerun_group=cross-os ile cross_os_suite_filter kullanın. Filtre bir işletim sistemi kimliğini, bir test paketi kimliğini veya bir işletim sistemi/test paketi çiftini kabul eder; örneğin windows/packaged-upgrade, windows veya packaged-fresh. İşletim sistemleri arası özetler, paketlenmiş yükseltme hatları için aşama başına süreleri içerir ve uzun süren komutlar Heartbeat satırları yazdırır; böylece takılı kalan bir güncelleme, iş zaman aşımından önce görülebilir.

QA sürüm denetimi hataları, normal sürüm doğrulamasını engeller. QA çalışma zamanı aracı kapsam denetimi de (standart katmanda openclaw ile codex arasındaki dinamik araç sapması), temel QA çalışma zamanı eşlik hattı bilgilendirici olsa bile sürüm denetimi doğrulayıcısını engeller. Tideclaw alfa çalıştırmaları, paket güvenliği dışındaki sürüm denetimi hatlarını yine de bilgilendirici olarak değerlendirebilir. release_profile=beta ile Run repo/live E2E validation canlı sağlayıcı test paketleri bilgilendiricidir: üçüncü taraf model dağıtımları bir sürümün altında değişir; bu nedenle beta, bunların hatalarını uyarı olarak gösterirken kararlı ve tam profiller bunları engelleyici tutar. live_suite_filter, Discord, WhatsApp veya Slack gibi geçitli bir QA canlı hattını açıkça istediğinde eşleşen OPENCLAW_RELEASE_QA_*_LIVE_CI_ENABLED depo değişkeni etkinleştirilmiş olmalıdır; aksi takdirde hat sessizce atlanmak yerine girdi yakalama işlemi başarısız olur. Yeni QA kanıtına ihtiyaç duyduğunuzda rerun_group=qa, qa-parity veya qa-live seçeneklerini yeniden çalıştırın.

Saklanacak kanıtlar

Sürüm düzeyi dizin olarak Full Release Validation özetini saklayın. Bu özet, alt çalıştırma kimliklerine bağlantı verir ve en yavaş iş tablolarını içerir. Hatalarda önce alt iş akışını inceleyin, ardından yukarıdaki en küçük eşleşen tanıtıcıyı yeniden çalıştırın.

Yararlı yapıtlar:

• OpenClaw Release Checks içindeki release-package-under-test
• .artifacts/docker-tests/ altındaki Docker sürüm yolu yapıtları
• Paket Kabulü package-under-test ve Docker kabul yapıtları
• Her işletim sistemi ve test paketi için işletim sistemleri arası sürüm denetimi yapıtları
• QA eşliği, çalışma zamanı eşliği, Matrix ve Telegram yapıtları

İş akışı dosyaları

• .github/workflows/full-release-validation.yml
• .github/workflows/openclaw-release-checks.yml
• .github/workflows/openclaw-live-and-e2e-checks-reusable.yml
• .github/workflows/plugin-prerelease.yml
• .github/workflows/install-smoke.yml
• .github/workflows/install-smoke-reusable.yml
• .github/workflows/openclaw-cross-os-release-checks-reusable.yml
• .github/workflows/package-acceptance.yml
• .github/workflows/openclaw-performance.yml
• .github/workflows/npm-telegram-beta-e2e.yml