Web Paketleri Dağıtma

tarafından Jason Lee

Bu konuda, Internet Information Services (IIS) Web Dağıtım Aracı (Web Dağıtımı) 2.0'ı kullanarak web dağıtım paketlerini uzak bir sunucuya nasıl yayımlayabileceğiniz açıklanmaktadır.

Bir web paketini uzak sunucuya dağıtmanın iki ana yolu vardır:

• MSDeploy.exe komut satırı yardımcı programını doğrudan kullanabilirsiniz.
• Derleme işleminin oluşturduğu [proje adı].deploy.cmd dosyasını çalıştırabilirsiniz.

Sonuç, hangi yaklaşımı kullandığınızdan bağımsız olarak aynıdır. Temel olarak, .deploy.cmd dosyasının yaptığı tek şey, MSDeploy.exe önceden belirlenmiş bazı değerlerle çalıştırmaktır, böylece paketi dağıtmak için çok fazla bilgi sağlamanız gerekmez. Bu, dağıtım işlemini basitleştirir. Öte yandan, MSDeploy.exe doğrudan kullanmak, paketinizin tam olarak nasıl dağıtılacağı konusunda size çok daha fazla esneklik sağlar.

Hangi yaklaşımı kullanacağınız, dağıtım işlemi üzerinde ne kadar denetime ihtiyacınız olduğu ve Web Dağıtımı Uzak Aracısı hizmetini mi yoksa Web Dağıtımı İşleyicisi'ni mi hedeflediğiniz de dahil olmak üzere çeşitli faktörlere bağlıdır. Bu konu başlığı altında her yaklaşımın nasıl kullanılacağı açıklanır ve her yaklaşımın ne zaman uygun olduğunu tanımlar.

Bu konudaki görevler ve izlenecek yollarda şunlar varsayılır:

• Web Uygulaması Projeleri Oluşturma ve Paketleme bölümünde açıklandığı gibi web uygulamanızı oluşturdunuz ve paketlediniz.
• Web Paketi Dağıtımı için Parametreleri Yapılandırma bölümünde açıklandığı gibi, hedef ortamınız için doğru parametre değerlerini sağlamak üzere SetParameters.xml dosyasını değiştirdiniz.

[proje adı].deploy.cmd dosyasını çalıştırmak, web paketini dağıtmanın en kolay yoludur. Özellikle .deploy.cmd dosyasını kullanmak, doğrudan MSDeploy.exe kullanmaya kıyasla şu avantajları sunar:

• Web dağıtım paketinin konumunu belirtmeniz gerekmez; .deploy.cmd dosyası nerede olduğunu zaten bilir.
• SetParameters.xml dosyasının konumunu belirtmeniz gerekmez; .deploy.cmd dosyası dosyanın nerede olduğunu zaten bilir.
• Kaynak ve hedef MSDeploy sağlayıcılarını belirtmeniz gerekmez; .deploy.cmd dosyası hangi değerlerin kullanılacağını zaten bilir.
• MSDeploy işlem ayarlarını belirtmeniz gerekmez; .deploy.cmd dosyası MSDeploy.exe komutuna sık gereken değerleri otomatik olarak ekler.

Bir web paketi dağıtmak için .deploy.cmd dosyasını kullanmadan önce şunları sağlamanız gerekir:

• .deploy.cmd dosyası, [proje adı]. SetParameters.xml dosyası ve web paketi ([proje adı].zip) aynı klasördedir.
• Web Dağıtımı (MSDeploy.exe), .deploy.cmd dosyasını çalıştıran bilgisayara yüklenir.

.deploy.cmd dosyası çeşitli komut satırı seçeneklerini destekler. Dosyayı bir komut isteminden çalıştırdığınızda, temel söz dizimi şöyledir:

[project name].deploy.cmd [/T | /Y]
                          [/M:<computer name>]
                          [/A:<Basic | NTLM>]
                          [/U:<user name>]
                          [/P:<password>]
                          [/L]
                          [/G:<true | false>]
                          [Additional MSDeploy.exe flags]

