Sebarkan tapak statik ke akaun Azure Static Web Apps anda sendiri

Manfaat menyambungkannya untuk anda

Menyambungkan akaun Azure Static Web Apps anda sendiri membolehkan anda menerbitkan tapak statik ke akaun Azure Static Web Apps anda daripada papan pemuka Zinn® anda. Anda memiliki projek dan bil tersebut; kami mengendalikan penyebaran, domain tersuai dan rekod DNS.

Sebelum anda bermula

Langganan Azure, kumpulan sumber untuk tapak-tapak tersebut, dan akaun GitHub, GitLab atau Bitbucket yang disambungkan yang mengandungi kod tersebut — Azure Static Web Apps membina daripada sebuah repositori. Pelan percuma Azure membenarkan penggunaan komersial dan dua domain tersuai bagi setiap aplikasi.

1. Cipta kunci di Azure Static Web Apps

Azure memanggil ini sebagai service principal. Di pusat pentadbiran Microsoft Entra buka Entra ID → App registrations → New registration, berikan nama dan klik Register. Pada halaman gambaran keseluruhan aplikasi, salin Application (client) ID dan Directory (tenant) ID. Kemudian buka Certificates & secrets → Client secrets → New client secret, pilih tempoh dan klik Add — salin nilai rahsia tersebut serta-merta, Azure hanya menunjukkannya sekali sahaja.

Di portal Azure, buka kumpulan sumber yang anda mahu kami gunakan, kemudian Access control (IAM) → Add → Add role assignment. Pilih peranan Contributor, tetapkan kepada User, group, or service principal, cari aplikasi tersebut mengikut nama, dan klik Review + assign. Catatkan nama kumpulan sumber dan Subscription ID miliknya (cari Subscriptions di portal).

2. Sambungkannya di sini

Buka Integrations dalam papan pemuka anda dan pilih Connect an account. Pilih Static hosting (Netlify, Vercel) sebagai kumpulan dan Azure Static Web Apps sebagai akaun, isikan Client ID, Client secret, Tenant ID, Subscription ID dan Resource group, kemudian tekan Connect account.

Kami menguji apa yang anda tampal sebelum apa-apa disimpan. Kunci yang tidak berfungsi tidak akan disimpan, dan jawapannya menyatakan apa yang tidak kena dengannya. Kunci yang berfungsi disimpan secara disulitkan dalam peti simpanan rahsia kami — tidak sekali-kali dalam pangkalan data kami — dan tidak akan ditunjukkan lagi, malah kepada anda sekalipun.

Perkara yang berlaku seterusnya

• Apabila anda mencipta atau memindahkan tapak statik, akaun ini muncul sebagai sasaran

penyebaran. Azure Static Web Apps membina daripada sebuah repositori — ia tidak mempunyai cara untuk menerima binaan yang dimuat naik — jadi kod tapak mestilah datang daripada repositori GitHub, GitLab atau Bitbucket yang disambungkan. Sambungkan satu repositori terlebih dahulu sekiranya anda belum berbuat demikian.

• Kami mencipta perkhidmatan pada akaun anda, menghalakannya ke repositori, melampirkan domain tersuai anda

dan mencetuskan penyebaran. Halaman domain memaparkan sebarang rekod DNS yang diperlukan oleh Azure Static Web Apps.

• Penggunaan dan pengebilan berada pada akaun anda, boleh dilihat dalam papan pemuka vendor anda sendiri.
• Domain apeks disahkan oleh rekod TXT dan subdomain oleh CNAME miliknya; halaman domain menunjukkan

rekod mana yang diperlukan oleh domain anda.

Jika ia tidak bersambung

Azure menolak service principal tersebut. Sama ada rahsia klien telah tamat tempoh — ia sentiasa tamat tempoh, mengikut tempoh yang anda pilih — atau aplikasi itu tidak lagi mempunyai peranan Contributor pada kumpulan sumber. Kedua-dua mesej ini kelihatan serupa, jadi semak penetapan peranan sebelum mencipta rahsia baharu.

Tiada apa-apa yang dijumpai. Semak bahawa Subscription ID dan Resource group adalah yang anda tetapkan peranannya, dan bahawa Tenant ID adalah direktori tempat aplikasi tersebut didaftarkan.

Ia menyatakan kunci telah ditolak. Hampir selalu disebabkan oleh salah satu daripada tiga perkara: ruang aksara atau pemisah baris disalin bersamanya, kunci yang telah tamat tempoh, atau kunci yang telah dibatalkan atau dijana semula selepas anda menyalinnya. Cipta kunci yang baharu dan tampalkannya sekali lagi.

Ia bersambung, tetapi sesuatu gagal kemudiannya. Kunci berjaya mengesahkan identiti tetapi kekurangan kebenaran yang diperlukan oleh tindakan tersebut. Cipta kunci baharu dengan kebenaran yang disenaraikan di atas, kemudian putuskan sambungan lama dan sambungkan kunci yang baharu.

Memutuskan sambungan

Buka Integrations, cari akaun tersebut dan tekan Disconnect. Ini akan memadamkan kunci yang disimpan serta-merta. Sebarang perkara yang menggunakannya akan terhenti pada tindakan seterusnya, dan skrin yang bergantung padanya akan menyatakannya sedemikian dan bukannya gagal secara senyap.

Memutuskan sambungan tidak membatalkan perkara yang telah dilakukan — rekod, penyebaran atau tetapan yang kami ubah pada akaun anda kekal seperti sedia ada. Jika anda berpendapat bahawa kunci itu sendiri mungkin telah bocor, batalkannya juga di pihak vendor; memutuskan sambungan hanya mengalih keluar salinan kami, bukan salinan mereka.