ccam'i güncelleme

ccam update, GitHub'dan bir ccam sürümü indirir, onu sürümün checksums.txt dosyasıyla doğrular ve çalışan ikili dosyayı tek bir yeniden adlandırmayla değiştirir. ccam'i kurulum betiğiyle veya bir arşivden kurduysanız kullanın. ccam güncellemeleri hiçbir zaman kendiliğinden kontrol etmez: GitHub ile yalnızca bu komut bağlantı kurar; bu yüzden diğer tüm komutlar çevrimdışı da aynı şekilde çalışır.

Kullanım

ccam update                    # install the latest release
ccam update --check            # only say whether a newer release exists
ccam update --version v0.3.0   # install that release, also an older one
ccam --dry-run update          # show what would be downloaded and replaced

$ ccam update --check
ccam 0.5.0 is available (you have 0.4.0). Run `ccam update`.
$ ccam --dry-run update
Would update ccam 0.4.0 → 0.5.0:
  download  https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/ccam_linux_amd64.tar.gz
  verify    with https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/checksums.txt
  replace   /home/you/.local/bin/ccam
$ ccam update
→ downloading https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/ccam_linux_amd64.tar.gz
✓ Updated ccam 0.4.0 → 0.5.0 (/home/you/.local/bin/ccam)

Daha yeni bir sürüm yoksa ccam ccam 0.4.0 is up to date. yazdırır ve hiçbir şeyi değiştirmez. --version ile zaten çalıştırdığınız sürümü verirseniz ccam 0.4.0 is already installed. yazdırır.

Seçenekler

--check ve --version birlikte kullanılamaz. Etiket, isteğe bağlı bir ön sürüm veya derleme sonekiyle vMAJOR.MINOR.PATCH biçiminde olmalıdır; baştaki v yazılmayabilir. Başka her şey başarısız olur, örneğin --version takes a release tag such as v0.3.0, not "1.2".

CCAM_RELEASES_URL ortam değişkeni, bir yansı veya testler için https://github.com/jhyunwoo/ccam/releases adresinin yerini alır. Aynı şekilde düzenlenmiş olmalıdır: <url>/latest, <url>/tag/<tag> adresine yönlendirir ve dosyalar <url>/download/<tag>/<asset> konumundadır.

Nasıl çalışır

Kod, yalnızca ccam update komutunun içe aktardığı internal/update içindedir. Başlatma yolu onu hiçbir zaman çağırmaz.

1. cli.updateCmd, çalışan ikili dosyayı os.Executable ile bulur ve sembolik bağlantıları filepath.EvalSymlinks ile çözümler. Değiştirilen, bu gerçek yoldur.
2. --version olmadan Updater.Latest, yönlendirmeyi izlemeden <releases>/latest adresini ister ve etiketi Location başlığından okur (…/tag/v0.5.0). Bu, GitHub API'si yerine sürümler sayfasını kullanır; böylece API'nin saatte 60 istek sınırı uygulanmaz. Aramanın 10 saniyesi vardır.
3. parseVersion, etiketi katı bir kalıba göre kontrol eder. Etiket, indirme URL'lerinde ve yazdırılan bir kabuk komutunda yer alır; bu yüzden /, %, boşluk veya kabuk karakterleri içeren hiçbir şey geçemez. compareVersions onu çalışan sürümle karşılaştırır; bir ön sürüm, kendi sürümünden önce sıralanır.
4. managed() ve writable(), ccam'in ikili dosyayı değiştirip değiştiremeyeceğine karar verir (aşağıya bakın).
5. Updater.Fetch, ccam_<os>_<arch>.tar.gz ve checksums.txt dosyalarını aynı anda, ikisi için toplam 2 dakikayla indirir. Her indirme 256 MB ile sınırlıdır.
6. Başka herhangi bir şey olmadan önce arşivin SHA-256 değeri checksums.txt içindeki satırıyla eşleşmelidir. Eksik bir satır veya farklı bir sağlama toplamı güncellemeyi nothing was changed ile durdurur.
7. extract() tar dosyasını okur ve ccam adlı ilk normal dosyayı alır. Klasörler, bağlantılar ve diğer girdiler yok sayılır; ikili dosya da 256 MB ile sınırlıdır.
8. Updater.Install, yeni ikili dosyayı fsutil.AtomicWrite ile yazar: ikili dosyanın yanında, eski dosyanın izin bitlerine sahip geçici bir .ccam.tmp* dosyası diske yazılır ve eskisinin üzerine yeniden adlandırılır.

