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ž svou kontejnerovou aplikaci propojíte se statickou webovou aplikací, jakékoli požadavky na statickou webovou aplikaci, jejichž trasa začíná /api, jsou směrovány na stejnou trasu v kontejnerové aplikaci.

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:

• Azure Functions
• Azure API Management
• Azure App Service
• Azure Container Apps

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 pull requestů statických webových aplikací.

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.

Zdroj	Popis
Azure Container Apps	Pokud ho ještě nemáte, postupujte podle kroků v průvodci Nasazení vaší 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 na následujícím místě.

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 porovnává požadavky směřované na /api a dále zprostředkovává celou trasu 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:

1. Na webu Azure Portal přejděte do statické webové aplikace.

2. V navigační nabídce vyberte rozhraní API .

3. Vyhledejte prostředí, na které chcete propojit instanci služby API Management. Vyberte Odkaz.

4. V Typu Backend resource vyberte Kontejnerová aplikace.

5. V části Předplatné vyberte předplatné obsahující aplikaci kontejneru, kterou chcete propojit.

6. V Název prostředku vyberte aplikaci kontejneru.

7. Vyberte Odkaz.

Po dokončení procesu propojení jsou požadavky na trasy začínající /api přesměrovány do propojené kontejnerové aplikace.

Správa přístupu k aplikaci kontejneru

Vaše aplikace kontejneru je nakonfigurována s poskytovatelem identity jménem Azure Static Web Apps (Linked), který dovoluje pouze provoz, jenž je zprostředkován prostřednictvím statické webové aplikace. 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:

1. Na webu Azure Portal přejděte do statické webové aplikace.

2. V navigační nabídce vyberte rozhraní API.

3. Vyhledejte prostředí, které chcete odpojit, a vyberte název aplikace kontejneru.

4. Vyberte Zrušit propojení.

Po dokončení procesu zrušení propojení se požadavky na trasy začínající na /api již nepřesměrovávají na vaši kontejnerovou aplikaci.

Poznámka:

Aby se předešlo náhodnému zpřístupnění vaší kontejnerové aplikace anonymnímu provozu, zprostředkovatel identity vytvořený procesem propojení není automaticky odstraněn. Z nastavení ověřování kontejneru aplikace můžete odstranit zprostředkovatele identity s názvem Azure Static Web Apps (Linked).

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:

1. Na webu Azure Portal přejděte k prostředku Container Apps.

2. V navigační nabídce vyberte Ověřování .

3. Ze seznamu zprostředkovatelů identity odstraňte zprostředkovatele identity související s prostředkem Static Web Apps.

4. 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.

Další kroky

Přehled rozhraní API