Tam sürüm doğrulaması

Full Release Validation, sürüm ürün doğrulamasını kapsayan üst iş akışıdır. Çalışmaların çoğu, başarısız olan bir ortamın tüm sürüm yeniden başlatılmadan tekrar çalıştırılabilmesi için alt iş akışlarında gerçekleşir. Code SHA'yı sabitlemeden önce sürüm hazırlığını çalıştırın; arka plan botu Control UI yerel ayar çıktısını henüz birleştirmediyse bu işlem çıktıyı yeniler, ardından sürüm CI işlem hattında kullanılan aynı katı sıfır geri dönüş denetimini uygular.

Ürün açısından tamamlanmış, değişiklik günlüğü öncesi commit'i Code SHA olarak sabitleyin, ardından şunu çalıştırın:

pnpm ci:full-release \  --sha <code-sha> \  --target-ref release/YYYY.M.PATCH

provider, işletim sistemleri arası ilk katılım ve uçtan uca ajan turu için anthropic veya minimax değerlerini de kabul eder. Yardımcı, alfa/beta paket sürümlerinden beta profilini, aksi durumda stable profilini çıkarır. Alternatif iş akışı girdilerini -f key=value ile iletin; -f release_profile=full seçeneğini yalnızca geniş kapsamlı danışma taraması için kullanın.

Yardımcı, güvenilir tek bir origin/main iş akışı SHA'sına sabitlenmiş geçici bir release-ci/* ref'i oluşturur, hedef SHA'yı yalnızca aday ref olarak iletir ve doğrulamadan sonra geçici ref'i siler. Tetiklenen her alt iş akışı aynı iş akışı SHA'sını bildirmelidir. 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 hiçbir zaman depo ref'leri oluşturmaz veya güncellemez.

Extended-stable istisnası

Extended-stable yayımlama, hem iş akışının hem de hedefin standart dal olduğu bir çalıştırma gerektirir:

gh workflow run full-release-validation.yml \  --ref extended-stable/YYYY.M.33 \  -f ref=extended-stable/YYYY.M.33 \  -f release_profile=stable