Etiket aramasından yeniden adlandırmaya kadar tüm akış:

Arşiv ve checksums.txt yan yana indirilir ve sağlama toplamı eşleşene kadar hiçbir şey yazılmaz. Yeniden adlandırma atomiktir; bu yüzden bir çökme veya dolu bir disk ya eski ikili dosyayı ya da yenisini bırakır, hiçbir zaman yarım bir dosya bırakmaz. ~/.local/bin/ccwork gibi kısayol komutları ccam ikili dosyasına giden sembolik bağlantılardır; bu yüzden hiçbir değişiklik olmadan yeni sürümü çalıştırırlar.

Paket yöneticisiyle yapılan kurulumlar

.deb paketinden kurulan bir ccam apt'ye aittir ve onu apt'nin haberi olmadan değiştirmek paket veritabanını yanlış bırakır. İndirmeden önce ccam ikili dosyanın kime ait olduğunu kontrol eder:

1. /usr/bin, /bin, /usr/sbin veya /sbin içindeki bir ikili dosya paket yöneticisine ait sayılır.
2. Başka bir yerdeyse, dpkg kuruluysa ve dpkg -S <path> başarılı olursa yine paket yöneticisine ait sayılır.
3. Aksi halde ccam, oraya yazabildiğinden emin olmak için ikili dosyanın yanında geçici bir .ccam-update-* dosyası oluşturur ve kaldırır.

Paket yöneticisine ait bir ikili dosyada ccam durur ve apt adımlarını yazdırır:

$ ccam update
ccam: /usr/bin/ccam was installed by a package, so `ccam update` leaves it alone.
To update the .deb, download ccam_0.5.0_linux_amd64.deb from https://github.com/jhyunwoo/ccam/releases/tag/v0.5.0 and run:
  sudo apt install ./ccam_0.5.0_linux_amd64.deb
Or install a copy in ~/.local/bin with the install script:
  curl -fsSL https://raw.githubusercontent.com/jhyunwoo/ccam/main/install.sh | sh

Linux dışındaki sistemlerde yalnızca kurulum betiği satırı yazdırılır. Klasör yazılabilir değilse ccam, ccam'i ~/.local/bin içine kuran kurulum betiğini yeniden çalıştırmayı önerir.

Güvenlik ve uç durumlar

• Bir geliştirme derlemesi sürümünü dev olarak bildirir ve karşılaştırılacak bir sürümü yoktur; bu yüzden ccam update ve ccam update --check onu reddeder. ccam update --version vX.Y.Z onun üzerine bir sürüm kurar.
• Başarısız bir indirme, platformunuz için eksik bir dosya veya sağlama toplamı uyuşmazlığı kurulu ikili dosyayı olduğu gibi bırakır.
• Var olmayan bir sürüm there is no release <tag> ile başarısız olur. GitHub HTTP 403 veya 429 ile reddettiğinde ccam bunun muhtemelen bir istek sınırı olduğunu söyler ve daha sonra yeniden denemenizi ister.
• --check yalnızca okur. İkili dosyanın paket yöneticisine ait veya yazılabilir olup olmadığını kontrol etmez.
• Daha eski bir etiketle --version, geri dönmenin yoludur.

İlgili

• Kurulum
• Komutlar
• SSS