Bagikan melalui

Microsoft Web Deploy v3 Readme

oleh Harsh Mittal

Gambaran Umum

Web Deploy adalah alat untuk menyederhanakan migrasi, manajemen, dan penyebaran aplikasi Web, situs, dan server. Ini dapat digunakan untuk mengemas situs Web, secara otomatis termasuk konten, konfigurasi, sertifikat, dan database. Ini dapat digunakan untuk menyinkronkan antara IIS 6.0, IIS 7.x dan IIS8.0, atau untuk bermigrasi dari IIS 6.0, IIS7.x ke IIS 7.x ke atas. Paket yang dibuat dapat digunakan untuk penerapan versi, pencadangan, atau penyebaran.

Fitur

Web Deploy mencakup fitur-fitur utama ini:

Situs web paket dan aplikasi: Pengembang atau administrator dapat mengemas konfigurasi dan konten aplikasi Web yang diinstal, termasuk database SQL, dan menggunakan paket untuk penyimpanan atau penyebaran ulang. Paket-paket ini kemudian dapat disebarkan menggunakan antarmuka Manajer IIS tanpa memerlukan hak administratif di server jarak jauh.

Mendelegasikan tugas penyebaran ke non-admin. Administrator server dapat memilih untuk mendelegasikan tugas penyebaran kepada pengguna yang bukan administrator. Misalnya, di lingkungan hosting bersama dan perusahaan, menyebarkan konten dan menandai folder sebagai aplikasi dapat didelegasikan. Tugas yang lebih canggih yang cocok untuk lingkungan khusus, seperti mengizinkan sertifikat, situs Web, atau perakitan GAC untuk disebarkan, juga dapat diaktifkan.

Menyederhanakan penyebaran untuk administrator. Administrator server akan menemukan delegasi yang berguna, karena menyebarkan aplikasi Web termasuk perakitan GAC, sertifikat dan kumpulan aplikasi dapat memakan waktu bahkan dengan semua izin yang diperlukan.

Migrasi dari IIS 6.0 dan IIS7: Operasi migrasi memberi administrator cara untuk memigrasikan situs atau seluruh server dari IIS 6.0 ke IIS 7 ke atas, IIS7 ke IIS8 termasuk pengaturan dan konten mereka. Migrasi pada dasarnya adalah cara menyinkronkan, difilter berdasarkan aturan migrasi.

Sinkronisasi IIS 6.0 / IIS 7/IIS8.0 Operasi sinkronisasi memberi administrator cara untuk menyinkronkan situs atau server dengan cepat dan menyebarkan perubahan ke situs dan server yang ada. Sinkronisasi memungkinkan Anda menyinkronkan satu sumber dengan satu tujuan. Misalnya, Anda dapat menyinkronkan dua jalur direktori atau dua server web. Sinkronisasi dapat dilakukan dengan objek lokal atau jarak jauh.

Rekam jepret IIS 7.0 ke atas Rekam jepret, atau arsip, fungsionalitas memungkinkan administrator atau pengembang untuk dengan cepat mengambil arsip situs web atau server mereka untuk tujuan putar kembali, pemulihan, atau pencadangan. Fitur rekam jepret otomatis juga memungkinkan administrator situs web untuk melakukan layanan mandiri beberapa tugas di atas.

Analisis Dependensi pada IIS 6.0 ke atas Operasi analisis memungkinkan administrator untuk memeriksa komponen apa yang diinstal pada server sumber. Dengan cara ini, mereka dapat menentukan apakah fitur ada yang akan mereka butuhkan di IIS 7.0 atau yang memerlukan pengaturan yang lebih canggih daripada hanya menyalin file.

Pemecahan Masalah dan Validasi. Untuk memvalidasi operasi, parameter -whatif memungkinkan administrator untuk melihat tindakan apa yang akan terjadi ketika mereka melakukan operasi. Ini sangat berguna untuk melakukan sinkronisasi atau migrasi, ketika mereka ingin memvalidasi perubahan apa yang akan dilakukan sebelum melakukannya. Untuk pemecahan masalah, parameter -verbose memungkinkan administrator untuk mendapatkan detail yang kaya tentang operasi apa yang dilakukan, dan setelah kegagalan, kemampuan untuk mendiagnosis masalah.

Sinkronisasi Diferensial. Alat ini hanya akan menyinkronkan apa yang telah berubah antara sumber dan tujuan.

