Aracılığıyla paylaş


Visual Studio Kapsayıcı Araçları'nı yapılandırma

Kapsayıcı Araçları ayarlarını kullanarak Visual Studio'nun Docker kapsayıcılarıyla nasıl çalıştığının bazı yönlerini denetleyebilirsiniz. Bu makalede, Docker kapsayıcılarıyla çalışırken Visual Studio performansını ve kaynak kullanımını etkileyebilecek Kapsayıcı Araçları ayarlarının nasıl yapılandırılacağı açıklanır.

Kapsayıcı Araçları ayarları

Ayarlara erişmek için ana Visual Studio menüsünden Araçlar > Seçenekleri'ni seçin. Sol bölmede aşağı kaydırın ve Kapsayıcı Araçları'nı genişletin.

Genel ayarlar

Visual Studio Kapsayıcı Araçları seçeneklerinin ekran görüntüsü.

Aşağıdaki tabloda Genel ayarlar açıklanmaktadır:

Ayarlar Varsayılan değer Açıklama
Gerekirse Docker Desktop'ı yükleyin Bana sor Docker Desktop'ın yüklü olup olmadığının sorulmasını isteyip istemediğinizi seçin.
Gerekirse Docker Desktop'ı başlatın Her zaman Docker Desktop başlatılmadıysa, otomatik olarak başlatılıp başlatılmayacağını veya size sorulup sorulmayacağını seçin.
ASP.NET Core SSL sertifikasına güvenin Bana sor Bir ASP.NET Core projesinde SSL sertifikasına localhost güvenilip güvenilmediğinin sorulup sorulmayacağını seçin.

Visual Studio Kapsayıcı Araçları seçeneklerinin ekran görüntüsü.

Aşağıdaki tabloda Genel ayarlar açıklanmaktadır:

Ayarlar Varsayılan değer Açıklama
Gerekirse Docker Desktop'ı yükleyin Bana sor Docker Desktop'ın yüklü olup olmadığının sorulmasını isteyip istemediğinizi seçin.
Gerekirse Docker Desktop'ı başlatın Bana sor Docker Desktop başlatılmadıysa, otomatik olarak başlatılıp başlatılmayacağını veya size sorulup sorulmayacağını seçin.
ASP.NET Core SSL sertifikasına güvenin Bana sor Bir ASP.NET Core projesinde SSL sertifikasına localhost güvenilip güvenilmediğinin sorulup sorulmayacağını seçin.

Önemli

Çekirdek SSL sertifikasına ASP.NET Güven'iHiçbir zaman olarak ayarlarsanız ve SSL sertifikasına localhost güvenilmiyorsa, HTTPS web istekleri çalışma zamanında başarısız olabilir. Bu durumda, Güven ASP.NET Çekirdek SSL sertifikasınıBana sor olarak ayarlayın, projenizi çalıştırın ve istemde güveni belirtin.

Tek Proje veya Docker Oluşturma ayarları

Container Tools Single Project ve Docker Compose ayarları aynıdır.

Visual Studio 2019 Kapsayıcı Araçları seçeneklerinin ekran görüntüsü.

Visual Studio 2022 Kapsayıcı Araçları seçeneklerinin ekran görüntüsü.

Aşağıdaki tabloda Tek Proje ve Docker Compose ayarları açıklanmaktadır:

