İşletim sistemi imajını kaldırma

Ne zaman kullanılır

Bir işletim sistemi imajına artık ihtiyaç duyulmadığında ve kopyalarının tüm küme havuzlarından kaldırılması gerektiğinde. İşlem geri döndürülemez ve açık onay gerektirir: imaj yalnızca kütüphane kaynağından yeniden içe aktarılarak geri getirilebilir.

Kaldırma iki adımdan oluşur: salt okunur bir bağımlılık denetimi ve ardından kaldırmanın kendisi. İlk adım güvenlidir ve gerektiği kadar tekrarlanabilir: düğümlerde veya katalogda hiçbir şeyi değiştirmez.

Bir imajı yalnızca bir VDC için kısıtlamanız gerekiyorsa bu prosedür geçerli değildir: kaldırma, imajın tamamını tüm küme havuzlarından siler. Bir sürümü geri çekmek için de geçerli değildir: imaj sürümlerine ayrı katalog nesneleri olarak başvurulamaz; imaj kendi tanımlayıcısıyla kaldırılır.

Ön koşullar

• Bağımlılık denetimleri için hedef VDC ile sınırlı View Image Dependencies yetkisi;
• Kaldırmanın kendisi için hedef VDC ile sınırlı Remove OS Image yetkisi; bu ayrı bir haktır ve görünürlük izinlerine üyelik bu hakkı sağlamaz;
• İmaj sahipliği: VDC yöneticisi yalnızca kendi VDC'sine ait imajları kaldırabilir. Kümede paylaşılan bir imajı veya yalnızca kendi VDC'sine görünür kılınmış bir imajı kaldıramaz; bu kaldırmayı Cluster master rolü gerçekleştirir;
• Küme düğümlerine erişilebilir olmalıdır: kullanılamayan bir düğüm kendi kopyasını kaldıramaz ve kaldırma kısmi bir sonuçla biter;
• vStack Center sürümü 4.0.0.

Adımlar

Web arayüzünde kaldırma, «Image library» bölümünün «Images» sekmesinde başlar: imaj panelinde «Delete image» veya satır menüsünde «Delete», ardından «Delete image?» iletişim kutusunda «Delete» — bu, geri döndürülemezliğin açık onayıdır. Arayüz önceden ayrı bir denetim çalıştırmaz. İmajın bağımlılıkları varsa «The image cannot be deleted» iletişim kutusu «Virtual machines from this image», «Clones on nodes» öğelerini ve atlanan düğüm sayısını listeler. Kısmi bir sonuç, «Removed from», «Failed on» ve «Skipped» gruplarını ve bir «Retry» düğmesini içeren «The image has been removed partially» iletişim kutusunu açar. VDC yöneticisi kümede paylaşılan bir imajı veya başka bir VDC'nin imajını kaldıramaz: düğme «The image belongs to another virtual data center» ipucuyla etkin değildir.

Aşağıdaki adımlar işlem sırasını küme API'si üzerinden verir; istek yapıları ve yanıtların tüm ayrıntıları API başvurusunda yer alır.

1. İmajın bağımlılık haritasını alın. Denetim tüm çevrimiçi düğümleri sorgular ve aynı anda imaja başvuran makineleri arar. Sonuç, sorgulama tamamlandığında gelir.

2. Haritayı okuyun ve dört şeyi denetleyin.

   Denetlenecek öğe	Nasıl yorumlanır
   Toplam bağımlılık işareti	"Var" değeri kaldırmanın engelleneceği anlamına gelir
   Klon haritası	"Düğüm → havuz → klonlar": solda alt veri kümesi (dataset), sağda onun üst anlık görüntüsü (snapshot, origin) bulunur. Bir çiftte imajın bulunmadığına dair gösterge "bu havuzda imaj kopyası yok" anlamına gelir; bu ne bir bağımlılık ne de bir hatadır
   Bağımlı makineler	İmaja başvuran makineler: her makinenin tanımlayıcısı ve adı
   Atlanan düğümler	Sorgulanamayan düğümler: denetim eksiktir

   Boş olmayan bir atlanan düğümler listesi, klonların fark edilmemiş olabileceği anlamına gelir. Düğümün geri dönmesini bekleyin ve haritayı yeniden alın.

