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:
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: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 paketleristable 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çinrerun_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 olarakFull 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 Checkskaynağındanrelease-package-under-test.artifacts/docker-tests/altındaki Docker sürüm yolu yapıtları- Paket Kabulü
package-under-testve 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