Menyebarkan file ke App Service

Catatan

Mulai 1 Juni 2024, semua aplikasi App Service yang baru dibuat akan memiliki opsi untuk menghasilkan nama host default yang unik menggunakan konvensi <app-name>-<random-hash>.<region>.azurewebsites.netpenamaan . Nama aplikasi yang ada akan tetap tidak berubah.

Contoh: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Untuk detail lebih lanjut, lihat Nama Host Default Unik untuk Sumber Daya App Service.

Artikel ini menunjukkan cara menyebarkan kode Anda sebagai paket ZIP, WAR, JAR, atau EAR ke Azure App Service. Artikel ini juga menunjukkan cara menyebarkan file individual ke App Service, terpisah dari paket aplikasi Anda.

Prasyarat

Untuk menyelesaikan langkah-langkah dalam artikel, buat aplikasi App Service, atau gunakan aplikasi yang Anda buat untuk tutorial lain.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Membuat paket ZIP proyek

Penting

Saat membuat paket ZIP untuk penyebaran, jangan sertakan direktori akar, tetapi hanya file dan direktori di dalamnya. Jika Anda mengunduh repositori GitHub sebagai file ZIP, Anda tidak dapat menyebarkan file tersebut apa adanya ke App Service. GitHub menambahkan direktori berlapis tambahan di tingkat atas, yang tidak berfungsi dengan App Service.

Di jendela terminal lokal, arahkan ke direktori akar proyek aplikasi Anda.

Direktori ini harus berisi file entri ke aplikasi web Anda, seperti index.html, index.php, dan app.js. Ini juga dapat berisi file manajemen paket seperti project.json,composer.json, package.json, bower.json, dan requirements.txt.

Kecuali Anda ingin Azure App Service menjalankan automasi penyebaran untuk Anda, jalankan semua tugas build (misalnya, npm, bower, gulp, composer, dan, pip) serta pastikan Anda memiliki semua file yang Anda butuhkan untuk menjalankan aplikasi. Langkah ini diperlukan jika Anda ingin menjalankan paket Anda secara langsung.

Buat arsip ZIP dari semua yang ada di proyek Anda. Untuk dotnet proyek, ini adalah segalanya dalam direktori dotnet publish output perintah (tidak termasuk direktori output itu sendiri). Misalnya, perintah berikut di terminal Anda untuk membuat paket ZIP konten direktori saat ini:

# Bash
zip -r <file-name>.zip .

# PowerShell
Compress-Archive -Path * -DestinationPath <file-name>.zip

Menyebarkan paket ZIP

Saat menyebarkan paket ZIP, App Service mengekstrak kontennya pada jalur default untuk aplikasi Anda (D:\home\site\wwwroot untuk Windows, /home/site/wwwroot untuk Linux).

Penyebaran paket ZIP ini juga menggunakan layanan Kudu yang mendukung penyebaran berbasis integrasi berkelanjutan. Kudu mendukung fungsi berikut untuk penyebaran paket ZIP:

• Penghapusan file yang tersisa dari penyebaran sebelumnya.
• Opsi untuk mengaktifkan proses build default, yang mencakup pemulihan paket.
• Penyesuaian penyebaran, termasuk menjalankan skrip penyebaran.
• Log penyebaran.
• Batas ukuran paket 2048 MB.

Catatan

File dalam paket ZIP disalin hanya jika tanda waktu mereka tidak sesuai dengan yang telah disebarkan.

Dengan Zip deploy UI di Kudu

Di browser, navigasikan ke https://<app_name>.scm.azurewebsites.net/ZipDeployUI (lihat catatan di bagian atas).

Unggah paket ZIP yang Anda buat di Buat paket ZIP proyek dengan menyeretnya ke area file explorer pada halaman web.

Saat penyebaran sedang berlangsung, ikon di pojok kanan atas menunjukkan persentase kemajuan. Halaman ini juga menampilkan pesan verbose untuk operasi di bawah area penjelajah. Ketika penyebaran selesai, pesan terakhir harus mengatakan Deployment successful.

Titik akhir di atas tidak berfungsi untuk Linux App Services saat ini. Pertimbangkan untuk menggunakan FTP atau API penyebaran ZIP sebagai gantinya.

Tanpa zip menyebarkan UI di Kudu