Ayarlar Varsayılan değer Açıklama
Proje açıkken gerekli Docker görüntülerini çekin Doğru Bir kapsayıcı projesi yüklerken bir arka plan Docker çekme işleminin başlatılıp başlatılmayacağı. Kodunuzu çalıştırmaya hazır olduğunuzda gerekli görüntüler indirilir veya indirilir. Yalnızca koda göz atmak istiyorsanız, ihtiyacınız olmayan kapsayıcı görüntülerini indirmekten kaçınmak için False olarak ayarlayabilirsiniz.
Proje açılışında güncelleştirilmiş Docker görüntülerini çekin .NET Core projeleri En son güncelleştirmeleri almak için projedeki tüm görüntüler için bir Docker çekme işleminin çalıştırılıp çalıştırılmayacağı veya hangi projelerde çalıştırılacağı.
Proje açılışında kapsayıcıları çalıştırma Doğru Bir kapsayıcı projesi yüklerken bir kapsayıcı oluşturulup oluşturulmayacağı, böylece derleyip çalıştırdığınızda hazır olur. Kapsayıcınızın ne zaman oluşturulduğunu denetlemeyi tercih ediyorsanız False olarak ayarlayın.
Proje kapanışındaki kapsayıcıları kaldırın Doğru Çözümü kapattıktan veya Visual Studio'yu kapattıktan sonra çözümünüz için kapsayıcıları kaldırıp kaldırmayacağınız.
Ayarlar Varsayılan değer Açıklama
Proje açıkken gerekli Docker görüntülerini çekin Doğru Bir kapsayıcı projesi yüklerken bir arka plan Docker çekme işleminin başlatılıp başlatılmayacağı. Kodunuzu çalıştırmaya hazır olduğunuzda gerekli görüntüler indirilir veya indirilir. Yalnızca koda göz atmak istiyorsanız, ihtiyacınız olmayan kapsayıcı görüntülerini indirmekten kaçınmak için False olarak ayarlayabilirsiniz.
Proje açılışında güncelleştirilmiş Docker görüntülerini çekin .NET Core projeleri En son güncelleştirmeleri almak için projedeki tüm görüntüler için bir Docker çekme işleminin çalıştırılıp çalıştırılmayacağı veya hangi projelerde çalıştırılacağı.
Proje açılışında kapsayıcıları çalıştırma Doğru Bir kapsayıcı projesi yüklerken bir kapsayıcı oluşturulup oluşturulmayacağı, böylece derleyip çalıştırdığınızda hazır olur. Kapsayıcınızın ne zaman oluşturulduğunu denetlemeyi tercih ediyorsanız False olarak ayarlayın.
Proje kapanışındaki kapsayıcıları kaldırın Doğru Çözümü kapattıktan veya Visual Studio'yu kapattıktan sonra çözümünüz için kapsayıcıları kaldırıp kaldırmayacağınız.
Azure Kimlik Doğrulaması'nı etkinleştirmek için kapsayıcılarda bir hizmet çalıştırın Doğru Visual Studio sürüm 17.6 veya üzeri için, Azure Kimlik Doğrulaması'nı etkinleştirmek için kapsayıcıya bir belirteç proxy hizmeti yükleyip çalıştırmayacağınız. Bu hizmet, uygulamalarınızın geliştirme sırasında Azure hizmetlerini kullanmasına olanak tanır. Daha fazla bilgi için Azure kimlik doğrulamasını yapılandırma bölümüne bakın.
Çalışırken Yeniden Yükleme'yi etkinleştirmek için kapsayıcılarda bir hizmet çalıştırın Doğru Visual Studio sürüm 17.7 ve üzeri için, Çalışırken Yeniden Yükleme hizmetinin yüklenip çalıştırılmayacağı. Bu hizmet yalnızca hata ayıklama olmadan çalıştırmayı destekler, Ctrl+F5.

Kapsayıcılar Araç Penceresi ayarları

Kapsayıcılar Araç Penceresi ayarları, Docker kapsayıcıları ve görüntüleri hakkında bilgi gösteren Visual Studio IDE'deki Kapsayıcılar penceresi için geçerlidir. Daha fazla bilgi için bkz. Kapsayıcılar penceresini kullanma.

Kapsayıcılar Aracı penceresi için kullanılabilen ayarları gösteren Visual Studio Kapsayıcı Araçları Seçenekleri'nin ekran görüntüsü.

Aşağıdaki tabloda Kapsayıcılar Araç Penceresi ayarları açıklanmaktadır:

Ayarlar Varsayılan değer Açıklama
Kapları budamadan önce onaylayın Her zaman Kullanılmayan kapları budarken size sorulup sorulmayacağı.
Görüntüleri budamadan önce onaylayın Her zaman Kullanılmayan görüntüleri budarken size sorulup sorulmayacağı.
Bir kabı çıkarmadan önce onaylayın Her zaman Bir kabı çıkarırken size sorulup sorulmayacağı.
Bir görüntüyü kaldırmadan önce onaylayın Her zaman Bir görüntüyü kaldırırken size sorulup sorulmayacağı.
Çok sayıda görüntüyü çalıştırmadan önce onaylayın Her zaman Aynı anda 10'dan fazla görüntüden kapsayıcıları başlatmadan önce size sorulup sorulmayacağı.

Kapsayıcılar Pencere ayarları

