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

Bağlantıyı kurmanın size sağladıkları

Kendi Azure Static Web Apps hesabınızı bağlamak, Zinn® kontrol panelinizden kendi Azure Static Web Apps hesabınızda statik bir site yayınlamanızı sağlar. 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ı gerekir; Azure Static Web Apps derlemeleri bir depodan (repository) yapar. Azure'un ücretsiz planı ticari kullanıma ve uygulama başına iki özel alana izin verir.

1. Anahtarı Azure Static Web Apps üzerinde oluşturun

Azure buna hizmet sorumlusu (service principal) der. Microsoft Entra yönetim merkezinde Entra ID → Uygulama kayıtları → Yeni kayıt yolunu açın, bir ad verin ve Kaydet düğmesine basın. Uygulamanın genel bakış sayfasında Uygulama (istemci) kimliği ve Dizin (kiracı) kimliği değerlerini kopyalayın. Ardından Sertifikalar ve gizli diziler → İstemci gizli dizileri → Yeni istemci gizli dizisi yolunu açın, bir süre seçin ve Ekle düğmesine tıklayın; gizli dizinin 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 yolunu izleyin. Katkıda Bulunan (Contributor) rolünü seçin, bunu Kullanıcı, grup veya hizmet sorumlusu seçeneğine atayın, uygulamayı adıyla arayın ve Gözden geçir ve ata düğmesine tıklayın. Kaynak grubunun adını ve ait olduğu Abonelik Kimliği değerini not edin (portalda Abonelikler araması yapın).

2. Buraya bağlayın

Kontrol panelinizde Entegrasyonlar alanını açın ve Bir hesap bağla seçeneğini seçin. Grup olarak Statik barındırma (Netlify, Vercel) ve hesap olarak Azure Static Web Apps seçin; İstemci Kimliği, İstemci gizli dizisi, Kiracı Kimliği, Abonelik Kimliği ve Kaynak grubu alanlarını doldurun ve Hesabı bağla düğmesine basın.

Herhangi bir şey kaydedilmeden önce yapıştırdığınız bilgileri test ederiz. Çalışmayan bir anahtar asla saklanmaz ve yanıtta neyin yanlış olduğu belirtilir. Çalışan bir anahtar ise veritabanımızda asla tutulmaz; gizli dizi kasamızda şifrelenmiş olarak saklanır ve size dahi 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 derlemeleri bir depodan gerçekleştirir; yüklenen bir derlemeyi kabul etme yöntemi yoktur; bu nedenle sitenin kodu bağlı bir GitHub, GitLab veya Bitbucket deposundan gelmelidir. Henüz bağlamadıysanız önce bir tanesini bağlayın.
• Hizmeti hesabınızda oluşturur, depoya yönlendirir, özel alanınızı ekler ve dağıtımları tetikleriz. Alan adı sayfası, Azure Static Web Apps için gereken her türlü DNS kaydını gösterir.
• Kullanım ve faturalandırma sizin hesabınızda gerçekleşir ve kendi sağlayıcı kontrol panelinizde görünür.
• Kök alan adı (apex domain) bir TXT kaydıyla, alt alan adı ise CNAME kaydıyla doğrulanır; alan adı sayfası, alan adınızın hangisine ihtiyaç duyduğunu gösterir.

Bağlantı kurulamazsa

Azure hizmet sorumlusunu reddetti. İstemci gizli dizisinin süresi dolmuştur (seçtiğiniz süreye göre her zaman dolar) ya da uygulamanın kaynak grubu üzerindeki Katkıda Bulunan yetkisi artık kalmamıştır. Bu iki mesaj birbirine benzer, bu nedenle yeni bir gizli dizi oluşturmadan önce rol atamasını kontrol edin.

Hiçbir şey bulunamadı. Abonelik Kimliği ve Kaynak grubu bilgilerinin rolü atadığınız bilgiler olduğunu ve Kiracı Kimliği değerinin uygulamanın kayıtlı olduğu dizin olduğunu kontrol edin.

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

Bağlantı kuruluyor ancak daha sonra bir işlem başarısız oluyor. Anahtarın kimliği doğrulanıyor ancak işlemin gerektirdiği bir izin eksik. Yukarıda listelenen izinlere sahip yeni bir anahtar oluşturun, ardından eski bağlantıyı kesin ve yeni anahtarı bağlayın.

Bağlantıyı kesme

Entegrasyonlar sekmesini açın, hesabı bulun ve Bağlantıyı kes düğmesine basın. Bu işlem, saklanan anahtarı anında siler. Bu anahtarı kullanan her şey bir sonraki işleminde durur ve bu anahtara bağlı olan ekranlar sessizce hata vermek yerine durumu bildirir.

Bağlantıyı kesmek daha önce yapılmış olanları geri almaz; hesabınızda değiştirdiğimiz kayıtlar, dağıtımlar veya ayarlar olduğu gibi kalır. Anahtarın kendisinin sızdırılmış olabileceğini düşünüyorsanız, anahtarı sağlayıcı tarafında da iptal edin; bağlantıyı kesmek sağlayıcıdaki kopyayı değil, yalnızca bizdeki kopyayı kaldırır.