Oturum açınToplantı planlayın

Bölüm 2.7

Enterprise sürümünü kurma ve lisans uygulama

Enterprise sürümünü kurduğunuzda nelerin değiştiği, Adverant hesabınızdan nasıl lisans talep edeceğiniz, tüm ret kodlarıyla birlikte lisansı içe aktarmanın üç yolu ve Harrow Port Authority'nin Community pilot kurulumunu hiçbir veri kaybetmeden yerinde Enterprise sürümüne nasıl taşıdığı.

Bu sayfa, İngilizce aslından YZ tarafından çevrilmiştir. Anlaşılmayan bir yer olursa İngilizce sayfa esas alınır. Bu sayfayı İngilizce okuyun

17 dakikalık okuma

Bir Enterprise kurulumunun iki yarısı vardır ve bunlar farklı yollardan gelir. Enterprise imajları, bir çekme belirteci (pull token) ile çekilen Enterprise chart'ı ile birlikte gelir. Lisans, Adverant hesabınızdan imzalı bir dosya olarak gelir ve onu çalışan kuruluma içe aktarırsınız. İki yarı da diğeri olmadan çalışmaz: lisanssız imajlar Community tabanında çalışır ve Enterprise imajları olmayan bir lisansın etkinleştireceği hiçbir şey yoktur.

Harrow Port Authority'de bunu bu sırayla, bölüm 2.6, Community'yi Kubernetes Üzerine Kurma içindeki Community pilot uygulamasından altı hafta sonra yaptık. Enterprise chart'ına yükseltme bir bakım penceresi sürdü; lisansın içe aktarılması iki dakika aldı. Bu bölüm her iki yarıyı da kapsar. Sıfırdan bir kurulumla başlar ve mevcut bir Community kurulumunun yerinde taşınmasıyla sona erer.

Sağdaki "Enterprise kurulumu" etiketli tek bir kutuyu besleyen iki paralel şerit. Üst şerit: "Adverant hesabı: İndirilenler", "Enterprise chart'ı ve imaj kilidi"ne, ardından kendisine bağlı "her düğümde çekme belirteci" yan kutusuyla birlikte "helm install veya helm upgrade, edition: enterprise"a gider. Alt şerit: "Adverant hesabı: Dağıtımlar", "imzalı lisans dosyası"na, ardından "çalışan kuruluma içe aktar"a gider. Her iki şerit de sağdaki kutuda buluşur. Altındaki altyazı satırında "lisanssız imajlar Community tabanında çalışır" yazar.
Bir Enterprise kurulumunun iki yarısı ve her birinin nereden geldiği.

Community sürümünden farkları

İki değer ve bunları okuyan chart.

# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
  enabled: true

Değerler dosyasındaki diğer her şey, başta kurulum adı ve emanetçiler (custodians) olmak üzere olduğu gibi kalır. İki anahtar birbiriyle uyuşmalıdır; chart, enterprise.enabled: false ile edition: enterprise kullanımını veya tam tersini reddeder.

Sürüm (edition) ayrıca chart'ın imaj kilidiyle de uyuşmalıdır. Her chart paketi tek bir sürümün kilidini taşır ve Enterprise kilidi, Community imajlarına ek olarak Enterprise derlemelerini listeler. Bir Enterprise değerler dosyasını Community chart'ına yönlendirirseniz, oluşturma işlemi (render) files/images.lock.json is the community lock; this install is edition enterprise ile durur. Dolayısıyla Enterprise kurulumu, Enterprise chart'ına ihtiyaç duyar.

Enterprise chart'ı ve paketi, lisansınızı takip eden Adverant hesabınızın İndirilenler (Downloads) sayfasındadır. Chart dosyası Community ile aynı ada (nexus-1.0.0-alpha.1.tgz) sahiptir, bu nedenle ikisini ayrı klasörlerde tutun. Parmak izini kontrol ettiğiniz sürüm anahtarına karşı, bölüm 2.4, Bir sürümü edinme ve doğrulama içinde açıklandığı gibi tam olarak kontrol edin:

nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json
1.0.0-alpha.1
enterprise