Sırasıyla bir deneme çalıştırması veya canlı dağıtım gerçekleştirmek isteyip istemediğinizi belirtmek için bir /T bayrağı veya /Y bayrağı belirtmeniz gerekir (aynı komutta her iki bayrağı da kullanmayın). Bu tabloda bu bayrakların her birinin amacı açıklanmaktadır.

Bu bayraklara ek olarak, Ek .deploy.cmd parametreleri olarak Web Dağıtımı işlem ayarlarını belirtebilirsiniz. Belirttiğiniz ek ayarlar yalnızca temel alınan MSDeploy.exe komutuna geçirilir. Bu ayarlar hakkında daha fazla bilgi için bkz . Web Dağıtımı İşlem Ayarları.

.deploy.cmd dosyasını çalıştırarak ContactManager.Mvc web uygulaması projesini bir test ortamına dağıtmak istediğinizi varsayalım. Test ortamınız, Web Dağıtımı Yayımlama için Web Sunucusu Yapılandırma (Uzak Aracı) bölümünde açıklandığı gibi Web Dağıtımı Uzak Aracısı hizmetini kullanacak şekilde yapılandırılmıştır. Web uygulamasını dağıtmak için sonraki adımları tamamlamanız gerekir.

.deploy.cmd dosyasını kullanarak bir web uygulaması dağıtmak için

1. Web Uygulaması Projelerini Oluşturma ve Paketleme bölümünde açıklandığı gibi web uygulaması projesini derleyin ve paketleyin.

2. Web Paketi Dağıtımı için Parametreleri Yapılandırma bölümünde açıklandığı gibi, ContactManager.Mvc.SetParameters.xml dosyasını test ortamınız için doğru parametre değerlerini içerecek şekilde değiştirin.

3. Bir Komut İstemi penceresi açın ve ContactManager.Mvc.deploy.cmd dosyasının konumuna gidin.

4. Bu komutu yazın ve Enter tuşuna basın:

   ContactManager.Mvc.deploy.cmd /Y /M:TESTWEB1 /A:NTLM
   

Bu örnekte:

• /Y bayrağı, deneme çalıştırması yapmak yerine paketi gerçekten dağıtmak istediğinizi gösterir.
• /M bayrağı, paketi TESTWEB1 adlı sunucuya dağıtmak istediğinizi gösterir. bu değerden MSDeploy.exe paketi şu konumdaki Web Dağıtımı Uzak Aracı hizmetine dağıtmayı deneyecektir: http://TESTWEB1/MSDeployAgentService.
• /A bayrağı NTLM kimlik doğrulamasını kullanmak istediğinizi gösterir. Bu nedenle, bir kullanıcı adı ve parola belirtmeniz gerekmez.

.deploy.cmd dosyasının kullanılmasının dağıtım işlemini nasıl kolaylaştırdığını göstermek için, yukarıda gösterilen seçenekleri kullanarak ContactManager.Mvc.deploy.cmd çalıştırdığınızda oluşturulan ve yürütülen MSDeploy.exe komutuna göz atın.

msdeploy.exe 
-source:package='C:\Users\matt.FABRIKAM\Desktop\ContactManager-03\ContactManager\
 Publish\Out\_PublishedWebsites\ContactManager.Mvc_Package\ContactManager.Mvc.zip' -dest:auto,computerName='TESTWEB1.fabrikam.net', authtype='NTLM',
 includeAcls='False' 
-verb:sync 
-disableLink:AppPoolExtension 
-disableLink:ContentExtension 
-disableLink:CertificateExtension 
-setParamFile:"C:\Users\matt.FABRIKAM\Desktop\ContactManager-03\ContactManager\
 Publish\Out\_PublishedWebsites\ContactManager.Mvc_Package\
 ContactManager.Mvc.SetParameters.xml"

Web paketini dağıtmak için .deploy.cmd dosyasını kullanma hakkında daha fazla bilgi için bkz. Nasıl yapılır: deploy.cmd Dosyasını Kullanarak Dağıtım Paketi Yükleme.

MSDeploy.exe kullanma

.deploy.cmd dosyasının kullanılması genellikle dağıtım işlemini basitleştirse de, MSDeploy.exe doğrudan kullanılmasının tercih edileceği bazı durumlar vardır. Örneğin:

