Aracılığıyla paylaş


Varlık önbelleğe alma sorunlarını giderme

Varlık önbelleğe alma, indirilen paketleri (varlıkları) yerel olarak veya bir ağda depolayarak paket alımını hızlandırarak dış kaynaklara bağımlılığı azaltır. Bu kılavuz, kullanıcıların varlık önbelleği kurulumu veya işlemiyle ilgili sorunlarla karşı karşıya kaldığına yardımcı olabilir.

İlk kurulum yönergeleri için varlık önbelleğe alma belgelerine bakın.

Varlık önbelleğe alma hatalarını tanılama

vcpkg, yapıtları İnternet'ten indirmeden önce kullanılabilir varlık önbelleklerini denetler. Varsayılan olarak, önbellekte bir varlık bulunmazsa sessizce dış kaynaklara geri döner.

'x-block-origin'' seçeneği, varlık geri yükleme hatalarını açık derleme hatalarına dönüştürerek istenmeyen dış indirmeleri önler. Güvenliği artırmak ve eksik önbellek isabetlerini daha görünür hale getirmek için bu seçeneği kullanın.

Varlık geri yükleme sorunlarını algılama

Varlık geri yükleme sorunları varsayılan olarak sessizdir. Bunlar, bir yapıtın indirme URL'si doğrulanarak algılanabilir.

Downloading 7zip...
https://www.7-zip.org/a/7z2301-extra.7z -> C:\vcpkg\downloads\7z2301-extra.7z

Seçenek etkinleştirildiğinde x-block-origin açık bir hata da olabilir:

error: Failed to download from mirror set

Varlık karşıya yükleme sorunlarını algılama

Bir varlık kaynağı doğru yapılandırıldıysa vcpkg, bir varlık önbelleğe yüklenemediyse bir uyarı yayar.

warning: failed to store back to mirror

Yapıtlar varlık önbelleğimden yüklenmiyor veya geri yüklenmiyor

x-azurl vcpkg tarafından sağlanan varlık önbelleği arka ucu, Azure Depolama Kapsayıcıları ile çalışacak şekilde tasarlanmıştır; basit belirteç kimlik doğrulaması ile PUT isteklerini kabul eden diğer depolama hizmetleriyle çalışabilir.

Yapılandırma aşağıdaki biçime sahiptir:

x-azurl,<url>,<sas>[,<rw>]

  • <url>: Kapsayıcının temel URL'si
  • <sas>: Azure Depolama Kapsayıcıları ile çalışıyorsanız Paylaşılan Erişim İmzası (SAS) belirteci veya diğer sağlayıcılarla çalışıyorsanız bir kimlik doğrulama isteği parametresi.
  • <rw>: (İsteğe bağlı) okuma/yazma izni yapılandırması

Not

Azure Depolama Kapsayıcıları ile çalışacak şekilde tasarlanmıştır. x-azurl Arka uç, biçiminde <url>?<sas>istekleri kabul eden depolama hizmetleri için kullanılabilir.

Örneğin, x-azurl,https://contoso.com,token=TOKEN_VALUE,readwrite biçiminde bir istek elde edin https://contoso.com?token=TOKEN_VALUE.

Varlık önbelleği sağlayıcınız yetkilendirme gerektiriyorsa, <sas> parametre boş bırakılabilir. Örneğin, x-azurl,https://contoso.com,,readwrite.

Neden 1: URL doğru biçimlendirilmemiş

Varlık önbelleğinizi ayarlarken URL'nin bir parçası olarak eklediğinizden https:// emin olun.

Sorunu çözme adımları:

1 - Yapılandırılan URL'nin doğru olduğunu doğrulayın.

Neden 2: Yetkilendirme belirteci doğru biçimlendirilmemiş

vcpkg, varlık önbelleği sağlayıcınızda <sas> kimlik doğrulaması yapmak için parametresini kullanır. Yetkilendirmenin başarılı olmamasının çeşitli nedenleri vardır.

Azure Depolama Kapsayıcısı kullanıyorsanız, <sas> parametresinin başka bir istek parametresi biçimlendirmesi olmadan yalnızca SAS belirtecini içermesi gerekir. Örneğin:

x-azurl,https://mystorageaccount.blob.core.windows.net/mystoragecontainer,sasvaluehere,readwrite

Daha fazla bilgi için SAS belirteçleri oluşturma belgelerini okuyun. Oluşturulan belirtecin okuma ve yazma izinlerinin gerekli kullanım örneğinizle eşleştiğinden emin olun.

Farklı bir sağlayıcı kullanıyorsanız istek parametrelerini doğru biçimlendirmeniz gerekebilir. Örneğin, belirtecin değerinden önce bir parametre adı ön eki ekleme.

x-azurl,https://contoso.com,authorization=tokenvaluehere,readwrite.

Sorunu çözme adımları:

1 - Yetkilendirme belirtecinin süresinin dolmadığını doğrulayın

2 - Yetkilendirme belirtecinin kapsayıcınız için doğru izinlere sahip olduğunu doğrulayın

3 - Yetkilendirme belirtecinin değerinin doğru olduğunu doğrulayın

4 - Yetkilendirme belirtecinin biçiminin sağlayıcınız tarafından beklenen biçimle eşleştiğinden emin olun.

"Yansıtma kümesinden indirilemedi" hata iletisi alıyorum

Varlık önbelleğe alma yapılandırması içerdiğinde x-block-originbu sorun oluşur.

Kullanarak x-block-origin , yapılandırılmış önbellekteki bir varlığı paket derleme hatalarına geri yükleme hataları döndürülüyor. Dış kaynaklara istenmeyebilecek erişimi engelleme.

Sorunu çözme adımları:

1 - Ağınızın varlık kaynağına erişimi olduğunu doğrulayın

2 - İstenen varlığın yapılandırılan varlık önbelleklerinden en az birinde mevcut olduğunu doğrulayın. Paket yoksa sorunu çözmek için iki yöntem vardır:

  • vcpkg'nin x-block-origin varlığı indirmesine ve yapılandırılmış bir varlık önbelleğine yüklemesine izin vermek için geçici olarak devre dışı bırakılarak.
  • Varlığı yapılandırılan varlık önbelleklerinden birine el ile yükleme.

3 - Varlık önbelleklerinin düzgün yapılandırıldığını doğrulayın, Yapıtlar varlık önbelleğimden yüklenmiyor veya geri yüklenmiyor'daki adımları izleyin.

Sorun burada listelenmiyor

Sorununuz burada listelenmiyorsa, yeni bir sorun oluşturmak için depomuzu ziyaret edin.