Dapatkan pengaturan penerbitan dari IIS dan impor ke Visual Studio

Anda dapat menggunakan alat Terbitkan untuk mengimpor pengaturan penerbitan dan kemudian menerapkan aplikasi Anda. Dalam artikel ini, kami menggunakan pengaturan penerbitan untuk IIS.

Langkah-langkah ini berlaku untuk aplikasi web ASP.NET dan ASP.NET Core.

Nota

File pengaturan penerbitan (*.publishsettings) berbeda dari profil penerbitan (*.pubxml). File pengaturan penerbitan dibuat di IIS, lalu dapat diimpor ke Visual Studio. Visual Studio membuat profil penerbitan.

Prasyarat

Visual Studio diinstal dengan beban kerja ASP.NET dan pengembangan web. Jika Anda telah menginstal Visual Studio:
- Instal pembaruan terbaru di Visual Studio dengan memilih Bantuan >Periksa Pembaruan.
- Tambahkan beban kerja dengan memilih Alat >Dapatkan Alat dan Fitur.
Di server Anda, Anda harus menjalankan Windows Server 2012 atau yang lebih tinggi, dan Anda harus memiliki peran IIS Web Server diinstal dengan benar (diperlukan untuk menghasilkan file pengaturan penerbitan (.publishsettings). ASP.NET 4.5 atau versi ASP.NET Core yang benar juga harus diinstal di server. Langkah-langkah dalam tutorial ini diuji di Windows Server 2022 dan IIS 10.
- Untuk mengonfigurasi ASP.NET Core, lihat Host ASP.NET Core di Windows dengan IIS. Untuk ASP.NET Core, pastikan Anda mengonfigurasi Kumpulan Aplikasi untuk menggunakan Tanpa Kode Terkelola, seperti yang dijelaskan dalam artikel.
- Untuk menyiapkan ASP.NET 4.5, lihat IIS 8.0 Menggunakan ASP.NET 3.5 dan ASP.NET 4.5.
Nota

IIS di Windows tidak mendukung pembuatan pengaturan penerbitan. Namun, Anda masih dapat menerbitkan ke IIS menggunakan alat Terbitkan di Visual Studio.

Menginstal dan mengonfigurasi Web Deploy di Windows Server

Web Deploy menyediakan fitur konfigurasi tambahan yang memungkinkan pembuatan file pengaturan penerbitan dari UI.

Nota

Penginstal Platform Web mencapai Akhir Masa Pakai pada 7/1/22. Untuk informasi selengkapnya, lihat Penginstal Platform Web - Akhir dukungan dan penghentian umpan data produk/aplikasi. Anda dapat langsung menginstal Web Deploy 4.0 untuk membuat file pengaturan penerbitan.

Jika Anda belum menginstal IIS Management Scripts and Tools, instal sekarang.

Buka Pilih peran server>Web Server (IIS)>Alat Manajemen, lalu pilih peran Skrip dan Alat Manajemen IIS, klik Berikutnya, lalu instal peran tersebut.

Skrip dan alat diperlukan untuk mengaktifkan pembuatan file pengaturan penerbitan.

Pastikan Anda juga menginstal Management Service dan IIS Management Console (mungkin sudah terinstal).
Di Windows Server, mengunduh Web Deploy 4.0.
Jalankan program penginstalan Web Deploy, dan pastikan Anda memilih Selesaikan penginstalan alih-alih penginstalan umum.

Dengan penginstalan lengkap, Anda mendapatkan komponen yang Anda butuhkan untuk membuat file pengaturan penerbitan. (Jika Anda memilih Kustom sebagai gantinya, Anda dapat melihat daftar komponen, seperti yang diperlihatkan dalam ilustrasi berikut.)

Cuplikan layar
(Opsional) Verifikasi bahwa Penyebaran Web berjalan dengan benar dengan membuka Sistem Panel > Kontrol dan Layanan Alat > Windows Keamanan>, lalu pastikan bahwa:
- Layanan Agen Penyebaran Web berjalan (nama layanan berbeda dalam versi yang lebih lama).
- Layanan Manajemen Web sedang berjalan.
Jika salah satu layanan agen tidak berjalan, mulai ulang kembali Layanan Agen Penyebaran Web.

Jika Layanan Agen Penyebaran Web tidak ada sama sekali, buka Control Panel > Program > Hapus instalan program, temukan Microsoft Web Deploy versi <>. Pilih untuk mengubah penginstalan dan pastikan Anda memilih akan diinstal ke hard drive lokal untuk komponen Web Deploy. Selesaikan langkah-langkah penginstalan perubahan.

Membuat file pengaturan penerbitan di IIS di Windows Server

Tutup dan buka kembali Konsol Manajemen IIS untuk menampilkan opsi konfigurasi yang diperbarui di UI.
Di IIS, klik kanan Situs Web Default, pilih Penyebaran>Konfigurasi Penerbitan Penyebaran Web.

konfigurasi Web Deploy

Jika Anda tidak melihat menu Sebarkan, lihat bagian sebelumnya untuk memverifikasi bahwa Penyebaran Web sedang berjalan.
Dalam kotak dialog Konfigurasi Penerbitan Penyebaran Web, periksa pengaturan.
Klik Penyetelan.

Di panel Hasil , output menunjukkan bahwa hak akses diberikan kepada pengguna yang ditentukan, dan bahwa file dengan .publishsettings ekstensi file telah dibuat di lokasi yang diperlihatkan dalam kotak dialog.
```
<?xml version="1.0" encoding="utf-8"?>
<publishData>
  <publishProfile
    publishUrl="https://myhostname:8172/msdeploy.axd"
    msdeploySite="Default Web Site"
    destinationAppUrl="http://myhostname:80/"
    profileName="Default Settings"
    publishMethod="MSDeploy"
    userName="myhostname\myusername" />
</publishData>
```
Bergantung pada konfigurasi Windows Server dan IIS, Anda akan melihat nilai yang berbeda dalam file XML. Berikut adalah beberapa detail tentang nilai yang Anda lihat:
- File msdeploy.axd yang dirujuk dalam atribut publishUrl adalah file handler HTTP yang dihasilkan secara dinamis untuk Web Deploy. (Untuk tujuan pengujian, http://myhostname:8172 umumnya juga berfungsi.)
- Port publishUrl diatur ke port 8172, yang merupakan default untuk Web Deploy.
- Port destinationAppUrl diatur ke port 80, yang merupakan default untuk IIS.
- Jika, di langkah selanjutnya, Anda tidak dapat tersambung ke host jarak jauh dari Visual Studio menggunakan nama host, uji alamat IP server sebagai pengganti nama host.
  
  Nota
  
  Jika Anda menerbitkan ke IIS yang berjalan di Azure VM, Anda harus membuka port masuk untuk Web Deploy dan IIS di grup Keamanan Jaringan. Untuk informasi terperinci, lihat Buka port ke komputer virtual.
Salin file ini ke komputer tempat Anda menjalankan Visual Studio.

Impor pengaturan penerbitan di Visual Studio dan sebarkan

Di komputer tempat Anda membuka proyek ASP.NET di Visual Studio, klik kanan proyek di Penjelajah Solusi, dan pilih Terbitkan.

Jika sebelumnya Anda mengonfigurasi profil penerbitan apa pun, panel Terbitkan akan muncul. Klik Baru atau Buat Profil Baru.
Pilih opsi untuk mengimpor profil.

Dalam kotak dialog Terbitkan, klik Impor Profil.
Navigasi ke lokasi file pengaturan penerbitan yang Anda buat di bagian sebelumnya.
Dalam dialog Impor File Pengaturan Penerbitan, buka dan pilih profil yang Anda buat di bagian sebelumnya, dan klik Buka.

Klik Selesai untuk menyimpan profil penerbitan, lalu klik Terbitkan.

Visual Studio memulai proses penyebaran, dan jendela Output menampilkan kemajuan dan hasil.

Jika Anda mendapatkan kesalahan penyebaran, klik Tindakan> LainnyaEdit untuk mengedit pengaturan. Ubah pengaturan dan klik Validasi untuk menguji pengaturan baru. Jika nama host tidak ditemukan, coba alamat IP alih-alih nama host di bidang Server dan URL Tujuan .

Setelah aplikasi berhasil disebarkan, aplikasi akan dimulai secara otomatis.

Masalah umum

Pertama, periksa jendela Output di Visual Studio untuk informasi status, dan periksa pesan kesalahan Anda. Sebagai tambahan:

Jika Anda tidak dapat tersambung ke host menggunakan nama host, coba alamat IP sebagai gantinya.
Pastikan port yang diperlukan terbuka di server jarak jauh.
Untuk ASP.NET Core, di IIS Anda perlu memastikan bahwa bidang Kumpulan aplikasi (Versi CLR.NET pada IIS 10) untuk DefaultAppPool diatur ke Tanpa Kode Terkelola.
Verifikasi bahwa versi ASP.NET yang digunakan di aplikasi Anda sama dengan versi yang Anda instal di server. Untuk aplikasi Anda, Anda dapat melihat dan mengatur versi di halaman Properti. Untuk mengatur aplikasi ke versi yang berbeda, versi tersebut harus diinstal.
Jika aplikasi mencoba membuka, tetapi Anda melihat peringatan sertifikat, pilih untuk mempercayai situs. Jika Anda sudah menutup peringatan, Anda dapat mengedit file *.pubxml di proyek Anda dan menambahkan elemen berikut: <AllowUntrustedCertificate>true</AllowUntrustedCertificate>. Pengaturan ini hanya untuk pengujian!
Jika aplikasi tidak dimulai dari Visual Studio, mulai aplikasi di IIS untuk menguji bahwa aplikasi disebarkan dengan benar.

Host ASP.NET Core di Windows dengan IIS

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-10-03