Konuk yapılandırma paketi yapılarını test etme

PowerShell modülü, GuestConfiguration bir yapılandırma paketinin Azure dışında test etmeyi otomatikleştirmek için araçlar içerir. Sorunları bulmak ve Azure ya da yay bağlantılı bir ortamda teste geçmeden önce hızlıca yinelemek için bu araçları kullanın.

Teste başlamadan önce, bir konuk yapılandırma yazma ortamı ayarlama ve ardından özel konuk yapılandırma paketi yapıtları oluşturma ve özel bir konuk yapılandırma paketi oluşturma ve yayımlama hakkında tüm adımları izleyin.

Önemli

Bir ortamın durumunu denetleyen özel paketler genel kullanıma sunulmuştur, ancak yapılandırma uygulayan paketler önizlemededir. Aşağıdaki sınırlamalar geçerlidir:

Yapılandırmaları uygulayan Konuk yapılandırma paketlerini kullanmak için, Azure VM Konuk yapılandırma uzantısı sürüm 1.29.24 veya üzeri ya da Arc Agent 1.10.0 veya üzeri bir sürümü gereklidir.

Linux üzerinde yapılandırmaların oluşturulmasını ve uygulanmasını test etmek için, GuestConfiguration Modül yalnızca Ubuntu 18 ' de kullanılabilir ancak modül tarafından üretilen paket ve ilkeler, Azure 'da veya yaya desteklenen tüm Linux 'ta veya sürümünde kullanılabilir.

MacOS 'ta paketleri test etme kullanılamıyor.

Paketi iş istasyonunuzdan veya sürekli tümleştirme ve sürekli dağıtım (CI/CD) ortamından test edebilirsiniz. GuestConfigurationModül, Azure veya Arc etkin makinelerde kullanılan geliştirme ortamınız için aynı aracıyı içerir. aracı, Linux için Windows ve 7.2.0-preview. 7 için tek başına bir PowerShell 7.1.3 örneği içerir, bu nedenle paketin test edildiği komut dosyası ortamı, konuk yapılandırması kullanarak yönettiğiniz makinelerle tutarlıdır.

Azure 'daki aracı hizmeti ve yay özellikli makinelerde, Linux 'ta Windows ve "Root" içinde "LocalSystem" hesabı olarak çalışıyor. En iyi sonuçlar için aşağıdaki komutları ayrıcalıklı güvenlik bağlamında çalıştırın.

PowerShell 'i Windows içinde "LocalSystem" olarak çalıştırmak için, SysInternals aracı psexecaracını kullanın.

Linux 'ta PowerShell 'i "root" olarak çalıştırmak için su komutunukullanın.

Yapılandırma paketinin gereksinimleri karşıladığını doğrulama

Yapılandırma paketinin kullanarak temel gereksinimleri karşıladığından önce test edin Get-GuestConfigurationPacakgeComplianceStatus . Komut aşağıdaki paket gereksinimlerini doğrular.

  • MOF var ve doğru konumda geçerli
  • Gerekli modüller/bağımlılıklar, yinelemeler olmadan doğru sürümle birlikte mevcuttur
  • Paketin imzalı olduğunu doğrulama (isteğe bağlı)
  • Bunu test edin Test ve Get uyumluluk durumu hakkında bilgi döndürün

Get-GuestConfigurationPackageComplianceStatus Cmdlet parametreleri:

  • Paket: Konuk yapılandırma paketinin dosya yolu veya URI 'si.
  • Parametre: Hashtable biçiminde belirtilen ilke parametreleri.

bu komut ilk kez çalıştırıldığında, konuk yapılandırma aracısı Windows ve Linux üzerindeki yoldaki test makinesine yüklenir c:\programdata\GuestConfig\bin /var/lib/GuestConfig/bin . Bu yola bir kullanıcı hesabı erişemez, bu nedenle komutun yükseltilmesi gerekir.

Paketi test etmek için aşağıdaki komutu çalıştırın:

Windows, yükseltilmiş bir PowerShell 7 oturumundan.

# Get the current compliance results for the local machine
Get-GuestConfigurationPackageComplianceStatus -Package ./MyConfig.zip

Linux 'ta sudo kullanarak PowerShell 'i çalıştırın.

# Get the current compliance results for the local machine
sudo pwsh -command 'Get-GuestConfigurationPackageComplianceStatus -Package ./MyConfig.zip'

Komut, kaynak başına uyumluluk durumunu ve ayrıntılarını içeren bir nesne çıkarır.

  complianceStatus  resources
  ----------------  ---------
  True              @{BuiltInAccount=localSystem; ConfigurationName=MyConfig; Credential=; Dependencies=System.Obje…

Yapılandırma paketinin bir yapılandırma uygulayabilmesi için test

Son olarak, yapılandırma paketi modu, AuditandSet Set yönteminin, komutunu kullanarak ayarları yerel makineye uygulayabilmesi için test edebilirsiniz Start-GuestConfigurationPackageRemediation .

Önemli

Bu komut, yerel ortamda çalıştığı yerde değişiklik yapmaya çalışır.

Start-GuestConfigurationPackageRemediationCmdlet parametreleri:

  • Paket: Konuk yapılandırma paketinin tam yolu.

Windows, yükseltilmiş bir PowerShell 7 oturumundan.

# Test applying the configuration to local machine
Start-GuestConfigurationPackageRemediation -Package ./MyConfig.zip

Linux 'ta sudo kullanarak PowerShell 'i çalıştırın.

# Test applying the configuration to local machine
sudo pwsh -command 'Start-GuestConfigurationPackageRemediation -Package ./MyConfig.zip'

Hata oluşmadığı takdirde komut çıkış döndürmez. Sırasında oluşan olaylar hakkındaki ayrıntıları gidermek için Set -verbose parametresini kullanın.

Komutu çalıştırdıktan sonra Start-GuestConfigurationPackageRemediation , Get-GuestConfigurationComplianceStatus makinenin şimdi doğru durumda olduğunu onaylamak için komutu yeniden çalıştırabilirsiniz.

Sonraki adımlar