Azure CLI

Sebarkan paket ZIP ke aplikasi web Anda menggunakan perintah az webapp deploy. Perintah CLI menggunakan API penerbitan Kudu untuk menyebarkan file dan dapat sepenuhnya disesuaikan.

Contoh berikut mendorong paket ZIP ke situs Anda. Tentukan jalur ke paket ZIP lokal Anda untuk --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <zip-package-path>

Perintah ini memulai ulang aplikasi setelah menyebarkan paket ZIP.

Azure PowerShell

Contoh berikut menggunakan Publish-AzWebapp untuk mengunggah paket ZIP. Ganti tempat penampung <group-name>, <app-name>, dan <zip-package-path>

Publish-AzWebApp -ResourceGroupName Default-Web-WestUS -Name MyApp -ArchivePath <zip-package-path> 

API Kudu

Contoh berikut menggunakan alat cURL untuk menyebarkan paket ZIP. Ganti tempat penampung <zip-package-path> dan <app-name>. Jika Anda memilih autentikasi dasar, berikan kredensial penyebaran di <username> dan <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<zip-package-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -T "<zip-package-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

Catatan

Untuk nama domain aktual yang sepenuhnya memenuhi syarat untuk digunakan dalam URL, lihat catatan di bagian atas

Templat ARM

Templat ARM hanya mendukung penyebaran dari paket yang dihosting dari jarak jauh.

Mengaktifkan otomatisasi build untuk penyebaran zip

Secara default, mesin penyebaran mengasumsikan bahwa file ZIP siap untuk dijalankan apa adanya dan tidak menjalankan otomatisasi build apa pun. Untuk mengaktifkan otomatisasi build yang sama seperti dalam penyebaran Git, atur SCM_DO_BUILD_DURING_DEPLOYMENTpengaturan aplikasi dengan menjalankan perintah berikut di Cloud Shell:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

Untuk informasi selengkapnya, lihat dokumentasi Kudu.

Menyebarkan paket WAR/JAR/EAR

Anda dapat menyebarkan paket WAR, JAR, atau EAR ke App Service untuk menjalankan aplikasi web Java menggunakan Azure CLI, PowerShell, atau API penerbitan Kudu.

Proses penyebaran yang ditampilkan di sini menempatkan paket pada berbagi konten aplikasi dengan konvensi penamaan dan struktur direktori yang tepat (lihat Referensi API penerbitan Kudu), dan ini adalah pendekatan yang direkomendasikan. Jika Anda menyebarkan paket WAR/JAR/EAR menggunakan FTP atau WebDeploy, Anda mungkin melihat kegagalan yang tidak diketahui karena kesalahan dalam penamaan atau struktur.

Azure CLI

Sebarkan paket WAR ke Tomcat atau JBoss EAP menggunakan perintah az webapp deploy. Tentukan jalur ke paket Java lokal Anda untuk --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path ./<package-name>.war

Perintah CLI menggunakan API penerbitan Kudu untuk menyebarkan paket dan dapat sepenuhnya disesuaikan.

Azure PowerShell

Contoh berikut menggunakan Publish-AzWebapp untuk mengunggah file .war. Ganti tempat penampung <group-name>, <app-name>, dan <package-path> (hanya jika file WAR dan JAR didukung dalam Azure PowerShell).

Publish-AzWebapp -ResourceGroupName <group-name> -Name <app-name> -ArchivePath <package-path>

API Kudu

Contoh berikut menggunakan alat cURL untuk menyebarkan file .war, .jar, atau .ear. Ganti tempat penampung <file-path>, , <app-name>dan <package-type> (war, jar, atau ear, yang sesuai). Jika Anda memilih autentikasi dasar, berikan kredensial penyebaran di <username> dan <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"

Catatan

Untuk nama domain aktual yang sepenuhnya memenuhi syarat untuk digunakan dalam URL, lihat catatan di bagian atas

Untuk informasi lebih lanjut, lihat Referensi API penerbitan Kudu

Templat ARM

Templat ARM hanya mendukung penyebaran dari paket yang dihosting dari jarak jauh.

Menyebarkan file individual

Azure CLI

Menyebarkan skrip startup, pustaka, dan file statis ke aplikasi web Anda menggunakan perintah az webapp deploy dengan parameter --type.

