diff --git a/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx b/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx index c68c71c20a..3c5b6b6a8c 100644 --- a/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx +++ b/src/content/docs/en/pages/main-menu/reference/build/edge-application/edge-application.mdx @@ -54,6 +54,7 @@ See the documentation for each module: | [Image Processor](/en/documentation/products/edge-application/image-processor/) | Optimize image processing for various devices, browsers, and screen resolutions. | | [Load Balancer](/en/documentation/products/edge-application/load-balancer/) | Balance traffic between your origin servers and cloud providers to improve fault tolerance and avoid network congestion. | | [L2 Caching](/en/documentation/products/edge-application/l2-caching/) | Create a new cache layer between your users and the edge to keep objects in cache for longer periods of time. | +| [WebSocket Proxy](/en/documentation/products/edge-application/websocket/) | Enable the WebSocket protocol to establish full-duplex communication channels over one TCP connection. | --- diff --git a/src/content/docs/en/pages/main-menu/reference/build/edge-application/first-steps.mdx b/src/content/docs/en/pages/main-menu/reference/build/edge-application/first-steps.mdx index 26791bc270..41622a705a 100644 --- a/src/content/docs/en/pages/main-menu/reference/build/edge-application/first-steps.mdx +++ b/src/content/docs/en/pages/main-menu/reference/build/edge-application/first-steps.mdx @@ -18,7 +18,7 @@ Before using **Edge Application**, make sure you have: To access the main settings and configure your edge application: 1. [Access RTM](https://manager.azion.com/). -2. On the upper-left corner of the page, open the **Products menu**, represented by three horizontal lines, and then select **Edge Application**. +2. On the upper-left corner of the page, open the **Products menu**, represented by three horizontal lines, and then select **Edge Application**. 3. Select the edge application you want to configure. You're now in the page to configure the general delivery settings of your application. @@ -29,11 +29,11 @@ You're now in the page to configure the general delivery settings of your applic - [Application Acceleration](/en/documentation/products/edge-application/application-acceleration/) - [Edge Caching](/en/documentation/products/edge-application/edge-caching/) -- Device Detection - [Edge Functions](/en/documentation/products/edge-application/edge-functions/) - [Image Processor](/en/documentation/products/edge-application/image-processor/) - [L2 Caching](/en/documentation/products/edge-application/l2-caching/) - [Load Balancer](/en/documentation/products/edge-application/load-balancer/) +- [WebSocket Proxy](/en/documentation/products/edge-application/websocket/) Some **Edge Application modules** are billed products. To activate them on your account: diff --git a/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx b/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx index 18237655f8..1014c1b23d 100644 --- a/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx +++ b/src/content/docs/en/pages/main-menu/reference/build/edge-application/websocket.mdx @@ -11,7 +11,7 @@ The **WebSocket Proxy** module for Edge Application allows you to establish the WebSockets are designed to minimize latency and increase efficiency, and are suitable for applications that exchange data in real time, such as online games, chat platforms, notifications, and live streaming services. See the [WebSocket protocol specification](https://datatracker.ietf.org/doc/html/rfc6455) for more information. :::note -This module is only available for **Enterprise** and **Mission Critical** plans. For further details on Azion's plans, contact the [Support team](https://tickets.azion.com/). +At the moment, this module is exclusively accessible to subscribers of the **Enterprise** and **Mission Critical** Service Plans. For further details on Azion's service plans, see [Pricing](/en/pricing/#plans). ::: Due to their nature as a bidirectional open connection, WebSocket Proxy is incompatible with the use of the [Edge Functions](/en/documentation/products/edge-application/edge-functions/) and [Image Processor](/en/documentation/products/edge-application/image-processor/) modules. WebSocket connections won't work in conjunction with [Edge Caching](/en/documentation/products/edge-application/edge-caching/) or [L2 Caching](/en/documentation/products/edge-application/l2-caching/). @@ -42,8 +42,6 @@ By default, an edge application that has the **WebSocket Proxy** module enabled A valid WebSocket connection will return the status `101 Switching Protocols`. If this isn't the status received, even if it's among the `2xx` or `3xx` family of success statuses, it's likely that the client request, the edge application, or the origin server didn't complete the Websocket connection. In this case, you should review the [connection upgrade requirements](#requirements) and make the necessary adjustments. - - --- import ContributorList from '~/components/ContributorList.astro' diff --git a/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-app-primeiros-passos.mdx b/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-app-primeiros-passos.mdx index 9c93b73507..1ed90388ed 100644 --- a/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-app-primeiros-passos.mdx +++ b/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-app-primeiros-passos.mdx @@ -27,13 +27,13 @@ Agora você está na área onde pode definir as configurações gerais de entreg **Edge Application** oferece os seguintes módulos: -* [Application Acceleration](/pt-br/documentacao/produtos/edge-application/application-acceleration/) -* [Edge Caching](/pt-br/documentacao/produtos/edge-application/edge-caching/) -* Device Detection -* [Edge Functions](/pt-br/documentacao/produtos/edge-application/edge-functions/) -* [Image Processor](/pt-br/documentacao/produtos/edge-application/image-processor/) -* [L2 Caching](/pt-br/documentacao/produtos/edge-application/l2-caching/) -* [Load Balancer](/pt-br/documentacao/produtos/edge-application/load-balancer/) +- [Application Acceleration](/pt-br/documentacao/produtos/edge-application/application-acceleration/) +- [Edge Caching](/pt-br/documentacao/produtos/edge-application/edge-caching/) +- [Edge Functions](/pt-br/documentacao/produtos/edge-application/edge-functions/) +- [Image Processor](/pt-br/documentacao/produtos/edge-application/image-processor/) +- [L2 Caching](/pt-br/documentacao/produtos/edge-application/l2-caching/) +- [Load Balancer](/pt-br/documentacao/produtos/edge-application/load-balancer/) +- [WebSocket Proxy](/pt-br/documentacao/produtos/edge-application/websocket/) Alguns **módulos de Edge Application** são produtos faturados. Para ativá-los na sua conta: diff --git a/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx b/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx index 9df9e7fb7d..bd4195660f 100644 --- a/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx +++ b/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/edge-application.mdx @@ -54,6 +54,7 @@ Veja a documentação de cada módulo: | [Image Processor](/pt-br/documentacao/produtos/edge-application/image-processor/) | Otimize o processamento de imagens para vários dispositivos, navegadores e resoluções de tela. | | [Load Balancer](/pt-br/documentacao/produtos/edge-application/load-balancer/) | Equilibre o tráfego entre seus servidores de origem e provedores de nuvem para melhorar a tolerância a falhas e evitar o congestionamento da rede. | | [L2 Caching](/pt-br/documentacao/produtos/edge-application/l2-caching/) | Crie uma nova camada de cache entre seus usuários e o edge para manter os objetos no cache por períodos mais longos. | +| [WebSocket Proxy](/pt-br/documentacao/produtos/edge-application/websocket/) | Ative o protocolo WebSocket para estabelecer canais de comunicação full-duplex sobre uma única conexão TCP. | --- diff --git a/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx b/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx new file mode 100644 index 0000000000..3347c1f10e --- /dev/null +++ b/src/content/docs/pt-br/pages/menu-principal/referencia/build/edge-application/websocket.mdx @@ -0,0 +1,49 @@ +--- +title: WebSocket Proxy +description: Aumente a eficiência de suas edge applications em tempo real com o protocolo WebSocket para o Edge Application da Azion. +meta_tags: WebSocket, live, edge application, websockets, protocol +namespace: documentation_products_edge_application_websocket +permalink: /documentacao/produtos/edge-application/websocket/ +--- + +O módulo **WebSocket Proxy** para **Edge Application** permite que você estabeleça o protocolo de comunicação WebSocket entre sua origem e seus usuários sob a arquitetura de proxy reverso. Esse tipo de protocolo consiste em uma única conexão TCP bidirecional que permite que os dados sejam trocados em tempo real através de um único handshake sem a necessidade de reiniciar a conexão. + +Os WebSockets são projetados para minimizar a latência e aumentar a eficiência, e são adequados para aplicações que trocam dados em tempo real, como jogos online, plataformas de bate-papo, notificações e serviços de transmissão ao vivo. Consulte a [especificação do protocolo WebSocket](https://datatracker.ietf.org/doc/html/rfc6455) para obter mais informações. + +:::note +No momento, este módulo está disponível apenas para os Service Plans **Enterprise** e **Mission Critical**. Para obter informações mais detalhadas sobre os planos de serviço da Azion, consulte [Preços](/pt-br/precos/#planos). +::: + +Devido à sua natureza de conexão aberta bidirecional, WebSocket Proxy é incompatível com o uso dos módulos [Edge Functions](/pt-br/documentacao/produtos/edge-application/edge-functions/) e [Image Processor](/pt-br/documentacao/produtos/edge-application/image-processor/). Conexões WebSocket também não funcionarão em conjunto do [Edge Caching](/pt-br/documentacao/produtos/edge-application/edge-caching/) ou do [L2 Caching](/pt-br/documentacao/produtos/edge-application/l2-caching/). + +## Implementação + +| Escopo | Recurso | +| --- | --- | +| Primeiros passos de Edge Application | [Primeiros passos](/pt-br/documentacao/produtos/edge-application/primeiros-passos/) | + +## Requisitos + +Seu cliente e servidor devem suportar a conexão WebSocket nativamente para que o protocolo seja implementado em suas edge applications. Do lado do cliente, a maioria dos navegadores inclui suporte nativo a WebSocket. Veja a [lista completa de browsers com suporte ao WebSocket](https://caniuse.com/websockets). + +### Cabeçalhos de upgrade + +A aplicação deverá injetar os cabeçalhos HTTP `Upgrade: websocket` e `Connection: upgrade` na origem para que a conexão seja estabelecida com sucesso. Caso os cabeçalhos `Connection` e `Upgrade` sejam enviados pelo cliente com valores diferentes dos especificados acima ou um deles não esteja presente, o upgrade de conexão no request de usuários para a origem não será efetuado. + +### Tempo máximo da conexão + +A Azion recicla [conexões keepalive](/pt-br/documentacao/produtos/edge-application/#keepalive-timeout) nos seus servidores aproximadamente a cada *15 minutos*. Portanto, conexões WebSocket ativas poderão ser encerradas se ultrapassarem esse intervalo. Neste caso, sua aplicação deverá tratar esses cenários e restabelecer a conexão sempre que necessário. + +--- + +## Tratamento de erros + +Por padrão, uma edge application que tenha o módulo **WebSocket Proxy** habilitado irá considerar que qualquer requisição recebida com os cabeçalhos `Upgrade: websocket` e `Connection: upgrade` é passível de conexão websocket e irá encaminhá-los para origem. É recomendado que a própria aplicação controle o envio dos cabeçalhos nos casos onde o protocolo deverá ser usado. + +A conexão WebSocket válida retornará o status `101 Switching Protocols`. Caso este não seja o status recebido, mesmo que seja da família de status de sucesso `2xx` ou `3xx`, é provável que a requisição do cliente, a edge application ou o servidor de origem não tenham completado a conexão Websocket. Nesse caso, você deverá revisar os [requisitos para o upgrade da conexão](#requisitos) e fazer os ajustes necessários. + +--- + +import ContributorList from '~/components/ContributorList.astro' + +**Contribuidores** <ContributorList>Contributor</ContributorList>