Ana içeriğe geç

Marketplace paketi yayınla

Bir helm chart'ı marketplace UI'sından yüklenebilir hale getirin. x-form-schemas ile opsiyonel tipli install formu.

Bunu kim yapabilir​

  • Org'da marketplace:create izni olan herkes. Varsayılan developer ve admin rolleri sahip.
  • Globally-shared paketler için sadece super-admin'ler Admin → Marketplace üzerinden ve sadece lisans MaxPublicMarketplacePackages > 0 taşıdığında.

Paket ekle​

Sidebar → Marketplace → Add Package.

Doldurun:

  • Name + slug — slug name'den otomatik üretilir; gerekirse düzenleyin. Slug stabil URL parçası.
  • Description + icon URL — kataloğda kullanıcıların gördüğü
  • Categories — global taxonomy'den multi-select. Kullanıcıların paketi bulmasına yardım eder. Chart'ın alanı için tag ekleyin (networking, storage, observability, …).

Chart kaynağı​

İki kaynak çeşidi:

  • Kayıtlı registry'den — org'un registry'lerinden birini dropdown'dan seçin, chart adını yazın (registry URL prefix'i olmadan). DT Edge Platform chart_ref'i registry URL + chart adından inşa eder. Önerilen.
  • Manuel girilen chart_ref — tam olarak kaydetmek istemediğiniz bir-defalık public-repo chart'ları için. Tam chart referansını yazın (örn: oci://public-charts.example.com/foo). Registry alanı boş kalır.

Kaydedin. Paket org'un marketplace'inde 0 versiyon ile belirir.

Sürüm ekle​

Pakete girin → Versions sekmesi → Add version.

  • Version — semver (örn: 1.2.3). Install drawer'ının sürüm dropdown'unda görünür.
  • Chart version — chart'ın helm sürümü. Genelde Version'a eşittir; downstream variant paketlediğinizde farklılaşır.
  • Default values (YAML) — install'da kullanıcıların YAML editöründe pre-filled gördüğü. Boş tamam; helm chart'ın built-in varsayılanlarını kullanır.
  • Form schema (x-form-schemas, opsiyonel ama önerilen) — aşağıya bakın

Kaydedin. Sürüm install drawer'ında org'taki herkes için hemen belirir.

x-form-schemas — tipli install formları​

Kullanıcıların hand-edited YAML yerine dostane bir formla install etmesini istiyorsanız default values içine bir x-form-schemas bloğu gömün:

x-form-schemas:
  schema:
    type: object
    properties:
      replicaCount:
        type: integer
        title: Replicas
        minimum: 1
        default: 2
      image:
        type: object
        properties:
          tag:
            type: string
            title: Image Tag
            default: "1.2.3"
  ui:
    replicaCount: { ui:widget: number }

DT Edge Platform UI bunu install'da okur, label + validasyon ile tipli inputlar render eder ve sonucu submit'te values.yaml'a serialize eder. JSON Schema (Draft 7) desteklenir, ek olarak widget'lar için (number / password / textarea / select / radio / checkbox) küçük bir ui: extension'ı.

x-form-schemas yoksa install drawer'ı sadece YAML editör'ünü gösterir.

Image registry'leri (extra)​

Chart'ınız kendi chart registry'sinden başka registry'lerden de image çekiyorsa onları pakete bağlayın:

  • Paket detay → Image Registries sekmesi → Add
  • Org'un is_image_registry=true registry'lerinden seçin

Install zamanında DT Edge Platform bunların hepsinin cred'lerini namespace'e wire eder (chart'ın kendi registry'siyle de union yapar eğer o da image registry ise, ve install request'in açıkça taşıdığı image_registry_ids'lerle de).

Düzenle / sil​

Aynı paket satırı aksiyon menüsünde:

  • Edit — name / slug / description / icon / categories / source değiştir
  • Delete — bu paketin chart_ref'ine başvuran aktif release varsa reddeder; önce Applications listesini kontrol edin

Per-version düzenlemeler Versions sekmesinden. Mevcut release'lerin pin'lediği bir sürümü silmeye izin verilir — o release'ler çalışmaya devam eder ama o sürüme tekrar install veya upgrade-to edemezsiniz.

Görünürlük​

  • Org-scoped paketler — sadece org üyeleri görür
  • Globally shared paketler — super-admin Admin → Marketplace üzerinden yayınlar. Admin UI'da sadece lisans MaxPublicMarketplacePackages > 0 taşıdığında yüzeylenir.

Bir chart'ın bu kurulumdaki her org tarafından kullanılabilir olmasını istiyorsanız her org'un kendi kopyasını yayınlaması yerine admin'den globally yayınlamasını isteyin.

Yaygın hatalar​

  • Slug already in use — farklı slug seçin; org-scoped paketler için org-başına unique
  • Yayın anında chart not found — DT Edge Platform kaydederken registry'yi opsiyonel olarak prob eder; başarısızlık chart_ref
    • version'un erişilemez olduğu anlamına gelir. Registry cred'lerini, chart adını, version pin'i kontrol edin
  • YAML schema validation failed — x-form-schemas bloğunuz JSON Schema olarak parse olmuyor. Hata mesajı sorunlu path'ı içerir.

Ayrıca bakın​