Podpora rozhraní API ve službě Azure Static Web Apps pomocí Azure Container Apps
Azure Container Apps je spravovaná platforma pro hostování bezserverových kontejnerů a mikroslužeb.
Když aplikaci kontejneru propojíte se statickou webovou aplikací, všechny požadavky na statickou webovou aplikaci se trasou začínající /api na stejnou trasu v aplikaci kontejneru.
Když je aplikace kontejneru ve výchozím nastavení propojená se statickou webovou aplikací, aplikace kontejneru přijímá pouze požadavky, které se přesouvají prostřednictvím propojené statické webové aplikace. Aplikaci kontejneru je možné propojit s jednou statickou webovou aplikací najednou.
Mezi možnosti rozhraní API pro Static Web Apps patří následující služby Azure:
Další informace najdete v přehledu rozhraní API.
Poznámka:
Integrace se službou Azure Container Apps vyžaduje plán Static Web Apps Standard.
Integrace back-endu není podporována v prostředích statických žádostí o přijetí změn Web Apps.
Požadavky
Pokud chcete propojit aplikaci kontejneru se statickou webovou aplikací, musíte mít existující prostředek Container Apps a statickou webovou aplikaci.
| Resource | Popis |
|---|---|
| Azure Container Apps | Pokud ho ještě nemáte, postupujte podle pokynů v průvodci nasazením první aplikace kontejneru. |
| Existující statická webová aplikace | Pokud ho ještě nemáte, vytvořte statickou webovou aplikaci No Framework podle pokynů v úvodní příručce. |
Příklad
Představte si existující instanci azure Container App, která zveřejňuje koncový bod prostřednictvím následujícího umístění.
https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/api/getProducts
Po propojení můžete ke stejnému api koncovému bodu přistupovat přes cestu z vaší statické webové aplikace, jak je znázorněno v této ukázkové adrese URL.
https://red-sea-123.azurestaticapps.net/api/getProducts
Obě adresy URL odkazují na stejný koncový bod rozhraní API. Koncový bod v aplikaci kontejneru musí mít předponu /api , protože Static Web Apps odpovídá požadavkům provedeným na /api proxy serveru a poskytuje celou cestu k propojenému prostředku.
Propojení aplikace typu kontejner
Pokud chcete propojit aplikaci kontejneru jako back-end rozhraní API pro statickou webovou aplikaci, postupujte takto:
Na webu Azure Portal přejděte do statické webové aplikace.
V navigační nabídce vyberte rozhraní API .
Vyhledejte prostředí, na které chcete propojit instanci služby API Management. Vyberte odkaz.
V typu back-endového prostředku vyberte Kontejnerová aplikace.
V části Předplatné vyberte předplatné obsahující aplikaci kontejneru, kterou chcete propojit.
V části Název prostředku vyberte aplikaci kontejneru.
Vyberte odkaz.
Po dokončení procesu propojení se požadavky na trasy začínající /api na trasu přepojí do propojené aplikace kontejneru.
Správa přístupu k aplikaci kontejneru
Vaše aplikace kontejneru je nakonfigurovaná s názvem Azure Static Web Apps (Linked) zprostředkovatele identity, který umožňuje pouze provoz, který se přesměruje přes statickou webovou aplikaci. Pokud chcete, aby byla vaše aplikace kontejneru přístupná pro jiné aplikace, aktualizujte konfiguraci ověřování a přidejte dalšího zprostředkovatele identity nebo změňte nastavení zabezpečení tak, aby povolovala neověřený přístup.
Zrušení propojení aplikace typu kontejner
Pokud chcete odpojit aplikaci typu kontejner ze statické webové aplikace, postupujte takto:
Na webu Azure Portal přejděte do statické webové aplikace.
V navigační nabídce vyberte rozhraní API .
Vyhledejte prostředí, které chcete odpojit, a vyberte název aplikace kontejneru.
Vyberte Zrušit propojení.
Po dokončení procesu zrušení propojení se požadavky na trasy začínající na /api vaši aplikaci kontejneru už nepřesouvají.
Poznámka:
Aby se zabránilo náhodnému zveřejnění vaší aplikace kontejneru anonymnímu provozu, zprostředkovatel identity vytvořený procesem propojení se automaticky neodstraní. Z nastavení ověřování kontejnerové aplikace můžete odstranit zprostředkovatele identity s názvem Azure Static Web Apps (propojené ).
Odebrání ověřování z prostředku Container Apps
Pokud chcete prostředku Container Apps povolit příjem anonymního provozu, odeberte zprostředkovatele identity následujícím postupem:
Na webu Azure Portal přejděte k prostředku Container Apps.
V navigační nabídce vyberte Ověřování .
Ze seznamu zprostředkovatelů identity odstraňte zprostředkovatele identity související s prostředkem Static Web Apps.
Výběrem možnosti Odebrat ověřování odeberete ověřování a povolíte anonymní provoz do vašeho prostředku Container Apps.
Váš prostředek Container Apps teď dokáže přijímat anonymní provoz.