Jika menyebarkan skrip startup dengan cara ini, App Service secara otomatis menggunakan skrip Anda untuk memulai aplikasi.

Perintah CLI menggunakan API penerbitan Kudu untuk menyebarkan file dan dapat sepenuhnya disesuaikan.

Menyebarkan skrip startup

az webapp deploy --resource-group <group-name> --name <app-name> --src-path scripts/startup.sh --type=startup

Menyebarkan file pustaka

az webapp deploy --resource-group <group-name> --name <app-name> --src-path driver.jar --type=lib

Menyebarkan file statis

az webapp deploy --resource-group <group-name> --name <app-name> --src-path config.json --type=static

Azure PowerShell

Tidak didukung. Lihat Azure CLI atau API Kudu.

API Kudu

Menyebarkan skrip startup

Contoh berikut menggunakan alat cURL untuk menyebarkan file startup untuk aplikasi. Ganti tempat penampung <startup-file-path> dan <app-name>. Jika Anda memilih autentikasi dasar, berikan kredensial penyebaran di <username> dan <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<startup-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<startup-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"

Catatan

Untuk nama domain aktual yang sepenuhnya memenuhi syarat untuk digunakan dalam URL, lihat catatan di bagian atas

Menyebarkan file pustaka

Contoh berikut menggunakan alat cURL untuk menyebarkan file pustaka untuk aplikasi. Ganti tempat penampung <lib-file-path> dan <app-name>. Jika Anda memilih autentikasi dasar, berikan kredensial penyebaran di <username> dan <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<lib-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<lib-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

Catatan

Untuk nama domain aktual yang sepenuhnya memenuhi syarat untuk digunakan dalam URL, lihat catatan di bagian atas

Menyebarkan file statis

Contoh berikut menggunakan alat cURL untuk menyebarkan file konfigurasi untuk aplikasi. Ganti tempat penampung <config-file-path> dan <app-name>. Jika Anda memilih autentikasi dasar, berikan kredensial penyebaran di <username> dan <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<config-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<config-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

Catatan

Untuk nama domain aktual yang sepenuhnya memenuhi syarat untuk digunakan dalam URL, lihat catatan di bagian atas

Templat ARM

Templat ARM hanya mendukung penyebaran dari paket yang dihosting dari jarak jauh.

Menyebarkan ke aplikasi yang diamankan jaringan

Bergantung pada konfigurasi jaringan aplikasi web Anda, akses langsung ke aplikasi dari lingkungan pengembangan Anda mungkin diblokir (lihat Menyebarkan ke situs yang diamankan Jaringan dan Menyebarkan ke situs yang diamankan Jaringan, Bagian 2). Alih-alih mendorong paket atau file ke aplikasi web secara langsung, Anda dapat menerbitkannya ke sistem penyimpanan yang dapat diakses dari aplikasi web dan memicu aplikasi untuk menarik ZIP dari lokasi penyimpanan.

URL jarak jauh dapat menjadi lokasi yang dapat diakses publik, tetapi yang terbaik adalah menggunakan kontainer penyimpanan blob dengan kunci SAS untuk melindunginya.

Azure CLI

Gunakan perintah seperti yang az webapp deploy Anda lakukan di bagian lain, tetapi gunakan --src-url alih-alih --src-path. Contoh berikut menggunakan --src-url parameter untuk menentukan URL file ZIP yang dihosting di akun Azure Storage.

az webapp deploy --resource-group <group-name> --name <app-name> --src-url "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3 --type zip

Azure PowerShell

Tidak didukung. Lihat Templat Azure CLI, Kudu API, atau ARM.

API Kudu

Panggil API penerbitan Kudu seperti yang Anda lakukan di bagian lain, tetapi alih-alih mengunggah file, teruskan objek JSON dengan packageUri di isi permintaan. Contoh berikut menggunakan metode ini untuk menentukan URL file ZIP yang dihosting di akun Azure Storage. Perhatikan bahwa jenis masih ditentukan sebagai string kueri. Jika Anda memilih autentikasi dasar, berikan kredensial penyebaran di <username> dan <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

Catatan

Untuk nama domain aktual yang sepenuhnya memenuhi syarat untuk digunakan dalam URL, lihat catatan di bagian atas

Templat ARM