• Web Dağıtımı İşleyicisi'ne yönetici olmayan bir kullanıcı olarak dağıtmak istiyorsanız, .deploy.cmd dosyasını kullanamazsınız. Bunun nedeni, Uç Nokta Konuları altında açıklandığı gibi Web Dağıtımı 2.0'daki bir hatadır.
• Farklı konumlardaki farklı SetParameters.xml dosyaları arasında el ile geçiş yapmak istiyorsanız, MSDeploy.exe doğrudan kullanmayı tercih edebilirsiniz.
• Birkaç MSDeploy.exe komut satırı bağımsız değişkenlerini geçersiz kılmak istiyorsanız, MSDeploy.exe doğrudan kullanmayı tercih edebilirsiniz.

MSDeploy.exe kullandığınızda, üç önemli bilgi parçası sağlamanız gerekir:

• Verilerinizin nereden geldiğini gösteren bir –source parametresi.
• Verilerinizin nereye gittiğini gösteren bir –dest parametresi.
• Gerçekleştirmek istediğiniz işlemi gösteren bir –fiil parametresi.

MSDeploy.exe, kaynak ve hedef verileri işlemek için Web Dağıtımı sağlayıcılarına dayanır. Web Dağıtımı, birlikte çalışabileceği uygulama ve veri kaynakları aralığını temsil eden çok sayıda sağlayıcı içerir; örneğin, SQL Server veritabanları, IIS web sunucuları, sertifikalar, genel derleme önbelleği (GAC) derlemeleri, çeşitli farklı yapılandırma dosyaları ve çok sayıda başka veri türü için sağlayıcılar vardır. Hem –source parametresi hem de –dest parametresi , –source:[providerName]=[location] biçiminde bir sağlayıcı belirtmelidir. Iis web sitesine bir web paketi dağıtırken şu değerleri kullanmanız gerekir:

• –kaynak sağlayıcısı her zaman pakettir. Örneğin:

  -source:package='[path to web package]'
  

• –dest sağlayıcısı her zaman otomatiktir. Mesela:

  -dest:auto='[server name or service URL]'
  

• –fiil her zaman eşitlenir.

  -verb:sync
  

Buna ek olarak, sağlayıcıya özgü çeşitli ayarları ve genel işlem ayarlarını belirtmeniz gerekir. Örneğin, ContactManager.Mvc web uygulamasını bir hazırlama ortamına dağıtmak istediğinizi varsayalım. Dağıtım, Web Dağıtımı İşleyicisi'ni hedefler ve temel kimlik doğrulamasını kullanmalıdır. Web uygulamasını dağıtmak için sonraki adımları tamamlamanız gerekir.

Erişim belirteci kullanarak MSDeploy.exe kullanarak web uygulaması dağıtmak için

MSDeploy V3, taşıyıcı belirteç olarak da bilinen erişim belirteci ile kimlik doğrulamayı destekler. Erişim belirteçleri en güvenli oldukları için önerilir.

1. Web Uygulaması Projelerini Oluşturma ve Paketleme bölümünde açıklandığı gibi web uygulaması projesini derleyin ve paketleyin.

2. ContactManager.Mvc.SetParameters.xml dosyasını, Web Paketi Dağıtımı için Parametreleri Yapılandırma bölümünde açıklandığı gibi hazırlama ortamınız için doğru parametre değerlerini içerecek şekilde değiştirin.

3. Bir Komut İstemi penceresi açın ve MSDeploy.exe konumuna gidin. Bu genellikle konumundadır %PROGRAMFILES%\IIS\Microsoft Web Deploy {version}\msdeploy.exe.

4. Erişim belirteciniz yoksa komutunu kullanarak bir belirteç oluşturun:

   az account get-access-token --query accessToken

5. Bu komutu yazın ve Enter tuşuna basın (satır sonlarını göz ardı edin):

   MSDeploy.exe
     -source:package="[path]\ContactManager.Mvc.zip"
     -dest:auto,
           computerName="https://stageweb1:8172/MSDeploy.axd?site=DemoSite",
           username="FABRIKAM\stagingdeployer",
           $CREDENTIAL_PLACEHOLDER$,
           authtype="Bearer",
           includeAcls="False",
           Password="{token}"
     -verb:sync
     -disableLink:AppPoolExtension
     -disableLink:ContentExtension
     -disableLink:CertificateExtension
     -setParamFile:"[path]\ContactManager.Mvc.SetParameters.xml"
     -allowUntrusted
   

