Kendi Azure Static Web Apps hesabınıza statik bir site dağıtın

Bağlantının Size Sağladığı Faydalar

Kendi Azure Static Web Apps hesabınızı bağlamak, Zinn® kontrol panelinizden kendi Azure Static Web Apps hesabınıza statik bir site yayınlamanıza olanak tanır. Proje ve fatura size aittir; dağıtımı, özel alanı ve DNS kayıtlarını biz yönetiriz.

Başlamadan Önce

Bir Azure aboneliği, siteler için bir kaynak grubu ve kodu barındıran bağlı bir GitHub, GitLab veya Bitbucket hesabı — Azure Static Web Apps bir depodan derleme yapar. Azure'ın ücretsiz planı ticari kullanıma ve uygulama başına iki özel alana izin verir.

1. Anahtarı Azure Static Web Apps'te Oluşturun

Azure bunu bir hizmet asili (service principal) olarak adlandırır. Microsoft Entra yönetim merkezinde Entra ID → Uygulama kayıtları → Yeni kayıt bölümünü açın, bir ad verin ve Kayıt ol'a tıklayın. Uygulamanın genel bakış sayfasından Uygulama (istemci) ID'sini ve Dizin (kiracı) ID'sini kopyalayın. Ardından Sertifikalar ve sırlar → İstemci sırları → Yeni istemci sırrı bölümünü açın, bir süre seçin ve Ekle'ye tıklayın — sırrın değerini hemen kopyalayın, Azure bunu yalnızca bir kez gösterir.

Azure portalında, kullanmamızı istediğiniz kaynak grubunu açın, ardından Erişim denetimi (IAM) → Ekle → Rol ataması ekle seçeneğine gidin. Katkıda Bulunan rolünü seçin, bunu Kullanıcı, grup veya hizmet asiline atayın, uygulamayı ada göre arayın ve İncele + ata'ya tıklayın. Kaynak grubunun adını ve ait olduğu Abonelik ID'sini not edin (portalda Abonelikler araması yapın).

2. Buradan Bağlayın

Kontrol panelinizde Entegrasyonlar'ı açın ve Bir hesap bağlayın'ı seçin. Grup olarak Statik barındırma (Netlify, Vercel) öğesini ve hesap olarak Azure Static Web Apps'i seçin, İstemci ID, İstemci sırrı, Kiracı ID, Subscription ID (Abonelik ID) ve Kaynak grubu alanlarını doldurun ve Hesabı bağla'ya basın.

Hiçbir şey kaydedilmeden önce yapıştırdığınız verileri test ederiz. Çalışmayan bir anahtar asla saklanmaz ve yanıt bunun ne tür bir sorun içerdiğini belirtir. Çalışan bir anahtar, veritabanımızda değil, sırlar kasamızda şifrelenmiş olarak saklanır ve size bile bir daha asla gösterilmez.

Sonrasında Ne Olur?

• Statik bir site oluşturduğunuzda veya taşıdığınızda, bu hesap bir dağıtım hedefi olarak görünür.

Azure Static Web Apps bir depodan derleme yapar — yüklenen bir derlemeyi kabul etme yolu yoktur — bu nedenle sitenin kodu bağlı bir GitHub, GitLab veya Bitbucket deposundan gelmelidir. Henüz bağlamadıysanız önce bir tane bağlayın.

• Hesabınızda servisi oluşturur, depoya yönlendirir, özel alan adınızı ekler ve dağıtımları tetikleriz. Alan adının sayfası, Azure Static Web Apps'in ihtiyaç duyduğu her türlü DNS kaydını gösterir.
• Kullanım ve faturalandırma sizin hesabınıza aittir ve kendi sağlayıcı kontrol panelinizde görünür.
• Bir tepe alan adı bir TXT kaydıyla, bir alt alan adı ise CNAME kaydıyla doğrulanır; alan adının sayfası, alan adınızın hangisine ihtiyaç duyduğunu gösterir.

Bağlantı Kurulamazsa

Azure hizmet asilini reddetti. Ya istemci sırrının süresi dolmuştur — seçtiğiniz süreye bağlı olarak her zaman dolarlar — ya da uygulamanın artık kaynak grubu üzerinde Katkıda Bulunan yetkisi yoktur. İki hata mesajı birbirine benzer olduğundan, yeni bir sır oluşturmadan önce rol atamasını kontrol edin.

Hiçbir şey bulunamadı. Subscription ID (Abonelik ID) ile Kaynak grubu'nun rolü atadığınız yerler olduğundan ve Tenant ID'nin (Kiracı ID) uygulamanın kayıtlı olduğu dizin olduğundan emin olun.

Anahtarın reddedildiği belirtiliyor. Neredeyse her zaman şu üç şeyden biridir: onunla birlikte kopyalanan bir boşluk veya satır sonu, süresi dolmuş bir anahtar veya kopyaladıktan sonra iptal edilmiş ya da yeniden oluşturulmuş bir anahtar. Yeni bir tane oluşturun ve tekrar yapıştırın.

Bağlantı kuruluyor ancak daha sonra bir şey başarısız oluyor. Anahtar kimlik doğrulaması yapıyor ancak eylemin ihtiyaç duyduğu bir izne sahip değil. Yukarıda listelenen izinlerle yeni bir anahtar oluşturun, ardından eski bağlantıyı kesin ve yeni anahtarı bağlayın.

Bağlantıyı Kesme

Entegrasyonlar'ı açın, hesabı bulun ve Bağlantıyı kes'e basın. Bu işlem, saklanan anahtarı anında siler. Bunu kullanan her şey bir sonraki işleminde durur ve buna bağlı ekranlar sessizce başarısız olmak yerine durumu bildirir.

Bağlantının kesilmesi önceden yapılanları geri almaz — hesabınızda değiştirdiğimiz kayıtlar, dağıtımlar veya ayarlar olduğu gibi kalır. Anahtarın sızdırılmış olabileceğini düşünüyorsanız, sağlayıcı tarafında da iptal edin; bağlantıyı kesmek bizim kopyamızı kaldırır, onlarınkini değil.