Tambahkan JSON berikut ke templat ARM Anda. Ganti tempat penampung <app-name>.

{
    "type": "Microsoft.Web/sites/extensions",
    "apiVersion": "2021-03-01",
    "name": "onedeploy",
    "dependsOn": [
        "[resourceId('Microsoft.Web/Sites', <app-name>')]"
    ],
    "properties": {
        "packageUri": "<zip-package-uri>",
        "type": "<type>",
        "path": "<target-path>"
    }
}

Gunakan referensi berikut untuk membantu Anda mengonfigurasi properti:

Properti	Deskripsi	Wajib diisi
packageUri	URI paket atau file. Untuk informasi selengkapnya, lihat Situs/ekstensi Microsoft.Web 'onedeploy'.	Ya
type	type Lihat parameter di Kudu menerbitkan referensi API.	Ya
path	target-path Lihat parameter di Kudu menerbitkan referensi API.	No

Referensi API penerbitan Kudu

API Kudu publish memungkinkan Anda menentukan parameter yang sama dari perintah CLI sebagai parameter kueri URL. Untuk mengautentikasi dengan Kudu REST API, sebaiknya gunakan autentikasi token, tetapi Anda juga dapat menggunakan autentikasi dasar dengan kredensial penyebaran aplikasi Anda.

Tabel berikut ini memperlihatkan parameter kueri yang tersedia, nilai yang diizinkan, dan deskripsinya.

Tombol	Nilai yang diizinkan	Deskripsi	Wajib	Tipe
type	war|jar|ear|lib|startup|static|zip	Jenis artefak yang disebarkan, menetapkan jalur target default dan menginformasikan aplikasi web bagaimana penyebaran harus ditangani. - type=zip: Menyebarkan paket ZIP dengan mengekstrak konten ke /home/site/wwwroot. Parameter target-path bersifat opsional. - type=war: Menyebarkan paket WAR. Secara default, paket WAR disebarkan ke /home/site/wwwroot/app.war. Jalur target dapat ditentukan dengan target-path. - type=jar: Menyebarkan paket JAR ke /home/site/wwwroot/app.jar. Parameter target-path diabaikan - type=ear: Menyebarkan paket EAR ke /home/site/wwwroot/app.ear. Parameter target-path diabaikan - type=lib: Menyebarkan file pustaka JAR. Secara default, file tersebut disebarkan ke /home/site/libs. Jalur target dapat ditentukan dengan target-path. - type=static: Menyebarkan file statis (seperti skrip). Secara default, file tersebut disebarkan ke /home/site/wwwroot. - type=startup: Menyebarkan skrip yang secara otomatis digunakan oleh App Service sebagai skrip startup untuk aplikasi Anda. Secara default, skrip tersebut disebarkan ke D:\home\site\scripts\<name-of-source> untuk Windows dan home/site/wwwroot/startup.sh untuk Linux. Jalur target dapat ditentukan dengan target-path.	Ya	String
restart	true|false	Secara default, API memulai ulang aplikasi setelah operasi penyebaran selesai (restart=true). Untuk menyebarkan beberapa artefak, cegah hidupkan ulang pada semua kecuali penyebaran akhir melalui pengaturan restart=false.	No	Boolean
clean	true|false	Tentukan apakah akan membersihkan (menghapus) penyebaran target sebelum menyebarkan artefak di sana.	No	Boolean
ignorestack	true|false	API penerbitan menggunakan variabel lingkungan WEBSITE_STACK untuk memilih default yang aman tergantung pada tumpukan bahasa situs Anda. Mengatur parameter ini menjadi false menonaktifkan default khusus bahasa.	No	Boolean
target-path	Jalur absolut	Jalur mutlak untuk penyebaran artefak. Misalnya, "/home/site/deployments/tools/driver.jar", "/home/site/scripts/helper.sh".	No	String

Langkah berikutnya

Untuk skenario penyebaran yang lebih canggih, coba sebarkan ke Microsoft Azure dengan Git. Penyebaran berbasis Git ke Microsoft Azure memungkinkan kontrol versi, pemulihan paket, MSBuild, dan banyak lagi.

Sumber daya lainnya

• Kudu: Menyebarkan dari file zip
• Variabel lingkungan dan referensi pengaturan aplikasi