Ardından enterprise/nexus/files/images.lock.json üzerinde bölüm 2.4, Bir sürümü edinme ve doğrulama içindeki imza döngüsünü çalıştırın. Bu işlem, ortak imajların yanı sıra Enterprise imajlarını da kapsar.

Çekme belirteci (pull token)

Community imajları herkese açıktır. Enterprise imajları, bölüm 2.4, Bir sürümü edinme ve doğrulama, adım 3'te gösterildiği gibi düğümlerinizin kapsayıcı çalışma zamanı (container runtime) için yapılandırılmış, hesabınızın Çekme belirteçleri ve kurulum komutları (Pull tokens and install commands) sayfasından alınan bir çekme belirtecine ihtiyaç duyar. k3s üzerinde bu, her düğümdeki /etc/rancher/k3s/registries.yaml içinde registry.adverant.ai için bir configs girdisidir.

Küme başına bir belirteç oluşturun ve fark edeceğiniz bir bitiş tarihi verin. Bir belirtecin süresi dolduğunda, çalışan pod'lar devam eder, ancak henüz imaja sahip olmayan bir düğüme yeniden planlanan bir pod imajı çekemez. Biz belirtecin bitiş tarihini sertifikanınkiyle aynı takvime koyduk.

Temiz bir Enterprise kurulumu

Enterprise'ı baştan kuruyorsanız, bölüm 2.6, Community'yi Kubernetes Üzerine Kurma adımlarını üç farkla adım adım izleyin:

  1. Adım 6'dan önce çekme belirtecini her düğüme yerleştirin.

  2. Adım 4'te Enterprise değerlerini (yukarıdaki iki anahtar) kullanın.

  3. Adım 6'da, indirdiğiniz Enterprise chart dosyasından kurulum yapın:

    helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

Kurulum komutundan sonraki her şey bölüm 2.6, Community'yi Kubernetes Üzerine Kurma ile aynıdır ve --wait hakkındaki kural da öyledir: onu kullanmayın. Bunun yerine nexusctl ile kurulum yaparsanız, komuta --edition enterprise ekleyin:

nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterprise

Her iş yükü hazır olduğunda, bölüm 2.12, İlk çalıştırma içindeki ilk çalıştırma adımlarını tamamlayın. Lisans, herhangi biri oturum açmadan önce konsolun listelediği altı şeyden biridir. İçe aktarılana kadar kurulum Community tabanında çalışır ve her Enterprise alanı kilit simgesiyle grileşmiş olarak gösterilir.

Lisans talep etme

Adverant'tan alınan bir lisans, tek bir kurulumun kimliği için—anahtar deposunun kurulum sırasında keys.installationName altında ürettiği kimlik için—düzenlenir. Bu nedenle hesap, bir lisans düzenlemeden önce hangi kurulumu kastettiğinizi bilmelidir.

  1. https://account.adverant.ai adresinden Adverant hesabınızda oturum açın.
  2. Kurulumda, Bu kurulum (This installation) ve ardından Lisans (Licence) bölümünü açın. Burada tek kullanımlık bir kod ve kurulumun parmak izi gösterilir.
  3. Hesabınızda, Bir dağıtımı sahiplen (Claim a deployment) bölümünü açın ve kodu girin. Ardından hesabın aldığı parmak izini kurulumun gösterdiği parmak iziyle grup grup karşılaştırın; her grup eşleşmelidir.
  4. Sahiplen düğmesine basın. Kurulum, sürümü ve lisans durumuyla birlikte hesabınızın Dağıtımlar (Deployments) bölümüne katılır.
  5. Adverant, o kurulum için lisansı düzenler. Dosyayı hesabınızdan indirin; lisans kimliğine göre <licence-id>.json olarak adlandırılmıştır.

Bir sahiplenme kodu bir kez ve kısa bir süre için çalışır. Süresi dolarsa, hesap onu CLAIM_CODE_EXPIRED ile reddeder ve kurulum yeni bir kod gösterir.

