Sebarkan situs statis ke akun Azure Static Web Apps Anda sendiri

Apa manfaat menghubungkan layanan ini untuk Anda

Menghubungkan akun Azure Static Web Apps Anda sendiri memungkinkan Anda memublikasikan situs statis ke akun Azure Static Web Apps Anda langsung dari dasbor Zinn®. Anda memiliki proyek dan tagihannya; kami yang menangani proses penerapan, domain kustom, dan catatan DNS.

Sebelum Anda mulai

Langganan Azure, grup sumber daya untuk situs-situs tersebut, dan akun GitHub, GitLab, atau Bitbucket yang terhubung dan menyimpan kode — Azure Static Web Apps melakukan pembangunan dari sebuah repositori. Paket gratis Azure mengizinkan penggunaan komersial dan dua domain kustom per aplikasi.

1. Buat kunci di Azure Static Web Apps

Azure menyebut ini sebagai prinsipal layanan. Di pusat admin Microsoft Entra, buka Entra ID → Pendaftaran aplikasi → Pendaftaran baru, berikan nama, lalu Daftarkan. Pada halaman ikhtisar aplikasi, salin ID Aplikasi (klien) dan ID Direktori (penyewa). Kemudian buka Sertifikat & rahasia → Rahasia klien → Rahasia klien baru, pilih durasi, lalu Tambahkan — langsung salin nilai rahasia tersebut karena Azure hanya menampilkannya sekali.

Di portal Azure, buka grup sumber daya yang ingin Anda gunakan, lalu Kontrol akses (IAM) → Tambah → Tambah penetapan peran. Pilih peran Kontributor, tetapkan ke Pengguna, grup, atau prinsipal layanan, cari aplikasi berdasarkan namanya, dan Tinjau + tetapkan. Catat nama grup sumber daya dan ID Langganan tempat grup tersebut berada (cari Langganan di portal).

2. Hubungkan di sini

Buka Integrasi di dasbor Anda dan pilih Hubungkan akun. Pilih Hosting statis (Netlify, Vercel) sebagai grup dan Azure Static Web Apps sebagai akun, isi ID Klien, Rahasia klien, ID Penyewa, ID Langganan, dan Grup sumber daya, lalu tekan Hubungkan akun.

Kami menguji data yang Anda tempel sebelum ada yang disimpan. Kunci yang tidak berfungsi tidak akan pernah disimpan, dan jawaban akan menunjukkan letak kesalahannya. Kunci yang berfungsi disimpan dalam keadaan terenkripsi di brankas rahasia kami — tidak pernah di basis data kami — dan tidak akan pernah ditampilkan lagi, bahkan kepada Anda.

Apa yang terjadi selanjutnya

• Saat Anda membuat atau memindahkan situs statis, akun ini akan muncul sebagai target penerapan.

Azure Static Web Apps melakukan pembangunan dari sebuah repositori — layanan ini tidak memiliki cara untuk menerima unggahan hasil pembangunan — sehingga kode situs harus berasal dari repositori GitHub, GitLab, atau Bitbucket yang terhubung. Hubungkan salah satu terlebih dahulu jika Anda belum melakukannya.

• Kami membuat layanan di akun Anda, mengarahkannya ke repositori, menautkan domain kustom Anda, dan memicu penerapan. Halaman domain akan menampilkan catatan DNS apa pun yang diperlukan oleh Azure Static Web Apps.
• Penggunaan dan penagihan ada pada akun Anda, yang dapat dilihat di dasbor vendor Anda sendiri.
• Domain puncak diverifikasi oleh catatan TXT dan subdomain oleh CNAME-nya; halaman domain akan menunjukkan mana yang diperlukan oleh domain Anda.

Jika gagal terhubung

Azure menolak prinsipal layanan tersebut. Entah rahasia klien telah kedaluwarsa — karena rahasia selalu kedaluwarsa sesuai durasi yang Anda pilih — atau aplikasi tersebut tidak lagi memiliki peran Kontributor pada grup sumber daya. Kedua pesan tersebut tampak serupa, jadi periksa penetapan peran sebelum membuat rahasia baru.

Tidak ada yang ditemukan. Periksa apakah ID Langganan dan Grup sumber daya adalah tempat Anda menetapkan peran tersebut, dan apakah ID Penyewa adalah direktori tempat aplikasi terdaftar.

Pesan menyatakan kunci ditolak. Hampir selalu disebabkan oleh salah satu dari tiga hal ini: spasi atau jeda baris yang ikut disalin, kunci yang telah kedaluwarsa, atau kunci yang telah dicabut atau dibuat ulang setelah Anda menyalinnya. Buat kunci baru dan tempel kembali.

Terhubung, tetapi ada proses selanjutnya yang gagal. Kunci berhasil diautentikasi tetapi tidak memiliki izin yang diperlukan oleh tindakan tersebut. Buat kunci baru dengan izin yang tercantum di atas, lalu putuskan sambungan lama dan sambungkan kunci yang baru.

Memutuskan sambungan

Buka Integrasi, cari akun tersebut, dan tekan Putuskan sambungan. Tindakan tersebut akan langsung menghapus kunci yang tersimpan. Segala hal yang menggunakan kunci tersebut akan berhenti pada tindakan berikutnya, dan layar yang bergantung padanya akan menampilkan informasi tersebut alih-alih gagal secara diam-diam.

Memutuskan sambungan tidak membatalkan apa yang telah dilakukan sebelumnya — catatan, penerapan, atau pengaturan yang kami ubah di akun Anda akan tetap seperti semula. Jika Anda menduga kunci tersebut mungkin telah bocor, cabut juga aksesnya di pihak vendor; memutuskan sambungan hanya menghapus salinan milik kami, bukan milik mereka.