Uzantı yayınla

Azure Geliştirici CLI (azd) uzantısını derledikten sonra, başkalarının yükleyebilmesi için bu uzantıyı paketleyip bir kayıt defterinde yayımlayın. Bu makalede, Örnek uzantı oluşturma hızlı başlangıç kılavuzunda yer alan Contoso Resource Tagger örnek uzantısını nasıl yayımlayacağınız gösterilir. Herhangi bir uzantıya aynı adımları uygulayabilirsiniz.

Note

azd Uzantı çerçevesi genel olarak kullanılabilir. Tek tek uzantıların veya özelliklerin kendi önizleme durumları olabilir.

Kayıt defteri seçme

azd resmi kayıt defterinden, özel URL tabanlı kayıt defteri bildirimlerinden, dosya tabanlı kayıt defteri bildirimlerinden ve taşınabilir paket dosyalarından uzantıları çözebilir. Kullanıcıların uzantınızı yükleme şekliyle eşleşen dağıtım yaklaşımını seçin:

  • Resmi kayıt defteri: azdile birlikte gelen kayıt defteri. Burada yayımlamak için azure/azure-dev deposunun bir çatalına pull request gönderin.
  • Özel URL tabanlı kayıt defteri: Ekibinizin genel veya özel dağıtım için barındırdığı bir uzak kayıt defteri bildirimi.
  • Dosya tabanlı kayıt defteri: Geliştirme, test, çevrimdışı kullanım veya özel dağıtım için yerel kayıt defteri bildirimi.
  • Geliştirme veya gecelik kayıt defteri: Devam eden veya otomatik olarak oluşturulan birinci taraf uzantıları için kabul kayıt defteri. Geliştirme kayıt defterindeki uzantılar imzalanmamıştır, Azure desteği kapsamında değildir ve bildirimde bulunmaksızın değiştirilebilir veya kaldırılabilir.
  • Taşınabilir paket: Kullanıcıların kayıt defteri kaynağı eklemeden doğrudan yerel bir yoldan veya HTTPS URL'sinden yükleyebilecekleri bağımsız .zip paket.

Bu makalede, paylaşılan bir test kaynağında yayımlamayı göstermek için geliştirme kayıt defteri kullanılır. Kaynak ve sürüm çözümleme ayrıntıları için bkz. Uzantı çerçevesi başvurusu.

Prerequisites

  • Örnek uzantı oluşturma hızlı başlangıcından tamamlanmış bir uzantı.
  • azd geliştirici uzantısı (microsoft.azd.extensions); paketleme ve yayımlama için kullanılan azd x komutlarını sağlar. Hızlı başlangıcı tamamladıysanız zaten yüklüdür. Aksi takdirde komutunu çalıştırın azd extension install microsoft.azd.extensions.
  • Yayın yapıtlarını barındırmak için bir GitHub hesabı ve bir depo.
  • repo kapsamına sahip bir GitHub kişisel erişim belirteci (PAT). release komutu, GitHub yayınları oluşturmak ve yapıtları karşıya yüklemek için bu belirteci kullanır. Daha fazla bilgi için bkz. Kişisel erişim belirteçlerinizi yönetme.

Sürümü ve değişiklik günlüğü güncelleştirme

Yayımlamadan önce sürümü güncelleştirin ve değişikliklerinizi belgeleyin:

  1. version’e uygun olarak, extension.yaml içindeki özelliğini güncelleştirin. Değişikliğin türüne göre ana, ikincil veya yama sürümü numarasını artırın.

  2. CHANGELOG.md öğesini bu sürümdeki öne çıkan değişikliklerle güncelleyin. azd sürüm notları oluşturmak için değişiklik günlüğü kullanır.

Uzantıyı paketleme

Platforma azd x pack özgü ikili dosyalar oluşturmak ve uzantıyı paketlemek için komutunu kullanın:

azd x pack

komutu, çıkış dizininizde desteklenen her platform için yapıtlar oluşturur. azd x release bu yapıtları karşıya yükler ve azd x publish kayıt defteri meta verilerini güncelleştirir. Paketleme ayrıca, yayımlamadan önce uzantının beklendiği gibi davrandığını doğrulamak için anlık görüntü testleri de çalıştırır.