Pembuatan Skrip mudah melalui PowerShell: Tugas Umum Web Deploy dapat diotomatisasi menggunakan cmdlet PowerShell.

Catatan Penginstalan

Persyaratan

Prasyarat berikut harus dipenuhi untuk menginstal alat:

· Anda harus menginstal .NET 2.0 SP1 atau yang lebih baru.

Mengunduh dan Menginstal

Ada dua paket terpisah yang dapat diunduh untuk alat ini; Anda harus mengunduh paket yang sesuai. Anda dapat mengunduh versi (x86) atau (x64).

Masalah Penting Diperbaiki dalam rilis ini:

Perubahan: Di versi Web Sebelumnya, Sebarkan layanan tempAgent akan selalu berjalan pada port 80. Di Web Deploy v3 RC port ini dapat diubah dengan menentukan port baru dalam argumen computername menggunakan format computername=serverName:#### , tempagent=true (di mana #### adalah nomor port yang akan digunakan)

Perubahan: Memperbaiki masalah dengan Web Deploy di mana jumlah perubahan tidak akurat untuk operasi -whatif saat menggunakan opsi -useCheckSum.

Perubahan: Web Deploy V3 Secara otomatis menonaktifkan pengaturan proksi. Ini sebelumnya merupakan masalah bagi beberapa klien, yang diharuskan membuka Internet Explorer dan menonaktifkan pengaturan proksi di sana sebelum memulai sinkronisasi.

Perubahan: Menambahkan dukungan untuk pengikatan gaya IPv6 dalam logika sinkronisasi sertifikat. Versi sebelumnya tidak dapat menyinkronkan pengikatan IPv6 dengan benar.

Perubahan: Saat menyinkronkan kunci registri anak ke server di mana kunci registri induk tidak ada, kunci registri induk hingga kunci anak sekarang akan dibuat (tanpa nilai) daripada sinkronisasi gagal. Misalnya, jika menyinkronkan kunci registri HKEY_LOCAL_MACHINE\SOFTWARE\MySoft\TestWeb1 di mana kunci MySoft tidak ada di komputer tujuan, kunci MySoft akan dibuat pada komputer tujuan yang memungkinkan sinkronisasi akan berhasil.

Perubahan: Dalam beberapa kasus, penerbitan Web Deploy menghapus izin yang diwariskan pada folder akar situs. Web Deploy V3 memperbaiki masalah ini.

Masalah Umum

Masalah: Peningkatan Web Deploy v3 memutus sinkronisasi SQLite yang berfungsi menggunakan Web Deploy v2

File konfigurasi default web Deploy v3 yang dapat dieksekusi (msdeploy.exe.config dan msdepsvc.exe.config) telah diperbarui dari .Net 2.0 ke .Net 4.0, yang menghasilkan jeda ini.

Solusi:

  • SQLite memiliki versi yang kompatibel dengan .Net 4. Menyalin sqlite3.exe dari rilis ini di direktori "%ProgramFiles%\IIS\Microsoft Web Deploy V3" akan mengatasi masalah tersebut.
  • Ubah versi .Net default untuk WebDeploy V3 msdeploy.exe.config ke .Net 2.0 seperti yang ditunjukkan di bawah ini
<configuration>
  <startup>
    <supportedRuntime version="v2.0.50727" />
    <supportedRuntime version="v4.0" />
  </startup>
</configuration>

Masalah: Layanan Agen Penyebaran Web tidak berfungsi dengan akun pengguna lokal yang bukan akun pengguna Administrator, tetapi merupakan anggota grup Administrator. ERROR_USER_NOT_ADMIN kesalahan dikembalikan.

Layanan Agen Jarak Jauh menerima kredensial Administrator bawaan atau Administrator Domain , kredensial administrator lainnya tidak akan berfungsi dan akan menyebabkan kesalahan ini.

Solusi:

Gunakan akun administrator bawaan atau akun pengguna domain (bagian dari grup admin di komputer lokal). Layanan Agen Jarak Jauh menerima kredensial Administrator bawaan atau Administrator Domain. Jika Anda memiliki penyiapan non-domain dan ingin menggunakan akun lain yang merupakan administrator bawaan, lakukan hal berikut:

  • Buat grup pengguna terpisah MSDepSvcUsers di komputer jarak jauh.
  • Memutus akun lokal A di komputer jarak jauh & lokal.
  • Tambahkan A ke MSDepSvcUsers di komputer jarak jauh.
  • Gunakan akun A untuk menerbitkan, ini akan memungkinkan Anda untuk menerbitkan tanpa perlu menggunakan akun admin bawaan.

