Skip to content

Commit 6207f62

Browse files
committed
move replica how-to instructions
1 parent d4b3bde commit 6207f62

File tree

1 file changed

+55
-0
lines changed
  • src/content/docs/cloudflare-one/connections/connect-networks/configure-tunnels/tunnel-availability

1 file changed

+55
-0
lines changed
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
pcx_content_type: how-to
3+
title: Deploy cloudflared replicas
4+
sidebar:
5+
order: 2
6+
---
7+
8+
import { Render } from "~/components";
9+
10+
To deploy multiple instances of `cloudflared`, you can create and configure one tunnel and run it on multiple hosts. If your tunnel runs as a service, only one `cloudflared` instance is allowed per host.
11+
12+
You can run the same tunnel across various `cloudflared` processes for up to 100 connections (25 replicas) per tunnel. Cloudflare Load Balancers and DNS records can still point to the tunnel and its UUID. Traffic will be sent to all `cloudflared` processes associated with the tunnel.
13+
14+
:::tip[Deploy replicas in Kubernetes]
15+
For information about running `cloudflared` in a Kubernetes deployment, refer to the [Kubernetes guide](/cloudflare-one/connections/connect-networks/deployment-guides/kubernetes/).
16+
:::
17+
18+
## Remotely-managed tunnels
19+
20+
1. To create a remotely-managed tunnel, follow the [dashboard setup guide](/cloudflare-one/connections/connect-networks/get-started/create-remote-tunnel/).
21+
2. On the **Tunnels** page, select your newly created tunnel. The **Connectors** section shows all of the `cloudflared` instances for that tunnel.
22+
3. Select **Configure**.
23+
4. Select the operating system of the host where you want to deploy a replica.
24+
5. Copy the installation command and run it on the host.
25+
26+
The new replica will appear on the **Connectors** list for the tunnel.
27+
28+
## Locally-managed tunnels
29+
30+
1. To create a locally-managed tunnel, complete Steps 1 through 5 in the [CLI setup guide](/cloudflare-one/connections/connect-networks/do-more-with-tunnels/local-management/create-local-tunnel/).
31+
32+
2. Run your newly created tunnel.
33+
34+
```sh
35+
cloudflared tunnel run <NAME>
36+
```
37+
38+
This will start a `cloudflared` instance and generate a unique `connector_id`.
39+
40+
3. In a separate window or on another host, run the same command again:
41+
42+
```sh
43+
cloudflared tunnel run <NAME>
44+
```
45+
46+
This will initialize another `cloudflared` instance and generate another `connector_id`.
47+
48+
4. Run `tunnel info` to show each `cloudflared` instance running your tunnel:
49+
50+
```sh
51+
cloudflared tunnel info <NAME>
52+
```
53+
54+
This will output your tunnel UUID as well as two Connector IDs, one for each `cloudflared` process running your tunnel. With this command, you can also see that your tunnel is now being served by eight connections.
55+

0 commit comments

Comments
 (0)