pnpm ci:full-release veya release-ci/* kullanmayın. Yayımlama; çalıştırmanın dalını, baş/hedef SHA'sını, manifest workflowRef değerini, kimliğini ve deneme numarasını standart dala ve sürüm commit'ine bağlar.

Ürün hatalarını backport edin; sabitlenmiş hedef araçları için davranışı koruyan en küçük onarımı yapın; sağlayıcı, onay veya çalıştırıcı hatalarını kaynak değişikliği olmadan yeniden deneyin. Her dal değişikliği tamamen yeni bir çalıştırma gerektirir. Hedef eski olduğu için gerekli paket, yükleyici, güncelleme, kanal veya canlı davranışı atlamayın.

Normal bir sürümde Code SHA yeşil olduğunda yalnızca CHANGELOG.md dosyasını oluşturup commit edin. Bu yeni commit Release SHA olur. Aynı yardımcıyı Release SHA için çalıştırın. Ürün kanıtı yalnızca GitHub, Release SHA'nın Code SHA'nın soyundan geldiğini ve değişen yolların eksiksiz kümesinin tam olarak CHANGELOG.md olduğunu kanıtladığında yeniden kullanılır; npm ön kontrolü ile paket/yükleme kabulü yine de Release SHA üzerinde çalışır.

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

Package Acceptance normalde aday tarball'u, pnpm ci:full-release ile tetiklenen tam SHA çalıştırmaları dâhil olmak üzere çözümlenen ref değerinden oluşturur. Bir beta yayımlamasından sonra, yayımlanmış npm paketini sürüm denetimleri, Package Acceptance, işletim sistemleri arası denetimler, sürüm yolu Docker ve paket Telegram genelinde yeniden kullanmak için release_package_spec=openclaw@YYYY.M.PATCH-beta.N iletin. package_acceptance_package_spec seçeneğini yalnızca Package Acceptance'ın kasıtlı 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/artefakt çalıştırmaları seçilen ref'ten extensions/codex paketler ve operatörler npm:, npm-pack: veya git: Plugin kaynakları için codex_plugin_spec değerini doğrudan ayarlayabilir. Hat, bu Plugin'in gerektirdiği açık Codex CLI yükleme onayını verir, ardından Codex CLI ön kontrolünü ve aynı oturumdaki OpenAI ajan turlarını çalıştırır. Sıfır yeniden denemeli, orta düzey düşünmeli son turu; Codex final atlanmış olarak görünür ilerleme gönderir, rastgeleleştirilmiş çalışma alanı girdilerini okur, bunların birebir artefaktını yazar ve açık bir tamamlanma iletisi gönderir. Bu, sıradan bir ilerleme gönderiminin turu sonlandırdığı v2026.7.1 regresyonunu yakalar.

Üst düzey aşamalar

rerun_group=all için önce bir Check for reusable validation evidence işi çalışır. Aynı sürüm profiline, etkin dayanıklılık testi ayarına ve doğrulama girdilerine sahip, önceki en yeni yeşil tam doğrulamayı arar. Tam hedef yeniden çalıştırmaları exact-target-full-validation-v1 kullanır. Eksiksiz farkı tam olarak CHANGELOG.md olan bir alt commit changelog-only-release-v1 kullanır; tüm ürün hatları atlanır ve doğrulayıcı GitHub commit karşılaştırmasını, değişmez üst artefaktı, alt çalıştırmaları ve tetikleme günlüklerini bağımsız olarak yeniden denetler. Diğer tüm hedef değişiklikleri yeni bir Code SHA doğrulaması gerektirir. Yeni bir tam çalıştırmayı zorlamak için reuse_evidence=false iletin. Kanıt yeniden kullanımı yalnızca main veya iş akışı commit'i güvenilir main soyunda kalan, standart ve SHA'ya sabitlenmiş bir release-ci/* ref'inden çalışır; diğer iş akışı ref'leri seçilen hatları yeniden çalıştırır.

Yeni paket odaklı doğrulama, Plugin Prerelease ve OpenClaw Release Checks'i tetiklemeden önce değişmez tek bir tarball ile tek bir Docker imajı artefaktı hazırlar. Her iki alt iş akışı da kullanımdan önce aynı paket SHA'sını, artefakt kimliklerini, hizmet özetlerini, üretici çalıştırma denemesini ve Docker arşivi özetini doğrular. Paketten bağımsız yalın Docker katmanı, içerik adresli bir GHCR önbelleği kullanır; adaya özgü imajlar değişmez GitHub artefaktları olarak kalır. Açıkça belirtilmiş, yayımlanmış paket tanımına sahip odaklanmış çalıştırmalar ise mevcut paket yolunu korur.

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

Üst iş akışı, ürün performansını her zaman yalnızca artefakt modunda tetikler. OpenClaw Performance, rapor yayımlamaya yalnızca zamanlanmış çalıştırmalar veya publish_reports=true değerini açıkça ayarlayan manuel bir tetikleme için izin verir. Yalnızca artefakt 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 değerini kaydeder; doğrulayıcı ve yeniden kullanım seçici, eşleşen normalleştirilmiş performans alt iş akışı kanıtı bulunmayan kanıtları reddeder.

Doğrulayıcı, kurallı manifesti full-release-validation-<run-id>-<run-attempt> olarak yükler. Kanıt araçları, tam olarak bu yapıt kimliğini indirmeden önce yapıt kimliğini, özetini, üretici çalıştırmasını ve denemesini doğrular. İndirilen ZIP'in 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ış olarak işler. Eski yayınlama tüketicileri için kararlı adlı bir diğer ad geçici olarak kalır. Doğrulayıcı her zaman deneme niteleyicili yapıtı tercih eder; geçiş sürecinde kararlı adı yalnızca deneme-1 manifest v2 üreticisi için kabul eder. Sonraki denemelerde ve manifest v3 için bu eski adı reddeder.

rerun_group=all ile ref=main, release/* referansları ve Tideclaw alfa referansları için, daha yeni bir şemsiye çalıştırma aynı referansa ve yeniden çalıştırma grubuna sahip eski bir çalıştırmanın yerini alır. Üst öğe iptal edildiğinde izleyicisi, daha önce gönderdiğ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 kullanılabilir olduğunda şemsiyenin paylaşılan paket yapıtını doğrular. Doğrudan veya odaklanmış bir gönderim, paket ya da Docker'a yönelik aşamalar gerektirdiğinde kendi release-package-under-test yapıtını 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 hedefli docker_lanes=<lane[,lane]> kullanın. Sürüm yapıtları, mevcut olduğunda paket yapıtı ve görüntü 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ünü, kurulum smoke testini, paket kabulünü 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ğladığından, çatı iş akışı bu canlı yoklayıcıyı tekrarlamaz.

Yalnızca tam profile eklenenler

Bu test paketleri stable tarafından atlanır ve 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 bunun yerine daha geniş Anthropic ve OpenCode Go model parçalarını kullanır. Odaklı yeniden çalıştırmalar yine 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:

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 ve 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 değerlerini içerir.

Odaklı bir QA aktarım yeniden çalıştırması için rerun_group=qa-live ayarlayın ve standart seçici qa-live-matrix, qa-live-telegram, qa-live-discord, qa-live-whatsapp veya qa-live-slack değerini kullanın.

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 tüm danışma amaçlı Docker gateway işlerine yayılır.

İşletim sistemleri arası hatlardan biri başarısız olduğunda rerun_group=cross-os ile cross_os_suite_filter kullanın. Filtre bir işletim sistemi kimliği, test paketi kimliği veya işletim sistemi/test paketi çifti 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 zamanlamaları içerir ve uzun süren komutlar, takılı kalan bir güncellemenin iş zaman aşımından önce görünür olması için Heartbeat satırları yazdırır.

QA sürüm denetimi hataları, normal sürüm doğrulamasını yalnızca seçili Matrix, Telegram ve QA çalışma zamanı araç kapsamı hatları için engeller. QA eşdeğerliği, çalışma zamanı eşdeğerliği ve kapılı Discord, WhatsApp ve Slack canlı hatları danışma amaçlıdır ve sürüm doğrulayıcıyı engellemeden durum yapıtları yayımlar. Tideclaw alfa çalıştırmaları, paket güvenliği dışındaki sürüm denetimi hatlarını yine danışma amaçlı kabul edebilir. release_profile=beta ile Run repo/live E2E validation canlı sağlayıcı test paketleri danışma amaçlıdır: üçüncü taraf model dağıtımları bir sürümün altında değiştiğinden, beta bunların hatalarını uyarı olarak gösterirken kararlı ve tam profiller bunları engelleyici tutar. live_suite_filter, Discord, WhatsApp veya Slack gibi kapılı 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 başarısız olur. Yeni QA kanıtı gerektiğinde rerun_group=qa, qa-parity veya qa-live öğesini 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.

Normal bir sürüm için hem Kod SHA'sını hem Sürüm SHA'sını, yeniden kullanım politikasını ve değiştirilen yollar kümesini, yeşil Kod SHA üst çalıştırmasını ve hafif Sürüm SHA üst çalıştırmasını kaydedin. Uzatılmış kararlı sürüm için standart dalı, tam sürüm SHA'sını, yeni üst çalıştırma kimliğini ve denemesini, iş akışı referansını, her alt çalıştırmayı ve dondurulmuş hedefe yönelik uyumluluk onarımlarını veya kasıtlı atlamaları kaydedin.

Yararlı yapıtlar:

• OpenClaw Release Checks kaynağından 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şdeğerliği, çalışma zamanı eşdeğerliği ve seçili Matrix, Telegram, Discord, WhatsApp veya Slack 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