mirror of
https://github.com/Unleash/unleash.git
synced 2024-12-22 19:07:54 +01:00
4007ebfffb
### What We had a customer wonder why `/api/proxy/development` wasn't configured for them. After some digging it was found that they'd followed our documentation and assumed that the proxy was configured for them. However, since we no longer host proxies, this was not the case. This PR updates the documentation to point out that "Unleash hosts everything" now means that our clients should use Frontend API keys and the `/api/frontend` endpoint to get what they used to get from embedded proxies. ## Missing We should make a new illustration in the same vein as the other illustrations on this page to demonstrate what the Frontend API really is. This PR removes the reference to the picture of the topology of having Unleash hosting proxies. --------- Co-authored-by: Thomas Heartman <thomas@getunleash.ai>
114 lines
7.6 KiB
Plaintext
114 lines
7.6 KiB
Plaintext
---
|
|
title: Proxy hosting strategies
|
|
---
|
|
|
|
Because the [Unleash proxy](../generated/unleash-proxy.md) is a separate piece of the Unleash architecture and because it should sit close to your application, there are numerous ways of hosting it. Another important distinction is whether you're hosting Unleash yourself or you have a managed solution.
|
|
|
|
This document describes the two main ways of hosting the proxy alongside the Unleash API and the tradeoffs between hosting the proxy yourself and using the Frontend API that Unleash hosts for you.
|
|
|
|
## Unleash-hosted Frontend API vs self-hosted proxy {#unleash-hosted-or-self-hosted}
|
|
|
|
Which way is right for you will depend on your setup and your needs. In general, we recommend that you host the proxy yourself, but we do recognize that self-hosting requires some extra work on your part and that not all our customers need it.
|
|
|
|
If you want Unleash to host the Frontend API for you, you should be aware of the following limitations:
|
|
|
|
- This is only available to Pro and Enterprise customers who have signed up for a managed Unleash instance.
|
|
- We allow short spikes in traffic and our adaptive infrastructure will automatically scale to your needs.
|
|
- Please check the [Fair Use Policy](https://www.getunleash.io/fair-use-policy) to see the limits of the Unleash-hosted Frontend API.
|
|
- There's no guarantee that it'll be close to your applications. This means you'll get higher response times.
|
|
- When we host the frontend API, we will also receive whatever end user data you put in the [Unleash context](../reference/unleash-context.md). This may or may not be an issue depending on your business requirements.
|
|
|
|
Hosting the proxy yourself requires a little more setup on your part than the Unleash-hosted proxy does, but it offers a number of benefits:
|
|
|
|
- You can scale the proxy horizontally and automatically.
|
|
- There's no request cap or extra charges.
|
|
- You can host as many proxies as you want for as many different environments as you want.
|
|
- You can arrange for the proxy to be close to your applications, minimizing response times.
|
|
- You have full control of all your user data. None of the data that the proxy receives is ever sent to the Unleash API. This keeps _your_ data in _your_ hands.
|
|
- You can easily add more proxies in different regions, as described in the [multi-region](#multi-region) section.
|
|
- If you're having scaling challenges, it could be worth it to have a look at [Unleash Edge](../reference/unleash-edge)
|
|
|
|
## Unleash hosts everything
|
|
|
|
:::info Availability
|
|
|
|
This setup is only available to Pro and Enterprise customers.
|
|
|
|
:::
|
|
|
|
Unleash no longer hosts instances of the proxy, but makes the [Frontend API](../reference/front-end-api) available to all Pro and Enterprise customers. The API is backed by an Amazon RDS database. Your applications can connect to the frontend API from your own cloud or from other hosting solutions.
|
|
|
|
In order to access the frontend API you'll need
|
|
- to create a [Frontend API key](../reference/api-tokens-and-client-keys#front-end-tokens) for the environment you'd like to use.
|
|
- The Frontend API URL. This will be the your Unleash instance's URL followed by "/api/frontend".
|
|
|
|
This is the simplest, but also most limited (by far) way to use Unleash client SDKs. In this setup, Unleash hosts both the Unleash API and the Unleash frontend API. With Unleash hosting, you'll only need to worry about the Frontend API keys and the URL to access the endpoint.
|
|
|
|
While this is easy to get started with, it comes with the limitations described in the [section on tradeoffs between self-hosted and Unleash-hosted setups](#unleash-hosted-or-self-hosted).
|
|
|
|
## Unleash hosts the API, you host the proxy
|
|
|
|
:::info Recommendation
|
|
|
|
We recommend you use [Unleash Edge](../reference/unleash-edge) instead of the Unleash proxy. See our [Edge migration guide](https://github.com/Unleash/unleash-edge/blob/main/migration-guide.md) for a guide on how to migrate
|
|
|
|
:::info Availability
|
|
|
|
This setup is only available to Pro and Enterprise customers.
|
|
|
|
:::
|
|
|
|
|
|
|
|
You host the proxy yourself. It runs in a standalone container alongside your other applications in your cloud or hosting setup. Unleash manages the Unleash API, the admin UI, and the backing database in our AWS setup: the API and the UI run together in a Kubernetes deployment and connect to an Amazon RDS database.
|
|
|
|
You'll need to configure the proxy and the proxy client SDKs.
|
|
|
|
For the proxy, configure:
|
|
|
|
- The Unleash API url. This is your Unleash instance URL followed by "/api".
|
|
- A [client API token](../reference/api-tokens-and-client-keys.mdx#client-tokens). (Refer to [how to create API tokens](../how-to/how-to-create-api-tokens.mdx) for the steps to create one.)
|
|
- One or more [proxy client keys](../reference/api-tokens-and-client-keys.mdx#proxy-client-keys). Refer to the [configuration section of the proxy document](../reference/unleash-proxy#configuration) for more details.
|
|
|
|
For the proxy client SDK, configure:
|
|
|
|
- One of the proxy client keys that you configured for the proxy.
|
|
- The proxy's endpoint. This will depend on where and how you're hosting the proxy, but will typically end in "/proxy"
|
|
|
|
This setup requires a little more setup on your part than the Unleash-hosted proxy does, but it offers all the benefits described in the [section on tradeoffs between self-hosted and Unleash-hosted setups](#unleash-hosted-or-self-hosted).
|
|
|
|
## You host everything
|
|
|
|
:::info Availability
|
|
|
|
This setup is only available open-source and Enterprise customers.
|
|
|
|
:::
|
|
|
|
|
|
|
|
You host everything yourself. Everything runs where and how you configure it to.
|
|
|
|
You'll need to configure the proxy and the proxy client SDKs.
|
|
|
|
For the proxy, configure:
|
|
|
|
- The Unleash API url. This is your Unleash instance URL followed by "/api".
|
|
- A [client API token](../reference/api-tokens-and-client-keys.mdx#client-tokens). (Refer to [how to create API tokens](../how-to/how-to-create-api-tokens.mdx) for the steps to create one.)
|
|
- One or more [proxy client keys](../reference/api-tokens-and-client-keys.mdx#proxy-client-keys). Refer to the [configuration section of the proxy document](../reference/unleash-proxy#configuration) for more details.
|
|
|
|
For the proxy client SDK, configure:
|
|
|
|
- One of the proxy client keys that you configured for the proxy.
|
|
- The proxy's endpoint. This will depend on where and how you're hosting the proxy, but will typically end in "/proxy"
|
|
|
|
As you might expect, doing everything yourself _is_ going to give you the most flexibility, but it's also going to be the most work. If you're already hosting Unleash yourself, though, this shouldn't be any more difficult than the previous section.
|
|
|
|
As described in the [section on tradeoffs between self-hosted and Unleash-hosted setups](#unleash-hosted-or-self-hosted), running the proxy yourself gives you a number of benefits.
|
|
|
|
## Multi-region
|
|
|
|
|
|
|
|
You can also use the proxy for a multi-region setup. You can run a proxy in a different region to the API and still connect to the API. Because the proxy runs closer to your applications it still provides you benefits in terms of quicker response times. Everything should be configured as described in the [you host everything section](#you-host-everything) or the [Unleash hosts the API, you host the proxy section](#unleash-hosts-the-api-you-host-the-proxy). You can add as many extra proxies in as many extra regions as you want.
|