Bir dağıtımı sahiplen
Bir dağıtımı sahiplen
Adverant hesabında bir dağıtımı sahiplenme. Önce tek kullanımlık kod girilir, ardından parmak izi dörtlü gruplar halinde karşılaştırılır, böylece kimse başında durmadığı bir kurulumu sahiplenemez.

İki yol daha vardır ve bölüm 2.13, Lisanslar, her ikisini de tam olarak kapsar. Donanım cihazlarının (appliances) ve uç kitlerin (edge kits) kod gösterecek bir ekranı yoktur; bu nedenle kutunun üzerine basılmış bir sahiplenme anahtarıyla, Bir sahiplenme anahtarı girin (Enter a claim key) bölümüne yazılarak veya üreticinin sipariş dosyasından okunarak sahiplenilirler. Dışarıya çıkışı olmayan bir kurulum Çevrimdışı değişimi (Offline exchange) kullanır: imzalı bir lisans istek dosyası oluşturur, bunu hesabınıza taşırsınız ve lisans dosyasını geri getirirsiniz. Yılda bir kez aynı şekilde imzalı bir kullanım beyanı oluşturur. Değişimdeki her dosya imzalıdır, bu nedenle yolda değiştirilen bir dosya, istek için LICENCE_REQUEST_SIGNATURE_INVALID ve kullanım dosyası için USAGE_FILE_SIGNATURE_INVALID ile reddedilir.

Çevrimdışı değişim
Çevrimdışı değişim
Adverant hesabında çevrimdışı değişim. İmzalı dosyalar her iki yönde elden taşınır ve yolda değiştirilen bir dosya adıyla reddedilir.

Lisans dosyası ne içerir

Lisans, Adverant tarafından iki bağımsız anahtarla iki kez imzalanmış, nexus-licence/v1 biçiminde bir JSON belgesidir. Onu okumanıza gerek yoktur, ancak birisi ne satın aldığınızı sorduğunda içinde ne olduğunu bilmek işe yarar.

Alan Ne söyler
licence_id Lisansın kendi kimliği, küçük harfli bir UUID (evrensel benzersiz tanımlayıcı)
type alpha, evaluation veya commercial
licensee Kuruluşun adı ve Adverant müşteri kimliği
scope Ait olduğu kurulum ve bir tahsisin (grant) belirttiği kuruluşlar
edition enterprise
grants Kilidini açtığı özellik grupları; her biri tüm kurulum için veya belirtilen kuruluşlar için
add_ons ve domain_packs Ayrı olarak lisanslanan yetenekler; Lojistik ve denizcilik paketi bunlardan biridir
metric Lisansın nasıl sayıldığı (named-seat, per-core veya per-environment) ve miktarı
term starts_on, ends_on ve uyarı ile ek süre (grace) günleri
matrix Yazıldığı sürüm matrisinin versiyonu
signatures Adverant'ın iki imzası

Bir değerlendirme lisansı ek süre olmaksızın en fazla beş adlı kişi için en fazla 30 gün sürer. Ticari bir lisans, bitmeden 30 gün önce uyarır ve ardından varsayılan olarak 30 gün ek süre verir. Bu merdivenin her basamağında ne olduğu bölüm 2.13, Lisanslar içindedir.

İmzalar, belgeyi Adverant'ın oluşturduğu haliyle kapsar. Tam olarak aldığınız gibi gönderin; belgeyi düzenleyip biçimlendirebilecek bir metin düzenleyicide açmayın.

Lisansı içe aktarma

Yalnızca bir kurulum yöneticisi lisans içe aktarabilir: kuruluma sahip olan tüm kuruluşun sahibi veya yöneticisi, oturum açmış durumdayken. Tam yetkili bir platform yöneticisi de içe aktarabilir. Lisans hiçbir zaman bir chart değeri veya bir pod'a bağlanmış bir dosya değildir. Kendi imajına yerleşik güven köklerine karşı çevrimdışı olarak kontrol eden ve tek bir işlemde kaydeden oturum açma hizmetine, yani nexus-auth hizmetine gider. Üç yolla içe aktarabilirsiniz ve hepsi aynı yerde son bulur.

Konsolda