Masalah: Beberapa aturan delegasi Layanan Manajemen tidak berfungsi setelah Web Deploy dimutakhirkan ke Web Deploy 3.0

Jika server IIS 7+ menggunakan konfigurasi bersama, aturan delegasi tertentu dengan identitas runAs yang diatur ke SpecificUser akan berhenti berfungsi. Ini karena alat penginstal Web Deploy dan skrip .\AddDelegationRules.ps1 membuat akun pengguna komputer lokal dan menetapkannya sebagai identitas runAs pada aturan delegasi tertentu. Akun pengguna ini tidak akan dikenali di komputer lain dan dengan demikian aturan tidak akan berfungsi dalam konfigurasi bersama.
Workarounds:

· Jika aturan delegasi Anda telah ditimpa, buat ulang aturan yang terpengaruh secara manual.

Masalah: Tidak dapat menerbitkan ke situs yang dibuat dengan skrip PowerShell SetupSiteForPublish.ps1 atau dikonfigurasi untuk penerbitan Web Deploy melalui "Konfigurasi untuk Penerbitan Penyebaran Web..." UI

Skrip pembuatan situs serta UI untuk mengonfigurasi Web Deploy untuk situs yang sudah ada mengatur URL penerbitan ke https://myserver:8172/msdeploy.axd. Nama komputer ini umumnya dapat dijangkau dalam jaringan. Namun, sering kali tidak dapat dijangkau dari luar jaringan, sehingga harus diganti dengan nama DNS publik.

Workarounds:

  • Dari skrip: Skrip tidak memperingatkan tentang kesalahan ini. Ganti URL dengan url yang benar (seperti di bawah) dalam file pengaturan yang dihasilkan.
  • Dari UI: masukkan nama DNS publik di bidang "Tentukan URL untuk koneksi server penerbitan" misalnya, bukan https://myserver:8172/msdeploy.axd, masukkan https://some.publicDnsName.com:8172/msdeploy.axd.

Masalah: Paket yang dibuat dengan Web Deploy V3 Tidak berfungsi dengan WebDeploy V2. Ini menghasilkan System.NullReferenceException.

Workarounds:

  • Mutakhirkan komputer target ke Web Deploy v3
  • Gunakan Web Deploy V2 untuk membuat paket.

Masalah: UI Penyebaran Web di Manajer IIS memberikan kesalahan "Tidak dapat mentransmisikan objek jenis"

Jika komputer tujuan telah menginstal Web Deploy v1.1 dan komputer sumber telah menginstal v2, Anda mungkin melihat kesalahan ini. Ini adalah ketidakcocokan lintas versi.

Workarounds:

  • Mutakhirkan komputer sumber ke Web Deploy v2
  • Hapus instalan semua versi Web Deploy pada komputer sumber

Masalah: Jika Anda menyinkronkan mesin IIS 6.0 dengan banyak situs (menyebabkan metabase lebih dari 500MB), maka alat tersebut mungkin macet dan berhenti merespons.
Solusi:

Buat daftar situs dan sinkronkan setiap situs satu per satu.

Masalah: Jika Anda menyinkronkan dari komputer ke komputer jarak jauh di mana konten atau konfigurasi bersama berada di komputer ketiga yang terpisah (yaitu, UNC), maka agen jarak jauh tidak akan dapat mengautentikasi dengan benar.
Solusi:

Sinkronkan secara manual atau gunakan Penangan Penyebaran Web sebagai gantinya.

Masalah: Jika Anda mengubah pengaturan konfigurasi bersama (seperti mengaktifkan atau menonaktifkan konfigurasi bersama), Anda harus memulai ulang agen jarak jauh setelahnya.
Solusi:

Mulai ulang agen setelah membuat perubahan pada konfigurasi bersama.

Masalah: Jika Anda menyinkronkan situs Web di mana jalurnya adalah %systemdrive%\wwwroot ke situs Web tujuan di mana drive sistem berbeda (C: bukan D:), maka jalur situs Web Anda akan diperluas di tujuan. Ini berarti jika Anda telah berbagi konfigurasi berarti dengan drive sistem yang berbeda dan Anda mengandalkan %systemdrive% untuk memastikan konten berfungsi, Anda dapat merusak situs di komputer.
Solusi:

