Azure Container Apps ile Azure Static Web Apps'te API desteği

Azure Container Apps sunucusuz kapsayıcıları ve mikro hizmetleri barındırmaya yönelik yönetilen bir platformdur.

Kapsayıcı uygulamanızı statik web uygulamanıza bağladığınızda, ile başlayan /api bir yol ile statik web uygulamanıza yapılan tüm istekler, kapsayıcı uygulamasında aynı yola bağlanır.

Varsayılan olarak, bir kapsayıcı uygulaması statik bir web uygulamasına bağlandığında, kapsayıcı uygulaması yalnızca bağlı statik web uygulaması aracılığıyla proksied istekleri kabul eder. Kapsayıcı uygulaması tek seferde tek bir statik web uygulamasına bağlanabilir.

Statik Web Uygulamaları için API seçenekleri aşağıdaki Azure hizmetlerini içerir:

Daha fazla bilgi için API'lere genel bakış bölümüne bakın.

Not

Azure Container Apps ile tümleştirme için Statik Web Uygulamaları Standart planı gerekir.

Arka uç tümleştirmesi Statik Web Apps çekme isteği ortamlarında desteklenmez.

Önkoşullar

Bir kapsayıcı uygulamasını statik web uygulamanıza bağlamak için mevcut bir Container Apps kaynağına ve statik bir web uygulamasına sahip olmanız gerekir.

Kaynak Açıklama
Azure Container Apps Henüz bir kapsayıcı uygulamanız yoksa, İlk kapsayıcı uygulamanızı dağıtın kılavuzundaki adımları izleyin.
Mevcut statik web uygulaması Henüz bir uygulamanız yoksa, Başlangıç kılavuzundaki adımları izleyerek No Framework statik web uygulaması oluşturun.

Örnek

Aşağıdaki konum aracılığıyla bir uç noktayı kullanıma sunan mevcut bir Azure Container App örneğini göz önünde bulundurun.

https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/api/getProducts

Bağlandıktan sonra, bu örnek URL'de gösterildiği gibi statik web uygulamanızın yolu üzerinden api aynı uç noktaya erişebilirsiniz.

https://red-sea-123.azurestaticapps.net/api/getProducts

Her iki URL de aynı API uç noktasına işaret eder. Statik Web Uygulamaları, /api önekiyle yapılan istekleri eşleştirir ve yolun tamamını bağlı kaynağa proxy yoluyla yönlendirir, bu yüzden kapsayıcı uygulamasındaki uç nokta /api önekiyle başlamalıdır.

Bir kapsayıcı uygulamasını statik bir web uygulamasının API arka ucu olarak bağlamak için şu adımları izleyin:

  1. Azure portalında statik web uygulamasına gidin.

  2. Gezinti menüsünden API'ler'i seçin.

  3. API Management örneğini bağlamak istediğiniz ortamı bulun. Bağlantı'yı seçin.

  4. Arka uç kaynak türü'nde Kapsayıcı Uygulama'yı seçin.

  5. Abonelik'te, bağlamak istediğiniz kapsayıcı uygulamasını içeren aboneliği seçin.

  6. Kaynak adı bölümünde kapsayıcı uygulamasını seçin.

  7. Bağlantı'yı seçin.

Bağlama işlemi tamamlandığında, ile /api başlayan yollara yönelik istekler bağlı kapsayıcı uygulamasına bağlanır.

Kapsayıcı uygulamasına erişimi yönetme

Kapsayıcı uygulamanız, yalnızca statik web uygulamasından geçen trafiğe izin veren adlı Azure Static Web Apps (Linked) bir kimlik sağlayıcısıyla yapılandırılır. Kapsayıcı uygulamanızı diğer uygulamalar için erişilebilir hale getirmek için kimlik doğrulama yapılandırmasını güncelleştirerek başka bir kimlik sağlayıcısı ekleyin veya güvenlik ayarlarını kimliği doğrulanmamış erişime izin verecek şekilde değiştirin.

Bir kapsayıcı uygulamasının statik web uygulamasıyla bağlantısını kaldırmak için şu adımları izleyin:

  1. Azure portalında statik web uygulamasına gidin.

  2. Gezinti menüsünden API'ler'i seçin.

  3. Bağlantısını açmak istediğiniz ortamı bulun ve kapsayıcı uygulaması adını seçin.

  4. Bağlantıyı Kaldır'ı seçin.

Bağlamayı kaldırma işlemi tamamlandığında, /api ile başlayan yollara yönelik istekler artık kapsayıcı uygulamanıza yönlendirilmez.

Not

Kapsayıcı uygulamanızın anonim trafiğe yanlışlıkla açıklanmasını önlemek için, bağlama işlemi tarafından oluşturulan kimlik sağlayıcısı otomatik olarak silinmez. Azure Static Web Apps (Bağlı) adlı kimlik sağlayıcısını kapsayıcı uygulamasının kimlik doğrulama ayarlarından silebilirsiniz.

Container Apps kaynağından kimlik doğrulamasını kaldırma

Container Apps kaynağınızın anonim trafik almasını sağlamak için kimlik sağlayıcısını kaldırmak için şu adımları izleyin:

  1. Azure portalında Container Apps kaynağına gidin.

  2. Gezinti menüsünden Kimlik Doğrulaması'nı seçin.

  3. Kimlik sağlayıcıları listesinden Statik Web Apps kaynağıyla ilgili kimlik sağlayıcısını silin.

  4. Kimlik doğrulamasını kaldırmak ve Container Apps kaynağınıza anonim trafiğe izin vermek için Kimlik doğrulamasını kaldır'ı seçin.

Container Apps kaynağınız artık anonim trafik alabilir.

Sonraki adımlar

API’ye genel bakış

  • Last updated on