İlk çalıştırma sırasında, Kimse oturum açmadan önce altı şey (Six things before anyone signs in), ardından Lisans (Licence) bölümünü açın. Lisansı içe aktar (Import the licence) sayfası dosyayı alır: sayfaya bırakın veya seçin. Sayfa, dosyayı bizzat kurulum üzerinde çevrimdışı olarak kontrol eder, ardından açtığı özellik gruplarını, her birinin nasıl korunduğu ve ne zamana kadar geçerli olduğuyla birlikte listeler. Lisansın içermediği gruplar grileşmiş olarak listede kalır.

Daha sonra aynı içe aktarma işlemi, kurulumun lisans sayfasındaki Yeni bir lisans içe aktar düğmesidir. Bir lisansın süresi dolduğunda, kısıtlanmış lisans sayfası Yenilenmiş bir lisans içe aktar seçeneğini sunar.

Lisansı içe aktar
Lisansı içe aktar
Konsolda lisansı içe aktarma. Dosya bizzat kurulum üzerinde kontrol edilir; sayfa kilidini açtığı şeyleri özellik grubuna göre listeler ve imza kontrolünden geçemeyen bir dosya, koduyla birlikte yok sayılır.

nexusctl ile

nexusctl licence import <licence-id>.json

nexusctl, dosyayı değiştirmeden bir kurulum yöneticisi olarak kurulumun içe aktarma rotasına gönderir ve lisansın durumunu veya aşağıdaki tablodan ret kodunu bildirir.

API aracılığıyla

İçe aktarma rotası, hosts.auth adresinizdeki oturum açma hizmetinin uygulama programlama arayüzünün (API) bir parçasıdır. Gövde (body), bayt bayt lisans belgesidir:

curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "authorization: Bearer <admin-token>" \
  -H "content-type: application/json" \
  --data-binary @<licence-id>.json

<admin-token>, oturum açmış bir kurulum yöneticisinin erişim belirtecidir. Satır sonlarını kaldıran ve dolayısıyla gönderdiğiniz baytları değiştiren -d yerine her zaman --data-binary kullanın. Rota hiçbir sorgu dizesi (query string) ve gövdede belgeden başka hiçbir şey almaz; en üst düzeyinde bir kuruluşu veya kişiyi belirtmeye çalışan bir gövde, hiçbir şey okunmadan önce reddedilir.

Başarılı bir içe aktarma 201 Created yanıtını verir. Kısaltılmış haliyle gövde şöyle görünür:

{
  "licence": {
    "licence_id": "<licence-id>",
    "state": "licensed",
    "edition": "enterprise",
    "licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
    "term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
    "groups": ["enterprise-base", "..."]
  },
  "organizations": 1,
  "tenants_without_organisation": 0
}

organizations, kurulumda artık lisansa sahip olan kuruluşları sayar. tenants_without_organisation, lisansın belirttiği ancak bu kurulumun barındırmadığı kuruluşları sayar.

İçe aktarma reddedildiğinde

Reddedilen bir içe aktarma hiçbir şeyi değiştirmez: hiçbir satır yazılmaz ve yürürlükte bir lisans varsa olduğu gibi kalır. Kurulumun denetim günlüğü, reddedilenler de dahil olmak üzere her girişimi kaydeder.