Tambahkan aturan ganti untuk mengubah jalur selama sinkronisasi.

Masalah: Jika Anda mencoba mengemas ke file paket yang ada, ini mungkin tidak berfungsi dengan benar.
Solusi:

Gunakan nama baru atau hapus file paket lama sebelum membuat paket baru.

Masalah: Penyebaran Web Microsoft tidak akan memindahkan file fisik untuk peta Skrip dan item yang direferensikan dalam Daftar Pembatasan Ekstensi Layanan Web, kecuali file terletak di direktori konten situs Web. Ini karena banyak ISAPI mungkin tidak bermigrasi dengan benar, seperti:

  • ASP.NET (memerlukan penginstalan).
  • WebDAV (yang tidak disertakan dalam Windows Server 2008 secara default dan memerlukan penginstalan tambahan).
  • Ekstensi Server FrontPage (yang tidak disertakan dalam Windows Server 2008 secara default dan memerlukan penginstalan tambahan).

Solusi:

Sertakan peta skrip atau file apa pun secara manual yang tidak memerlukan penginstalan dalam file manifes. Lihat Bantuan untuk informasi selengkapnya tentang membuat file manifes.

Masalah: File kepercayaan kustom yang dirujuk dalam pengaturan kebijakan Web.config tingkat akar dan Keamanan Akses Kode (CAS) tidak akan dipindahkan.
Solusi:

Tentukan file kepercayaan kustom secara manual dan file kebijakan CAS, security.config, dalam file manifes. Lihat file Bantuan untuk informasi selengkapnya tentang membuat file manifes.

Masalah: Jika Anda memindahkan situs ke server yang memiliki tingkat kepercayaan yang berbeda, Anda tidak akan menerima peringatan.
Solusi:

Pastikan bahwa tingkat kepercayaan diatur dengan benar pada komputer tujuan saat melakukan sinkronisasi tingkat situs atau migrasi.

Masalah: Jika Anda memiliki file manifes kustom yang menunjuk ke sumber yang tidak valid, Anda mungkin tidak menerima kesalahan.
Solusi:

Jika Anda tidak melihat output yang diharapkan saat menggunakan file manifes, coba setiap item satu per satu untuk melihat apakah item tersebut salah ketik atau tidak valid.

Masalah: FTP dan SMTP tidak disertakan dalam definisi default untuk webserver60.
Solusi:

Jika Anda perlu menyinkronkan lokasi ini, sinkronkan secara manual menggunakan penyedia metakey - yaitu, metakey=lm/msftpsvc.

Masalah: Properti yang diwariskan tidak dimigrasikan dengan migrasi situs IIS 6.0. Contoh umumnya adalah autentikasi yang diatur di tingkat server dengan semua situs mewarisi properti ini. Saat Anda memigrasikan satu situs, sekarang akan mewarisi pengaturan server tujuan baru. Jika pengaturan server tujuan tidak sama, situs Anda bisa rusak. Ini berlaku untuk setiap properti yang diwariskan, termasuk peta mime, peta skrip, dll.
Solusi:

Gunakan bendera metadataGetInherited untuk menyalin pengaturan yang diwariskan ke tingkat situs saat Anda menyinkronkan atau memigrasikan situs web di IIS 6.0. Atau pastikan pengaturan server sama pada server sumber dan tujuan atau atur situs secara manual untuk menggunakan pengaturan yang benar.

Pemecahan Masalah Penginstalan

Jika Anda mengalami masalah selama penginstalan, Anda dapat menjalankan perintah yang sesuai yang tercantum di bawah ini untuk versi Windows Anda untuk membuat file log yang akan berisi informasi tentang proses penginstalan:

msiexec /L msdeployinstall.log /I <path_to_msi>

msiexec /L msdeployinstall.log /I <path_to_msi>

Anda dapat menganalisis file log ini setelah penginstalan yang gagal untuk membantu menentukan penyebab kegagalan.

Untuk informasi lebih lanjut

Sumber daya tambahan berikut untuk Web Deploy tersedia di IIS.net:

  • Panduan Penyebaran Web. Menjelaskan cara mengunduh dan menginstal Web Deploy, cara menggunakannya untuk operasi sinkronisasi atau migrasi dan banyak lagi.
  • Selain itu, pastikan untuk mengunjungi Blog Tim Penyebaran Web untuk tips, trik, dan informasi terbaru tentang alat ini.
  • Last updated on