Bu örnekte:

• –source parametresi paket sağlayıcısını belirtir ve web paketinin konumunu belirtir.
• –dest parametresi otomatik sağlayıcıyı belirtir. computerName ayarı, hedef sunucudaki Web Dağıtımı İşleyicisi'nin hizmet URL'sini sağlar. Kimlik doğrulaması ayarıBearer, kimlik doğrulaması için bir erişim belirteci kullanmak istediğinizi ve bu nedenle belirteç değerini parola olarak sağlamanız gerektiğini belirtir. includeAcls="False" ayarı, kaynak web uygulamanızdaki dosyaların erişim denetim listelerini (ACL' ler) hedef sunucuya kopyalamak istemediğinizi gösterir.
• –verb:sync bağımsız değişkeni, kaynak içeriği hedef sunucuda çoğaltmak istediğinizi gösterir.
• –disableLink bağımsız değişkenleri uygulama havuzlarını, sanal dizin yapılandırmasını veya Güvenli Yuva Katmanı (SSL) sertifikalarını hedef sunucuda çoğaltmak istemediğinizi gösterir. Daha fazla bilgi için bkz . Web Dağıtımı Bağlantı Uzantıları.
• –setParamFile parametresi, SetParameters.xml dosyasının konumunu sağlar.
• –allowUntrusted anahtarı, Web Dağıtımı'nın güvenilen bir sertifika yetkilisi tarafından verilmemiş SSL sertifikalarını kabul etmesi gerektiğini belirtir. Web Dağıtımı İşleyicisi'ne dağıtıyorsanız ve hizmet URL'sinin güvenliğini sağlamak için otomatik olarak imzalanan bir sertifika kullandıysanız, bu anahtarı eklemeniz gerekir.

MSDeploy.exe ve Temel kimlik doğrulamasını kullanarak bir web uygulaması dağıtmak için

1. Web Uygulaması Projelerini Oluşturma ve Paketleme bölümünde açıklandığı gibi web uygulaması projesini derleyin ve paketleyin.

2. ContactManager.Mvc.SetParameters.xml dosyasını, Web Paketi Dağıtımı için Parametreleri Yapılandırma bölümünde açıklandığı gibi hazırlama ortamınız için doğru parametre değerlerini içerecek şekilde değiştirin.

3. Bir Komut İstemi penceresi açın ve MSDeploy.exe konumuna gidin. Bu genellikle konumundadır %PROGRAMFILES%\IIS\Microsoft Web Deploy {version}\msdeploy.exe.

4. Bu komutu yazın ve Enter tuşuna basın (satır sonlarını göz ardı edin):

   MSDeploy.exe
     -source:package="[path]\ContactManager.Mvc.zip"
     -dest:auto,
           computerName="https://stageweb1:8172/MSDeploy.axd?site=DemoSite",
           username="FABRIKAM\stagingdeployer",
           $CREDENTIAL_PLACEHOLDER$,
           authtype="Basic",
           includeAcls="False"
     -verb:sync
     -disableLink:AppPoolExtension
     -disableLink:ContentExtension
     -disableLink:CertificateExtension
     -setParamFile:"[path]\ContactManager.Mvc.SetParameters.xml"
     -allowUntrusted
   

Bu örnekte:

• –source parametresi paket sağlayıcısını belirtir ve web paketinin konumunu belirtir.
• –dest parametresi otomatik sağlayıcıyı belirtir. computerName ayarı, hedef sunucudaki Web Dağıtımı İşleyicisi'nin hizmet URL'sini sağlar. Kimlik doğrulama ayarı, temel kimlik doğrulamasını kullanmak istediğinizi belirtir ve bu nedenle bir kullanıcı adı ve parola sağlamanız gerekir. Son olarak includeAcls="False" ayarı, kaynak web uygulamanızdaki dosyaların erişim denetim listelerini (ACL) hedef sunucuya kopyalamak istemediğinizi gösterir.
• –verb:sync bağımsız değişkeni, kaynak içeriği hedef sunucuda çoğaltmak istediğinizi gösterir.
• –disableLink bağımsız değişkenleri uygulama havuzlarını, sanal dizin yapılandırmasını veya Güvenli Yuva Katmanı (SSL) sertifikalarını hedef sunucuda çoğaltmak istemediğinizi gösterir. Daha fazla bilgi için bkz . Web Dağıtımı Bağlantı Uzantıları.
• –setParamFile parametresi, SetParameters.xml dosyasının konumunu sağlar.
• –allowUntrusted anahtarı, Web Dağıtımı'nın güvenilen bir sertifika yetkilisi tarafından verilmemiş SSL sertifikalarını kabul etmesi gerektiğini belirtir. Web Dağıtımı İşleyicisi'ne dağıtıyorsanız ve hizmet URL'sinin güvenliğini sağlamak için otomatik olarak imzalanan bir sertifika kullandıysanız, bu anahtarı eklemeniz gerekir.

Web Paketi Dağıtımlarını Otomatikleştirme

Birçok kurumsal senaryoda, web paketlerinizi daha büyük bir tek adımlı veya otomatik dağıtım kapsamında dağıtmak isteyeceksiniz. Web paketlerinizi .deploy.cmd dosyasını çalıştırarak veya doğrudan MSDeploy.exe kullanarak dağıtmayı seçmenizden bağımsız olarak, komutlarınızı parametreleştirebilir ve bir Microsoft Build Engine (MSBuild) proje dosyasındaki bir hedeften çağırabilirsiniz.

Contact Manager örnek çözümünde Publish.proj dosyasındaki PublishWebPackages hedefini inceleyin. Bu hedef, PublishPackages adlı bir öğe listesi tarafından tanımlanan her .deploy.cmd dosyası için bir kez çalışır. Hedef, her .deploy.cmd dosyası için tam bir bağımsız değişken değerleri kümesi oluşturmak için özellikleri ve öğe meta verilerini kullanır ve ardından komutu çalıştırmak için Exec görevini kullanır.

<Target Name="PublishWebPackages" Outputs="%(PublishPackages.Identity)">
  ...
  <PropertyGroup>
    <_WhatIfSwitch>/Y</_WhatIfSwitch>
    <_WhatIfSwitch Condition=" '$(_WhatIf)'=='true' ">/T</_WhatIfSwitch>
    <_Cmd>
      %(PublishPackages.FullPath) $(_WhatifSwitch) /M:$(MSDeployComputerName) 
      /U:$(MSDeployUsername) /P:$(Password) /A:$(MSDeployAuth) 
      %(PublishPackages.AdditionalMSDeployParameters)
    </_Cmd>
  </PropertyGroup>
  <Exec Command="$(_Cmd)"/>
</Target>

Uç Nokta Konuları

Web paketinizi .deploy.cmd dosyasını çalıştırarak mı yoksa doğrudan MSDeploy.exe kullanarak mı dağıttığınızdan bağımsız olarak, dağıtımınız için bir bilgisayar adı veya hizmet uç noktası belirtmeniz gerekir.

Hedef web sunucusu, Web Dağıtımı Uzak Aracı hizmeti kullanılarak dağıtım için yapılandırıldıysa, hedef hizmet URL'sini hedefiniz olarak belirtirsiniz.

http://[server name]/MSDeployAgentService

Alternatif olarak, hedef olarak sunucu adını tek başına belirtebilirsiniz ve Web Dağıtımı uzak aracı hizmeti URL'sini çıkarsar.

[server name]

Hedef web sunucusu Web Dağıtımı İşleyicisi kullanılarak dağıtım için yapılandırılmışsa, hedefiniz olarak IIS Web Yönetimi Hizmeti(WMSvc) uç nokta adresini belirtmeniz gerekir. Bu, varsayılan olarak şu biçimi alır:

https://[server name]:8172/MSDeploy.axd

.deploy.cmd dosyasını veya doğrudan MSDeploy.exe kullanarak bu uç noktalardan herhangi birini hedefleyebilirsiniz. Ancak, Web Dağıtımı İşleyicisi'ne yönetici olmayan bir kullanıcı olarak dağıtmak istiyorsanız, Web Dağıtımı Yayımlama için Web Sunucusu Yapılandırma (Web Dağıtımı İşleyicisi) bölümünde açıklandığı gibi, hizmet uç noktası adresine bir sorgu dizesi eklemeniz gerekir.

https://[server name]:8172/MSDeploy.axd?site=[IIS website name]

Bunun nedeni yönetici olmayan kullanıcının IIS'ye sunucu düzeyinde erişimi olmamasıdır; yalnızca belirli bir IIS web sitesine erişebilir. Yazma sırasında, Web Yayımlama İşlem Hattı'ndaki (WPP) bir hata nedeniyle, sorgu dizesi içeren bir uç nokta adresi kullanarak .deploy.cmd dosyasını çalıştıramazsınız. Bu senaryoda, doğrudan MSDeploy.exe kullanarak web paketinizi dağıtmanız gerekir.

Kimlik DoğrulamasıNda Dikkat Edilmesi Gerekenler

web paketinizi .deploy.cmd dosyasını çalıştırarak mı yoksa doğrudan MSDeploy.exe kullanarak mı dağıttığınızdan bağımsız olarak, bir kimlik doğrulama türü belirtmeniz gerekir. Web Dağıtımı olası değerleri kabul eder: Taşıyıcı, NTLM veya Temel. Taşıyıcı belirtirseniz, parola olarak belirteci ve kullanıcı adı için herhangi bir değeri sağlamanız gerekir. Temel kimlik doğrulamasını belirtirseniz, bir kullanıcı adı ve parola da sağlamanız gerekir. Bir kimlik doğrulama türünü seçtiğinizde bilmeniz gereken çeşitli faktörler vardır:

• Web Dağıtımı Uzak Aracı hizmetine dağıtıyorsanız NTLM kimlik doğrulamasını kullanmanız gerekir. Uzak aracı hizmeti temel kimlik doğrulama kimlik bilgilerini kabul etmez.
• Web Dağıtım İşleyicisi'ne dağıtıyorsanız erişim belirteci (taşıyıcı belirteci), NTLM veya temel kimlik doğrulaması kullanabilirsiniz. Varsayılan ayar temel kimlik doğrulamasıdır. Temel kimlik doğrulaması, düz metin olarak iletilen kullanıcı adlarına ve parolalara dayanır; Web Dağıtımı İşleyicisi her zaman SSL şifrelemesi kullandığından kimlik bilgileriniz korunur. En güvenli yöntem, gerçek parola gönderilmesini önleyen bir erişim belirteci kullanmaktır.
• Web paketiniz bir veritabanı içeriyorsa ve web sunucusu ve veritabanı sunucusu ayrı makinelerse, NTLM "çift atlama" sınırlaması nedeniyle NTLM kimlik doğrulamasını kullanarak veritabanını dağıtamazsınız. Dağıtım bağlantı dizesi SQL Server kimlik bilgilerini kullanmanız veya Web Dağıtımına temel kimlik doğrulama kimlik bilgileri sağlamanız gerekir. Bu sorun, Üyelik Veritabanlarını Kurumsal Ortamlara Dağıtma başlığında daha ayrıntılı olarak açıklanmıştır.

Sonuç

Bu konuda, .deploy.cmd dosyasını çalıştırarak veya doğrudan MSDeploy.exe kullanarak bir web paketini nasıl dağıtabileceğiniz açıklanmıştır. Her yaklaşımın ne zaman uygun olabileceğini açıklar ve daha büyük bir tek adımlı veya otomatik derleme işleminin parçası olarak bir dağıtım komutunu nasıl parametreleştirebileceğinizi ve çalıştırabileceğinizi açıklar.

Daha Fazla Bilgi

Web dağıtım paketi oluşturma ve parametreleştirme yönergeleri için bkz . Web Uygulaması Projeleri Oluşturma ve Paketleme ve Web Paketi Dağıtımı için Parametreleri Yapılandırma. Team Foundation Server (TFS) örneğinden web paketleri oluşturma ve dağıtma hakkında yönergeler için bkz . Team Foundation Server'ı Otomatik Web Dağıtımı için Yapılandırma. Dağıtım işlemini özelleştirme ve sorun giderme hakkında bilgi için bkz . Dosyaları ve Klasörleri Dağıtımdan Dışlama.