Kod Durum Anlamı Ne yapılmalı
LICENCE_SIGNATURE_INVALID 422 Adverant'ın iki imzasından biri eksik veya doğrulanamıyor; dosya imzalandıktan sonra değiştirilmiş Dosyayı Adverant'tan tekrar isteyin; düzenlemeyin
LICENCE_FORMAT_INVALID 422 Dosya, bu sürümün okuyabileceği bir lisans değil Dosyayı tam olarak Adverant'ın verdiği gibi gönderin
LICENCE_ROOT_UNKNOWN 422 Bu kurulumun güvenmediği bir anahtarla imzalanmış Bu sürümün güven kökleri için imzalanmış bir lisans isteyin veya yükseltin
LICENCE_MATRIX_MISMATCH 422 Bu sürümün okumadığı bir sürüm matrisine karşı yazılmış veya bu sürümün bilmediği bir gruba yetki veriyor Yükseltin veya bu sürüme karşı yazılmış bir lisans isteyin
LICENCE_OTHER_INSTALLATION 409 Başka bir kurulum için düzenlenmiş Bu kurulumun kimliği için düzenlenmiş bir lisans isteyin
TRANSITION_NOT_PERMITTED 409 Bu kimliğe sahip bir lisans zaten içe aktarılmış; her biri bir kez içe aktarılır Koşulların değişmesi gerekiyorsa Adverant'tan yeni bir lisans isteyin
LICENCE_REVOKED 403 Adverant bu lisansı geri çekmiş Adverant'tan yeni bir tane isteyin
LICENCE_LOCKED 403 Lisansın süresi henüz başlamamış; o zamana kadar Community tabanı geçerlidir İlk gününde veya sonrasında tekrar içe aktarın
RECORD_NOT_FOUND 404 Kurulum henüz bildirilmemiş, bu nedenle karşılaştırılacak bir kimliği yok İlk yöneticinin adımını (bölüm 2.12, İlk çalıştırma) tamamlayın, ardından içe aktarın
VALIDATION_FAILED 400 Gövde okunamıyordu veya 1 MiB'nin üzerindeydi ya da bir sorgu dizesi gönderildi Dosyayı sorgu olmadan tüm gövde olarak gönderin

Başarılı bir içe aktarmada, ret yerine bildirim olarak bir kod daha dönebilir: LICENCE_CLOCK_BEHIND_FLOOR, kurulumun saatinin daha önce gördüğü en son zamandan daha erken bir zamanı gösterdiği anlamına gelir, bu nedenle lisans o daha sonraki zamanda okunur. Saati geri almak süresi dolmuş bir lisansı asla canlandırmaz. Tabanı yalnızca Adverant'ın kurulum için imzaladığı bir zaman sıfırlama belirteci düşürür.

Community sürümünü yerinde Enterprise sürümüne taşıma

Harrow'da yaptığımız şey buydu. Hiçbir şey yeniden kurulmaz ve hiçbir şey taşınmaz: aynı kimliğe ve aynı verilere sahip aynı kurulumdur, yalnızca daha fazla kısmı etkinleştirilmiştir. Kurulum adı ve emanetçiler tam olarak oldukları gibi kalır; bir yükseltmede, emanet kancası (custody hook) anahtar deposunun zaten başlatılmış olduğunu kontrol eder ve başka hiçbir şey yapmaz.

  1. Çekme belirtecini her düğüme yerleştirin ve oradaki kapsayıcı çalışma zamanını yeniden başlatın.

  2. Enterprise chart'ını İndirilenler'den (Downloads) alın ve hem onu hem de imajlarını yukarıdaki gibi doğrulayın.

  3. Mevcut değerler dosyanızdaki iki değeri değiştirin: edition: enterprise ve enterprise.enabled: true. Başka hiçbir şeyi değiştirmeyin.

  4. Yeni dosyayla ön kontrolü (preflight) çalıştırın.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Sürümü, yine --wait olmadan Enterprise chart'ına yükseltin.

    helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

    Bir yükseltmede, kancalar (hooks) yeni pod'lar devreye girmeden önce çalışır ve her taşıma (migration) yalnızca daha önce uygulamadığı dosyaları uygular. Üretilen gizli bilgiler (secrets) kurulumdan geri okunur ve korunur. Helm şununla sona erer:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Tıpkı bölüm 2.6, Community'yi Kubernetes Üzerine Kurma, adım 7'deki gibi iş yüklerini bekleyin.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Yukarıdaki üç yoldan herhangi biriyle lisansı içe aktarın.

  8. Konsolda, Bu kurulum (This installation), ardından Lisans (Licence), ardından Enterprise'a Taşı (Move to Enterprise) bölümünü açın. Sayfa lisansı okur ve herhangi bir şey olmadan önce nelerin getirileceğini ve nelerin değişeceğini gösterir. Ayrıca kuruluşun kişilerini ve içeriğini sayar ve her birini korundu olarak işaretler. Getir ve etkinleştir düğmesine basın. Her parça kullanılmadan önce Adverant'ın sürüm anahtarına karşı kontrol edilir ve özellik grupları teker teker etkinleşir.