Bir uzantıyı kayıt defteri aracılığıyla yayımlamak yerine doğrudan dağıtmak istiyorsanız, ile azd x pack --bundlekendi içinde bir paket oluşturun. Paket, bir dosya yolundan veya HTTPS URL'sinden yükleme için gereken kayıt defteri meta verilerini ve yapıtlarını içeren taşınabilir .zip bir pakettir.

Uzantıyı yayınla

Paketlenmiş yapıtları yüklemek ve bir GitHub sürümü oluşturmak için azd x release komutunu kullanın. komutun yayını oluşturabilmesi için GitHub PAT'nizi sağlayın:

azd x release

Komut, GitHub deponuzda bir sürüm oluşturur, paketlenmiş ikili dosyaları karşıya yükler ve değişiklik günlüğünüzden sürüm notları oluşturur. Kayıt defteri tabanlı yayımlama, indirilebilir uzantı paketleri olarak bu yayın yapıtlarını kullanır. Paketi GitHub barındırmak istemediğiniz sürece doğrudan paket dağıtımı bu sürüm adımını gerektirmez.

Tip

GitHub PAT'nizi komut satırına geçirmek yerine bir ortam değişkeninde depolayın. Desteklenen kimlik doğrulama seçenekleri için komutunu çalıştırarak azd x release --help komut yardımını denetleyin.

Kayıt defterinde yayımlama

Uzantı kayıt defterine azd x publish uzantınızın girdisini eklemek veya güncelleştirmek için komutunu kullanın:

azd x publish

komutu, kullanıcıların uzantınızı geliştirme kayıt defterinden bulup yükleyebilmesi için kayıt defteri meta verilerini güncelleştirir. Bu adım, uzantıyı yalnızca makinenizdeki yerel bir kaynağa kaydeden hızlı başlangıçta gerçekleştirilen yerel yayımlamadan azd x init farklıdır. Çalıştırma azd x publish , diğer kullanıcıların uzantınızı yükleyebilmesi için paylaşılan geliştirme kayıt defterini güncelleştirir.

Yükleme ve doğrulama

Yayımladıktan sonra, başkalarının uzantınızı geliştirme kayıt defterinden yükleyebildiğini doğrulayın:

  1. Geliştirme kayıt defterini zaten eklediğinizden emin olun.

    azd extension source add -n dev -t url -l "https://aka.ms/azd/extensions/registry/dev"

  2. Uzantıyı kimliğine göre yükleyin.

    azd extension install contoso.azd.tagger

  3. Uzantının çalıştığını onaylamak için bir komut çalıştırın.

    azd tagger show

Resmi kayıt defterinde yayımlama

Resmi kayıt defterinde yayımlamak için uzantınızı azure/azure-dev deposuna gönderin:

  1. azure/azure-dev deposunu çatalla.
  2. Uzantınızın kayıt girdisini fork’unuzdaki resmî kayıt dosyasına ekleyin.
  3. İnceleme için bir pull isteği gönderin.

Azure Geliştirici CLI ekibi, resmi kayıt defteri gönderimlerini birleştirmeden önce kalite ve güvenlik açısından inceler.

Yayımlama sorunlarını giderme

Aşağıdaki tabloda yaygın yayımlama sorunları ve bunların çözümleri listelenir:

Issue Çözünürlük
Sürüm bir kimlik doğrulama hatasıyla başarısız oluyor GitHub PAT'nizin geçerli olduğunu ve repo kapsamına sahip olduğunu doğrulayın.
Anlık görüntü testleri şu sırada başarısız olur: azd x pack Test çıkışını gözden geçirin, değişiklikler bekleniyorsa anlık görüntülerinizi güncelleştirin ve komutu yeniden çalıştırın.
Kullanıcılar uzantınızı bulamıyor Geliştirme kayıt defterinin eklendiğini ve azd x publish işleminin başarıyla tamamlandığını onaylayın.
Yayımlama sırasında sürüm çakışması version içindeki extension.yaml değerini yeni ve kullanılmayan bir sürüme artırın.

İlgili içerik

  • Last updated on