Geliştirme kutuları için kullanıcı özelleştirmelerini yapılandırma

Kullanıcı özelleştirme dosyasını karşıya yükleyerek Microsoft Dev Box'ınızı kişiselleştirebilirsiniz. Kullanıcı özelleştirme dosyaları, geliştirme kutunuzu tercih ettiğiniz kişisel ayarlar ve uygulamalarla yapılandırmanıza olanak tanır, böylece kodlamaya daha hızlı başlayabilirsiniz. Bu makalede, Visual Studio (VS) Code kullanarak yerel sürücünüzden veya deponuzdan kullanıcı özelleştirme dosyası oluşturma, test etme ve karşıya yükleme işlemi açıklanmaktadır. Ayrıca dosyanızı doğrulamayı ve projeler için özelleştirme ayarlarını yönetmeyi de öğrenirsiniz.

Dev Box özelleştirmeleri iki şekilde çalışır: ekip özelleştirmeleri ekipler için paylaşılan yapılandırmalar oluşturur ve kullanıcı özelleştirmeleri tek tek geliştiriciler için kişisel yapılandırmalar oluşturur. Ayrıntılı karşılaştırma için bkz. Microsoft Dev Box özelleştirmeleri.

Kullanıcı özelleştirmeleri, geliştiricilerin şirket korumalarına uymasını sağlamaya yardımcı olur; yalnızca katalog aracılığıyla önceden onaylanan görevler geliştiriciler tarafından kullanılabilir. Standart geliştirme kutusu kullanıcıları, sistem bağlamında yerleşik PowerShell ve WinGet görevlerini çalıştıramaz ve bu da ayrıcalık yükseltmesini önler.

Kullanıcı özelleştirmeleri proje düzeyinde etkinleştirilebilir veya devre dışı bırakılabilir. Proje oluşturduğunuzda, kullanıcı özelleştirmeleri varsayılan olarak açıktır.

Önkoşullar

Bu makaledeki adımları tamamlamak için:

Özelleştirmeleri yapılandırmak için gereken izinler için bkz. Özelleştirme izinleri.

Kullanıcı özelleştirme dosyası oluşturma

VS Code'da özelleştirme dosyaları oluşturun ve yönetin. Ekli katalogdaki görevleri bulmak ve özelleştirme dosyasını test etmek için VS Code'daki Microsoft Dev Box uzantısını kullanın.

  1. Test için bir geliştirme kutusu oluşturun veya mevcut geliştirme kutusunu kullanın.

  2. Test geliştirme kutusunda VS Code'u ve ardından Dev Box uzantısını yükleyin.

  3. Örnek bir YAML özelleştirme dosyasını örnek depodan indirin ve VS Code'da açın.

  4. Komut paletini kullanarak katalogdaki kullanılabilir görevleri keşfedin. Görüntüle>Komut Paleti>Geliştirme Kutusu: Bu Geliştirme Kutusu İçin Kullanılabilir Görevleri Listele'yi seçin.

    Visual Studio Code'da kullanılabilir görevleri listeleme komutunu gösteren Dev Box komut paletinin ekran görüntüsü.

  5. Komut paletini kullanarak VS Code'da özelleştirmeyi test edin. Görünüm>Komut Paleti>Geliştirme Kutusu: Özelleştirme Görevlerini Uygula'yı seçin.

    Visual Studio Code'da özelleştirme görevlerini uygulama komutunu gösteren Geliştirme Kutusu komut paletinin ekran görüntüsü.

  6. Özelleştirme dosyası çalışır ve belirtilen görevleri test geliştirme kutunuza uygular. Değişiklikleri inceleyin ve görev yürütme sırasında hatalar veya uyarılar için VS Code terminalini denetleyin.

  7. Özelleştirme dosyası başarıyla çalıştırıldıktan sonra kataloğunuza yükleyin.

İsteğe bağlı: Mevcut WinGet yapılandırma dosyalarını kullanarak geliştirme kutunuzu özelleştirme

WinGet yapılandırması, Windows ortamınızı koda hazır yapmak için gereken benzersiz yazılım kümelerini ve yapılandırma ayarlarını tanımlamak için kod olarak yapılandırma yaklaşımını kullanır. Bu yapılandırma dosyalarını, Microsoft tarafından sağlanan hızlı başlangıç kataloğunda yer alan winget görevini kullanarak geliştirme kutusu ayarlamak için de kullanabilirsiniz.

Bu örnekte, mevcut bir WinGet İstenen Durum Yapılandırması (DSC) dosyasını kullanan bir geliştirme kutusu özelleştirme dosyası gösterilmektedir.

$schema: "1.0"
name: "devbox-customization"
userTasks:
  - name: ~/winget
    parameters:
      configure: "projectConfiguration.dsc.yaml"

Daha fazla bilgi edinmek için bkz . WinGet yapılandırması.

Kullanıcı özelleştirme dosyası kullanarak geliştirme kutusu oluşturma

Geliştirme kutunuzu oluştururken yerel bir sürücüden yükleyerek veya bir depodan indirerek tek bir özelleştirme dosyası kullanın. Bir depoda depolanan özelleştirme dosyalarının adı workload.yaml olmalıdır. Karşıya yükleme için yerel olarak depolanan özelleştirme dosyaları myfilename.yaml olarak adlandırılmalıdır.