Kapsayıcılar Penceresi ayarları, Docker kapsayıcıları ve görüntüleri hakkında bilgi gösteren Visual Studio IDE'deki Kapsayıcılar penceresi için geçerlidir. Daha fazla bilgi için bkz. Kapsayıcılar penceresini kullanma.

Kapsayıcılar Penceresi için kullanılabilen ayarları gösteren Visual Studio Kapsayıcı Araçları Seçenekleri'nin ekran görüntüsü.

Aşağıdaki tabloda Kapsayıcılar Penceresi ayarları açıklanmaktadır:

Ayarlar Varsayılan değer Açıklama
Kapları budamadan önce onaylayın Her zaman Kullanılmayan kapları budarken size sorulup sorulmayacağı.
Görüntüleri budamadan önce onaylayın Her zaman Kullanılmayan görüntüleri budarken size sorulup sorulmayacağı.
Bir kabı çıkarmadan önce onaylayın Her zaman Bir kabı çıkarırken size sorulup sorulmayacağı.
Bir görüntüyü kaldırmadan önce onaylayın Her zaman Bir görüntüyü kaldırırken size sorulup sorulmayacağı.
Çok sayıda görüntüyü çalıştırmadan önce onaylayın Her zaman Aynı anda 10'dan fazla görüntüden kapsayıcıları başlatmadan önce size sorulup sorulmayacağı.
Kapsayıcılar penceresinde kullanılacak dize biçimini görüntüleme Boş {ContainerName}, {ImageName}, {ProjectName} ve {ContainerID} belirteçleri desteğiyle Kapsayıcılar penceresinde kullanılacak bir görüntü dizesi biçimi.
Kapsayıcıları Docker Compose projesine göre gruplandırma Her zaman Kapsayıcıların parçası oldukları Docker Compose projesine göre gruplandırılıp gruplandırılmayacağı.

Azure kimlik doğrulamasını yapılandırma

Uygulamanız Azure hizmetlerini kullanıyorsa, bir kapsayıcıda çalışırken Azure hizmetleriyle kimlik doğrulaması yapmak için uygun kimlik bilgilerine ihtiyaç duyar. Geliştirme sırasında genellikle kendi Azure kimlik bilgilerinizi kullanabilirsiniz, ancak kapsayıcı ortamında çalıştırmak için kapsayıcılı uygulamanın üretimde kullandığı kimlik bilgileri gerekir.

Visual Studio 2022 sürüm 17.6 ve üzeri, uygulamalarınızın ve hizmetlerinizin Azure'da kimlik doğrulamasına yardımcı olmak için tek kapsayıcılı ve Docker Compose projelerinizde bir belirteç proxy hizmeti dağıtır ve çalıştırır. Bu özellik için Azure Identity 1.9.0 veya üzeri gerekir.

Bu hizmet etkinleştirildiğinde, herhangi bir ek yapılandırma veya kurulum olmadan kapsayıcı içindeki çoğu Azure hizmetini otomatik olarak kullanabilirsiniz. Kodunuz, Azure hizmetleriyle bir kapsayıcının dışındakiyle aynı şekilde kimlik DefaultAzureCredential doğrulaması yapabilir ve VisualStudioCredential kullanabilir. Daha fazla bilgi için Azure Identity 1.9.0 README'ye bakın.

Bu özelliği devre dışı bırakmak için Kapsayıcı AraçlarıTek Proje veya Docker Compose ayarlarındaAzure Kimlik Doğrulaması'nı etkinleştirmek için Kapsayıcılarda bir hizmet çalıştır'ıFalse olarak ayarlayın.

Dikkat

Belirteç proxy'sinin kullanılması ve belirli tanılama günlüklerinin etkinleştirilmesi olası bir güvenlik sorunu oluşturur. Bu günlükler, kimlik doğrulama kimlik bilgilerini düz metin olarak kullanıma sunabilir. Aşağıdaki ortam değişkenleri bu günlükleri etkinleştirir:

  • Tek kapsayıcı projeleri için, MS_VS_CONTAINERS_TOOLS_LOGGING_ENABLEDoturum açan %tmp%\Microsoft.VisualStudio.Containers.Tools.
  • Docker Compose projeleri için, MS_VS_DOCKER_TOOLS_LOGGING_ENABLED, oturum açan %tmp%\Microsoft.VisualStudio.DockerCompose.Tools.