İşletim sistemi imajını kümeye içe aktarma

Ne zaman kullanılır

Kümenin yeni bir işletim sistemi imajına veya önceden içe aktarılmış bir imajın yeni bir sürümüne ihtiyacı olduğunda. İçe aktarma, imajı kayıtlı bir kütüphane kaynağından indirir ve depolama havuzlarına dağıtır. Sanal makineler (VM) imajdan ancak bundan sonra oluşturulabilir.

Bu prosedür dağıtımı tamamlamak için de geçerlidir. Önceki bir içe aktarma imajı her havuza dağıtmadıysa, aynı sürümü yeniden içe aktarmak eksik kopyaları teslim eder.

Kaynak imaj zfs dışında bir biçimdeyse bu prosedür geçerli değildir: içe aktarma bu tür imajları kabul etmez. İmaj sahibini değiştirmek için de geçerli değildir: yeniden içe aktarma, imajın VDC (sanal veri merkezi) sahipliğini yeniden yazmaz.

Ön koşullar

Hedef VDC ile sınırlı Import Golden Image yetkisi; Cluster master rolünün kapsamı geneldir;
Sync Image Library yetkisi: bu yetki olmadan kaynak kataloğunu okuyamaz ve imaj tanımlayıcısını alamazsınız;
vstack-center-image-distributor dağıtım servisi, gerekli vhost'u imgdistr_vhost ile birlikte kümede dağıtılmış olmalıdır; bu servis olmadan içe aktarma sırasında baytları hiçbir şey aktaramaz;
Kütüphane kaynağı kayıtlıdır ve tanımlayıcısı kaynak listesinden bilinmektedir;
Kaynak, çağıran için erişilebilirdir: VDC yöneticisi kendi VDC'sine atanmış bir kaynağa erişebilir, kümede paylaşılan bir kaynak ise yalnızca Cluster master rolüne açıktır. Bu denetim katalog okunmadan ve içe aktarmadan önce yapılır; bu nedenle kaynağa erişim olmadan, gerekli tüm yetkiler verilmiş olsa bile yanıt -403 olur;
Kümede sahibi olan en az bir depolama havuzu vardır;
vStack Center sürümü 4.0.0.

Adımlar

Web arayüzünde içe aktarma, «Image library» bölümünün «Images» sekmesinde başlar. Aşağıdaki adımlar Cluster master rolü içindir. VDC yöneticisi, bir imajı kendi VDC'sine API çağrısıyla, içe aktarma isteğinde o VDC'yi belirterek içe aktarır. İstek yapıları ve yanıtların tüm ayrıntıları API başvurusunda yer alır.

«Add image» düğmesine tıklayın ve «Source» sekmesini açın: «File» sekmesi henüz kullanılamaz. «Source» listesinden bir kaynak seçin. Küme yalnızca kaynağın manifest.json dosyasını okur ve kaynağın imaj kartlarını içeren «Image showcase» görünümünü gösterir. Katalog okuma hızlıdır ve kümede hiçbir şeyi değiştirmez.
Bir imaj seçin. zfs dışındaki bir biçimdeki kart «The platform cannot import this format» açıklamasıyla etkin değildir; önceden içe aktarılmış bir imaj «Already in the cluster catalog» olarak işaretlenir. İçe aktarma tanımlayıcısı, manifest girdisinin uuid alanıdır: hem imajı hem de sürümünü benzersiz şekilde tanımlar. uuid içermeyen bir girdi içe aktarılamaz — önce alanı kaynak manifestine ekleyin.
«Next» düğmesine tıklayın ve havuzları seçin: varsayılan olarak tümü seçilidir. İmajı yalnızca bazı havuzlara dağıtmak için diğerlerinin seçimini kaldırın — kalan kopyalar aynı sürüm yeniden içe aktarılarak teslim edilebilir. «Add» düğmesine tıklayın.

İçe aktarma eşzamansızdır: «Image import has started» bildirimi imajın hazır olduğunu değil, işin kabul edildiğini onaylar. Dağıtım arka planda sürer.

Aynı içe aktarma «Sources» sekmesinden de başlatılabilir: kaynak paneli → imaj kartı → «Import image» → «Import».
Dağıtımın bitmesini bekleyin. «Status» sütununda imaj «Importing» durumundan «Available» durumuna geçer; «Partially available» ve «Failure» durumları aşağıda ele alınmıştır. «Availability» sütunu kaç havuzda kopya bulunduğunu, imaj paneli ise havuz bazında sonucu gösterir.

Sonucu doğrulama

İçe aktarılan imajı «Image library» içinde bulun ve iki şeyi denetleyin:

Denetlenecek öğe	Beklenen değer
İmaj durumu	«Available» (API'de `active`): imaj seçilen tüm havuzlara dağıtıldı
Havuz bazında sonuç	3. adımda seçilen her havuz için bir girdi

«Importing» (importing) durumu dağıtımın hâlâ sürdüğü anlamına gelir. «Partially available» (partial_active) ve «Failure» (failed) durumları aşağıda ele alınmıştır.

Son denetim bir makine oluşturmaktır. VM oluşturmak için seçilen havuzdaki imaj kopyasının etkin olması gerekir; aksi takdirde oluşturma -259 koduyla reddedilir.

Sorun giderme

İçe aktarma otomatik yeniden deneme olmadan tek bir deneme yapar. İndirme, sağlama toplamı, dağıtım veya dağıtım servisinin işi kaybetmesi gibi herhangi bir hata imajı failed durumuna getirir ve bir güvenlik günlüğü kaydı oluşturur. Yeniden denemeyi yönetici aynı içe aktarma işlemiyle başlatır. İşlem sırasında dağıtıcının (dispatcher) yeniden başlatılması tamamlanmamış içe aktarmayı yeniden denemez; onu başarısız olarak işaretler.

Kısmi bir sonuç (partial_active) geri alınmaz: kopyası olan havuzlar onu korur. Hangi havuzların kopya almadığını görmek için dağıtım haritasını denetleyin, ardından eksik kopyaları teslim etmek için aynı sürümü yeniden içe aktarın.

Hata kodu	Anlamı	Eylem
`-48005`	İmaj biçimi içe aktarmaya uygun değil; `zfs` gerekir	Kaynak kataloğunda içe aktarmaya uygun bir imaj seçin
`-48002`	Kaynak kataloğunda bu tanımlayıcıya sahip imaj yok	Kaynak kataloğunu yeniden alın: manifest değişmiş olabilir
`-48003`	İmaj zaten içe aktarılıyor	Mevcut içe aktarmanın sonucunu bekleyin; yeniden başlatmaya gerek yoktur
`-48004`	İmaj kaldırılıyor	Kaldırmanın bitmesini bekleyin
`-48006`	Manifest girdisi doğrulamadan geçemiyor: sürüm, minimum boyut, boyut, sektör boyutları, sağlama toplamı, dosya yolu, bilinmeyen bir işletim sistemi veya konuk özelleştirme türü, yinelenen bir `uuid`	Kaynaktaki manifesti düzeltin
`-48007`	Belirtilen havuz yok veya kümede sahibi olan havuz yok	Havuz listesini denetleyin; kümede sahibi olan bir havuz bulunduğunu doğrulayın
`-48008`	Bu tanımlayıcıya sahip bir imaj katalogda farklı bir kaynak veya sürüm altında zaten var	İmaj tanımlayıcısı genel olarak benzersizdir: manifestte imaja kendi `uuid` değerini atayın
`-46002`	Bu tanımlayıcıya sahip kaynak yok	Kaynak listesindeki güncel bir tanımlayıcıyı kullanın
`-46012`	Kaynak ana bilgisayarı yasaklı bir aralığa çözümleniyor	Kütüphaneyi loopback, link-local, özel RFC 1918 aralıkları, CGNAT, "sıfır ağı" ve yayın adresi dışındaki bir adrese taşıyın
`-46020`	Kaynak kullanılamıyor: ağ hatası, zaman aşımı veya 2xx olmayan bir yanıt	Kütüphane URL'sinin küme ağından erişilebilir olduğunu denetleyin
`-46021`	`manifest.json` JSON olarak ayrıştırılamıyor	Manifest söz dizimini düzeltin
`-46022`	Manifest şema sürümü desteklenen sürümden yüksek	Manifesti desteklenen bir şema sürümüne güncelleyin
`-46023`	Manifest şema doğrulamasından geçemiyor: bir girdide zorunlu alanlar eksik	`name`, `version`, `format`, `url_path`, `size`, `sha256` alanlarını ekleyin
`-49005`	VDC yöneticisi bir VDC belirtmedi: kümede paylaşılan imajı yalnızca Cluster master rolü içe aktarır	İçe aktarma isteğinde kendi VDC'nizi belirtin
`-49006`	Belirtilen VDC çağıranın kapsamı dışında	Rolünüzün bulunduğu bir VDC belirtin
`-403`	Erişim reddedildi	Kaynak erişimini, yetkiyi ve sahipliği denetleyin: kümede paylaşılan bir kaynak yalnızca Cluster master rolüne açıktır; VDC yöneticisinin kendi VDC'sine atanmış bir kaynağa ihtiyacı vardır; mevcut bir imajın yeni sürümünü yalnızca imaj sahibi veya Cluster master rolü içe aktarabilir
`-503`	Güvenlik günlüğü niyet kaydını kabul etmedi	İçe aktarma başlamadı ve hiçbir şey değişmedi; günlüğün kullanılabilirliğini geri getirin ve yeniden deneyin
`-48001`	Veritabanı hatası	İçe aktarmayı yeniden deneyin; hata tekrarlanırsa desteğe başvurun

Ayrıca bakınız

İşletim sistemi imaj kütüphanesi — kaynak, katalog ve havuzlara dağıtım modeli.
İşletim sistemi imajını kaldırma — bağımlılık denetimleriyle birlikte ters işlem.
Sanal makine oluşturma, kaldırma ve taşıma — içe aktarılmış bir imajdan VM oluşturma.

API yöntemleri

Bu sayfada ele alınan API işlemleri os-library-list, os-library-sync, os-image-import ve golden-images-list işlemleridir; API başvurusuna bakın.

Ne zaman kullanılır​

Ön koşullar​

Adımlar​

Sonucu doğrulama​

Sorun giderme​

Ayrıca bakınız​

API yöntemleri​