Dosya yükle

  1. Geliştirici portalındaYeni Yeni>geliştirme kutusunu seçin.

  2. Geliştirme kutusu ekle bölmesinde geliştirme kutunuza ilişkin ayrıntıları ekleyin.

  3. Özelleştirmeleri uygula'yı ve ardından Devam'ı seçin.

    Geliştirici portalında özelleştirmeleri uygulama seçeneğini gösteren Geliştirme kutusu ekle bölmesinin ekran görüntüsü.

  4. Özelleştirme dosyalarını karşıya yükle'yi seçin, Dosyadan özelleştirme ekle'yi seçin, ardından myfilename.yaml dosyanıza göz atın ve seçin.

    Geliştirici portalında, bir dosyadan özelleştirme ekleme seçeneğini gösteren Özelleştirme dosyasını karşıya yükleme bölümünün ekran görüntüsü.

  5. Özelleştirmeler dosyanızdaki görevlerin doğru uygulanıp uygulanmadığını denetlemek için, devam etmeden önce bunları doğrulayın. Doğrula'yı seçin.

    Devam etmeden önce özelleştirme dosyasını doğrulama seçeneğini gösteren geliştirici portalında Doğrula düğmesinin ekran görüntüsü.

  6. Geliştirme kutusu oluşturma özetini gözden geçirin ve Oluştur'u seçin.

    Geliştirici portalında özelleştirilmiş geliştirme kutusu oluşturma seçeneğini gösteren geliştirme kutusu oluşturma özet sayfasının ekran görüntüsü.

Depodan dosya alma

  1. Geliştirici portalındaYeni Yeni>geliştirme kutusunu seçin.

  2. Geliştirme kutusu ekle bölmesinde, geliştirme kutunuz için ayrıntıları ekleyin.

  3. Özelleştirmeleri uygula'yı ve ardından Devam'ı seçin.

    Geliştirici portalında özelleştirmeleri uygulama seçeneğini gösteren Geliştirme kutusu ekle bölmesinin ekran görüntüsü.

  4. Özelleştirme dosyalarını karşıya yükle'yi seçin, Bir depodan özelleştirme dosyası seçin'i seçin ve ardından iş yükü.yaml dosyanızı depolayan deponun URL'sini girin.

    Geliştirici portalında depo URL'si girme seçeneğini gösteren Bir depodan özelleştirme dosyası seçin bölümünün ekran görüntüsü.

  5. Özelleştirmeler dosyanızdaki görevlerin doğru uygulanacağını doğrulamak için, devam etmeden önce bunları doğrulayın. Doğrula'yı seçin.

    Devam etmeden önce özelleştirme dosyasını doğrulama seçeneğini gösteren geliştirici portalında Doğrula düğmesinin ekran görüntüsü.

  6. Geliştirme kutusu oluşturma özetini gözden geçirin ve Oluştur'u seçin.

    Geliştirici portalında özelleştirilmiş geliştirme kutusu oluşturma seçeneğini gösteren geliştirme kutusu oluşturma özet sayfasının ekran görüntüsü.

Kullanıcı özelleştirmelerini devre dışı bırakma

Kullanıcı özelleştirmeleri proje düzeyinde denetlenip varsayılan olarak etkinleştirilir. Bunları proje oluşturma sırasında veya sonrasında devre dışı bırakabilirsiniz. Geliştiriciler devre dışı bırakıldığında yeni geliştirme kutularına kendi özelleştirme dosyalarını uygulayamaz. Kullanıcı özelleştirmelerinin etkinleştirilmesi mevcut proje korumalarını atlamaz; geliştiriciler yalnızca ekli katalogda sağlanan görevleri kullanabilir ve yönetici kataloğa açıkça bir yönetim görevi eklemediği sürece yükseltilmiş ayrıcalıklara sahip görevleri çalıştıramaz.

Azure portalı aracılığıyla kullanıcı özelleştirmelerini devre dışı bırakma

  1. Azure portalınaoturum açın.

  2. Arama kutusuna projeler yazın. Sonuç listesinde Projeler'i seçin.

  3. Projeler sayfasında, kullanıcı özelleştirmelerini devre dışı bırakmak istediğiniz projeyi seçin.

  4. Ayarlar>Geliştirme Kutusu Ayarlarına git.

    Geliştirme kutusu ayarlarında etkinleştirilen kullanıcı özelleştirmeleri özelliğini gösteren geliştirme kutusu projesinin ekran görüntüsü.

  5. Kullanıcı özelleştirmelerini devre dışı bırakmak için Etkinleştir onay kutusunu temizleyin ve Uygula'yı seçin.

Geliştirici portalında geliştirici deneyimi

Bir proje için kullanıcı özelleştirmelerini devre dışı bırakdığınızda geliştiriciler geliştirme kutusu oluşturma sırasında kullanıcı özelleştirme dosyasını karşıya yüklemeye devam edebilir, ancak doğrulama işlemi başarısız olur ve özelleştirmeler geliştirme kutusuna uygulanmaz.

Kullanıcı özelleştirmelerinin devre dışı bırakıldığı bir projede kullanıcı özelleştirmeleri içeren bir geliştirme kutusu oluşturursanız, geliştirici portalında aşağıdakileri görürsünüz:

  1. Yeni geliştirici kutucuğundaki bir mesaj, özelleştirmelerin uygulanmasında hatalar gösteriyor.

    Özelleştirmeler uygulanırken hatalarla karşılaştık iletisini gösteren geliştirme kutusu kutucuğunun ekran görüntüsü. Ayrıntılara bak düğmesi vurgulanır.

  2. Ayrıntılar yöneticinize başvurun diyor.

    Geliştirici portalında hata ayrıntıları bölmesinin, özelleştirmelerin başarısız olduğunu belirten bir ileti görüntüleyen ve kullanıcıya yöneticisine başvurmasını tavsiye eden ekran görüntüsü.

  3. Geliştirme kutusu kullanıcı özelleştirmelerini içermez.

İlgili içerik

  • Last updated on