Penceremiz bir saatti; içindeki iş yaklaşık yirmi dakika sürdü ve bunun çoğu kancalar çalışırken geçen şema beklemesiydi. Pilot uygulamanın kişileri ertesi sabah, menünün Enterprise alanları artık gri olmadan aynı çalışma alanında oturum açtılar.

Community'den Enterprise'a
Community'den Enterprise'a
Bir Community kurulumunu Enterprise'a taşıma. Sayfa lisansın gerçek olduğunu doğrular ve herhangi bir şey getirilmeden önce nelerin getirileceğini listeler; kuruluşun kişileri ve dosyaları korundu olarak işaretlenir.

İçe aktarma işleminden sonra

Bu kurulum (This installation) altındaki lisans sayfası, lisanstaki her özellik grubunu koltuk sayısı ve süresiyle birlikte listeler. Ayrıca her parçanın nasıl sunulduğunu da belirtir; örneğin bir Enterprise grubu için derlenmiş ve lisanslanmış veya Community tabanı için açık kaynak. Lisansın dışındaki gruplar grileşmiş olarak listede kalır. Yöneticiler bir grubun kuruluş içinde eriştiği alanı daraltabilir; bir lisansın verdiği yetkiyi Adverant'tan başka kimse genişletemez.

Lisansın durumu her okumada belgeden ve tarihten yeniden hesaplanır, böylece süre dolumu zamanlanmış bir işe gerek kalmadan gerçekleşir. Kurulumdaki herkes, bitiş yaklaştıkça konsolda aynı bildirimi görür: bitişten 30 gün öncesinden itibaren LICENCE_ENDS_SOON, ardından ek süre boyunca LICENCE_IN_GRACE. Üyeler bildirimi ve tarihleri görür; yalnızca kurulum yöneticileri lisansın kendisini görür. Bölüm 2.13, Lisanslar, yenilemeyi ve süre dolumu merdivenini kapsar.

Lisans ve kilidini açtığı özellikler
Lisans ve kilidini açtığı özellikler
Bu, bir Enterprise kurulumunun lisans sayfasıdır. Üst kısımdaki rakamlar koltuk sayılarını ve süreyi verir; bunların altında her özellik grubu nasıl korunduğuyla birlikte listelenir ve lisansın dışındaki gruplar gri kalır.

Bu başarısız olursa

Gördüğünüz Neden Ne yapılmalı
edition=enterprise but enterprise.enabled=false: they must agree İki anahtardan yalnızca biri değiştirildi Her ikisini de değiştirin
files/images.lock.json is the community lock; this install is edition enterprise Community chart'ı kullanıldı İndirilenler'den (Downloads) alınan Enterprise chart'ını kullanın
image ... is a enterprise image; a community install takes only community images Bir Enterprise imaj adı bir Community oluşturma işlemine (render) ulaştı edition değerini ve chart klasörünü kontrol edin
Yükseltmeden sonra bir Enterprise imajında ImagePullBackOff Bir düğümde çekme belirteci yok veya belirtecin süresi dolmuş O düğümdeki registries.yaml dosyasını kontrol edin veya yeni bir belirteç oluşturun
Bir lisans ret kodu Yukarıdaki ret tablosuna bakın İlgili satırı izleyin; hiçbir şey değiştirilmedi

Lisans sayfası Enterprise'ı ve beklediğiniz grupları gösterdiğinde kurulum lisanslanmıştır. Kurulumu henüz sahiplenmediyseniz bir sonraki durak bölüm 2.12, İlk çalıştırma içindeki ilk çalıştırmadır. Sahiplendiyseniz bile, asistanın herhangi birine yanıt verebilmesi için yine de kuruluşun kendi yapay zeka (YZ) model anahtarlarına ihtiyacı vardır. Bölüm 2.14, YZ sağlayıcıları ve modelleri, bunların nasıl bağlanacağını gösterir.