3. Bağımlılıkları kaldırın. İmajın en az bir ZFS klonu veya bağımlı makinesi olduğu sürece kaldırma -48012 koduyla reddedilir ve düğümlere dokunulmaz. Haritadaki bağımlı makineleri çözün. Tutucu başka bir katalog imajı da olabilir: harita onu da adlandırır ve böyle bir imaj ancak tutucusundan sonra kaldırılabilir.

4. İmajı kaldırın. İşlemin geri döndürülemez olduğunu açıkça onaylayın: onay olmadan kaldırma reddedilir. vStack Center, kaldırmadan önce, denetim ile kaldırma arasında yeni bir imaj klonunun ortaya çıktığı bir yarış durumuna karşı bağımlılıkları yeniden denetler.

   Sonuç kesindir: çevrimiçi düğümler yanıt verdikten sonra gelir ve sonucu hemen içerir: imaj aşaması, kopyanın kaldırıldığı düğümler, hata veren düğümler ve atlanan düğümler.

Sonucu doğrulama

Tam kaldırma, sonucun üç yönüyle belirlenir:

Denetlenecek öğe	Beklenen değer
İmaj aşaması	removed — katalog satırı silindi
Hata veren düğümler	Liste boş
Atlanan düğümler	Liste boş

Ardından imaj küme kataloğundan kaybolur. Satırının artık imaj kataloğunda bulunmadığını doğrulayın.

Sorun giderme

Bazı düğümler kopyalarını kaldırmadı

Kaldırma başarı döndürür, ancak partial_active aşamasıyla: bazı düğümler kopyalarını kaldırmamıştır. Sonuç, hata veren düğümleri ve her birinin nedenini (örneğin meşgul bir dataset) listeler.

Başarılı düğümler geri alınmaz ve katalog satırı kalır. Nedeni giderin ve kaldırmayı yeniden deneyin: kalanları idempotent biçimde kaldırır. Boş olmayan bir atlanan düğümler listesi de aynı anlama gelir: bir düğüm yanıt vermediği için kalan kopyaların kaldırılması doğrulanmamıştır.

Servis kaldırma sırasında yeniden başladı

Yeniden başlatmadan sonra takılı kalan imaj olmaz. Tam kaldırma, imaj satırı katalogdan kaybolmadan kesinlikle önce güvenlik günlüğüne kaydedilir; bu nedenle kesinleşmiş kaldırmalar başlangıçta tamamlanır, kesinleşmemiş olanlar ise partial_active durumuna getirilir. Kaldırmayı yeniden denemek işlemi tamamlar.

Koda göre hatalar

Hata kodu	Anlamı	Eylem
-48011	Geri döndürülemezlik onaylanmadı	Kaldırmanın geri döndürülemez olduğunu açıkça onaylayın
-48012	İmajın ZFS klonları veya bağımlı makineleri var	Bağımlılık haritasını alın ve bağımlı nesneleri kaldırın; düğümlere dokunulmadı
-48009	İmaj bulunamadı: katalog satırı yok veya imaj çağıran için görünür değil	İmaj tanımlayıcısını denetleyin; başkasına ait kısıtlı bir imaj için de yanıt aynıdır, bu nedenle varlığı doğrulanmaz
-48004	Eşzamanlı bir işlem imajı zaten kaldırıyor	İlk işlemin sonucunu bekleyin
-48010	Düğümler sorgulanamadı: küme durumu veya aktarım kullanılamıyor	Küme durumunu denetleyin ve yeniden deneyin
-403	Erişim reddedildi	Kaldırma yetkisini ve sahipliği denetleyin: paylaşılan bir imajı, başkasının imajını veya bir izinle görünür kılınmış bir imajı yalnızca Cluster master rolü kaldırabilir
-503	Güvenlik günlüğü niyet kaydını kabul etmedi	Kaldırma başlamadı ve hiçbir şey değişmedi; günlüğün kullanılabilirliğini geri getirin ve yeniden deneyin
-48001	Veritabanı hatası	Kaldırmayı yeniden deneyin; hata tekrarlanırsa desteğe başvurun

Geçersiz veya eksik bir imaj tanımlayıcısı ve eksik onay, katalog veya düğümler üzerinde herhangi bir eylemden önce, istek ayrıştırma sırasında reddedilir.

Ayrıca bakınız

• İşletim sistemi imaj kütüphanesi — katalog modeli, imaj sahipliği ve görünürlük kapsamı.
• İşletim sistemi imajını kümeye içe aktarma — ters işlem: imajı içe aktarma ve havuzlara dağıtma.

API yöntemleri

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