Orbit
Orbit Sürümleri
The Releases tab turns your git tags into a version history you can read: every tagged deployment, in order, with its commit, its author, its status and a link straight to the tag in your repository.
Releases sekmesi git etiketlerinizi okunabilir bir sürüm geçmişine dönüştürür: her etiketlenmiş dağıtım, sırasıyla, kendi commit'i, yazarı, durumu ve depo'da etiketin doğrudan bağlantısı ile gösterilir.
Releases Nereye Açılır
Orbit'i açın, projeyi tıklayın ve proje sekmesi şeridindeki Deployments grubu altında Releases'ı seçin. Sayfa Releases başlığını taşır ve kendisini etiket tabanlı dağıtımlar olarak tanımlar: bir git etiketi etiket şablonunla eşleştiğinde bir sürüm oluşturulur.
Komşu Deployments sekmesi etiketli olsun ya da olmasın her yapıyı listeler. Releases filtrelenmiş görünümdür: yalnızca sürüm olarak işaretlediğiniz olanlar.
Etiket Şablonunu Ayarlama
Releases bir şablonla başlar. Settings'i açın, Git tag deploys kartını bulun ve v* ya da release-* gibi bir glob girin. Boş bırakılırsa etiket dağıtımları tamamen devre dışı bırakır, bu yüzden alanın yer tutucu metni v* (disabled) olarak okunur.
Bir şablon ayarlandıktan sonra, eşleşen bir etiketi gitmek üretim'e dağıtır ve sonucu bir sürüm olarak kaydeder. Olmadığında, Releases sekmesi boş durumu gösterir ve sizi bir etiket gitmek ve Settings'te bir şablon ayarlamaya davet eder.
Bir etiket şablonu, üretim dalına gitmek ile birlikte üretim'e gitmek için ikinci, açık bir yol sağlar. Dağıtımların birleştirmenin yan etkisi yerine kasıtlı bir eylem olmasını isteyen takımlar genellikle dal otomatik dağıtımını kapatır ve üretim'i yalnızca etiketlerden yönlendirir.
Bir Sürüm Kesmek
Sizin tarafınızdan yapmanız gereken tüm akış iki git komutudur:
git tag -a v1.4.0 -m "Checkout flow rebuild"
git push origin v1.4.0
Orbit etiketi alır, şablonunuzla eşleştirir, etiketli commit'i üretim'e dağıtır ve bir sürümü kaydeder. Bu sekmede Building rozeti ile görünür ve iniş sırasında Deployed'e ya da yapı hata verirse Failed'e geçer.
Hafif etiketler yerine açıklamalı etiketleri kullanın. Açıklamalı bir etiket, bir mesaj, bir yazar ve bir tarih taşır, bunların tümü sürüme ulaşır.
Mevcut bir Dağıtımı Etiketlemek
Bir sürüm almak için bir git etiketi gitmek zorunlu değildir. Herhangi bir dağıtım, ayrıntı sayfasından etiketlenebilir ve sürüm numarası gibi görünen bir etiket burada alınır.
Sürüm şeklinde etiket 1.4, 1.4.0, v1.4.0 veya v2.0.0-rc1 gibi olandır. Başka her şey düz dağıtım etiketi olarak kalır ve sürüm giriş oluşturmaz.
Bu, bir sürümün şablonu ayarlamadan önce çıkması ya da bir hotfix'in el ile dağıtılması ve sırada olmasını istediğiniz durumlar için kaçış yoludur.
Bir Sürümü Okumak
Her sürüm satırı gösterir:
- Etiketi, sürümün başlığı olarak.
- Commit ve mesajı.
- Yazarı, by name olarak gösterilir.
- Gidilen ortam, tür tarafından renk kodlanmış.
- Durum rozeti: Deployed, Building veya Failed.
- Depo'da etikete gitmek için View on bağlantısı.
- Temel dağıtıma gitmek için bağlantı.
View on bağlantısı sağlayıcı başına doğru yere işaret eder: GitHub'da sürümler sayfası, GitLab'da etiket sayfası veya Bitbucket'ta bu etiketteki kaynak.
Sürüm Notları
Depo'nuzda bir etiket için bir sürüm yayınlarsanız, notlar alınır ve dağıtıma eklenir, böylece Releases sekmesi iki kopya tutmak yerine depo'da yazdığınız aynı metni taşır.
Bu, depo'yu sürüm notlarını yazmanın tek yeri yapar. Bunları bir kez yazın, katkıda bulunanlarınızın zaten bulunduğu yerde ve buraya gösterilir.
Etiket Başına Bir Sürüm
Liste etiket tarafından çoğaltılmayan: bir etiket birden fazla kez dağıtılmışsa, örneğin ilk yapı başarısız oldu ve yeniden denediğiniz için, o etiket için yalnızca en son dağıtım gösterilir.
Üstteki sayaç toplamı verir ve liste, projenin tüm geçmişi yerine son etiketli dağıtımların geniş bir penceresini kapsar.
Sürümleri İyi Kullanmak
Dal'a değil, birleştirme'ye etiket yapın. Gerçekten üretim dalınızda olan commit'i etiketleyin. Birleştirilmemiş bir özellik dalı commit'ini etiketlemek, main'de bir şeye karşılık gelmeyen bir sürüm üretir.
Anlamsal sürümleri kullanın. Doğru şekilde sırralanırlar, sürüm şeklinde tanınırlar ve herkes zaten bunları nasıl okuyacağını bilir.
Bir etiketi asla taşımayın. Mevcut bir etiketi yeni bir commit'e yeniden göstermek, bu listedeki sürümün ve depo'daki etiketin artık ne sevk edildiği konusunda anlaşmazlık olduğu anlamına gelir. Bunun yerine yeni bir yama sürümü kesin.
Bir etiket gitmek şablonunuzla eşleşirse doğrudan üretim'e dağıtır. Başka hiçbir şeyi geçmez: dağıtım kilitler, onay gereksinimleri ve dondurma pencereleri yapılandırıldığı şekilde geçerli kalır. Ancak yanlışlıkla gitmek bir sürüm draftı değil, üretim dağıtımı olduğu anlamına gelir. Kullanılabilir kapılar için Projenizi Dağıtma bölümüne bakın.
Bir Sürümü Geri Almak
Sürümler dağıtımlardır, bu nedenle bir taneyi geri almak sıradan geri alma akışıdır: dağıtımı açın ve önceki başarılı olanı geri yükleyin. Dağıtımı Geri Alma bölümüne bakın.
Bundan sonra, kötü olanı silmek yerine düzeltme için yeni bir etiket kesin. Başarısız sürümün geçmişte görünür kalması yararlı bilgidir, müll değildir.
Sorun Giderme
Bir etiket gitmek edildi ancak sürüm görünmedi. Settings'deki şablonu kontrol edin, sonra etiketi uzak'a ulaştığını kontrol edin. git push origin v1.4.0 bir etiketi gitmek eder; tek başına git push hiçbirini gitmek etmez.
Sürüm Başarısız oldu. Yapı başarısız oldu, dal gitmek'i yaptığı gibi tam olarak. Dağıtımı açın ve günlüğü okuyun: Yapı Günlüklerini Okumak.
View on bağlantısı eksik. Projenin bağlantılı depo'su olmadığından, bağlantı kurulacak yer yok. Bir tanesini bağlayın: GitHub Depo'sunu Bağlama bölümüne bakın.
El ile etiketlenmiş dağıtım listelenmedi. Etiket sürüm şeklinde değil. Bunu v1.4.0 gibi bir şeye yeniden adlandırın.
Sürüm notları boş. Notlar depo'nizde yayınlanan bir sürümden çekilir. Sürüm nesnesi olmayan çıplak bir etiketin çekilecek notları yok.
Nereye Gitmek İçin
- Projenizi Dağıtma tam dağıtım döngüsü ve kapıları için.
- Dağıtımı Geri Alma sürüm yanlış gittiğinde.
- Orbit Zaman Çizelgesi Ek Açıklamaları bir sürümün neleri değiştirdiğini kaydetmek için.