Skip to content

Commit

Permalink
Drop the clustering feature for Anbox Cloud Appliance
Browse files Browse the repository at this point in the history
  • Loading branch information
adglkh committed Jan 24, 2024
1 parent 36fbce3 commit 00bb45a
Show file tree
Hide file tree
Showing 7 changed files with 3 additions and 94 deletions.
13 changes: 1 addition & 12 deletions explanation/clustering.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,4 @@
While it is possible to install Anbox Cloud on a single machine, you usually want to distribute the load over several machines in a cluster.

The Anbox Cloud Appliance provides only basic and experimental support for multi-node setups, however, Anbox Cloud provides full clustering support.

<a name="multi-node-appliance"></a>
## Multi-node support for the Anbox Cloud Appliance

If you're running the Anbox Cloud Appliance and you want to extend the available instance capacity, you can [join additional machines to the appliance](https://discourse.ubuntu.com/t/how-to-join-a-machine-to-the-anbox-cloud-appliance/29054).

The appliance uses [FAN networking](https://wiki.ubuntu.com/FanNetworking) to spawn an overlay network that allows instances on different machines to communicate with each other. This setup extends the capacity, but currently, it does not provide support for high availability (HA).

[note type="information" status="Note"]FAN networking requires a `/16` or `/24` subnet on the network interface. If the appliance is installed on a machine that is not on such a subnet, the appliance disables FAN networking. In such cases, extending the appliance with additional nodes is be possible.[/note]
While it is possible to install Anbox Cloud on a single machine, Anbox Cloud Appliance does not support multi-node setups. If you intend to distribute the load across multiple machines in a cluster, it is recommended to use Anbox Cloud for full deployments instead.

<a name="clustering-anbox-cloud"></a>
## Clustering for full Anbox Cloud deployments
Expand Down
51 changes: 0 additions & 51 deletions howto/cluster/appliance.md

This file was deleted.

7 changes: 2 additions & 5 deletions howto/cluster/landing.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,11 @@
The guides in this section describe how to distribute the load of your Anbox Cloud installation over several machines in a cluster.

For the Anbox Cloud Appliance:

* [How to join a machine to the Anbox Cloud Appliance](https://discourse.ubuntu.com/t/how-to-join-a-machine-to-the-anbox-cloud-appliance/29054)
* [How to configure cluster nodes](https://discourse.ubuntu.com/t/configure-cluster-nodes/28716)

For full Anbox Cloud deployments:

* [How to configure cluster nodes](https://discourse.ubuntu.com/t/configure-cluster-nodes/28716)
* [How to scale up a LXD cluster](https://discourse.ubuntu.com/t/scale-up-a-lxd-cluster/24322)
* [How to scale down a LXD cluster](https://discourse.ubuntu.com/t/scale-down-a-lxd-cluster/24323)

See [About clustering](https://discourse.ubuntu.com/t/capacity-planning/17765) for an introduction to how clustering works in Anbox Cloud.

[note type="information" status="Important"]Currently, Anbox Cloud Appliance does not support clustering.[/note]
2 changes: 0 additions & 2 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,6 @@ Thinking about using Anbox Cloud for your next project? [Get in touch!](https://
| 3 | howto/stream/oob-data | [Exchange OOB data](https://discourse.ubuntu.com/t/exchange-out-of-band-data/21834)|
| 3 | howto/stream/client-side-keyboard | [Use a client-side keyboard](https://discourse.ubuntu.com/t/integrate-a-client-side-virtual-keyboard/23643)|
| 2 | howto/cluster/landing | [Manage the cluster](https://discourse.ubuntu.com/t/manage-cluster-nodes/24334) |
| 3 | howto/cluster/appliance | [Join a machine to the appliance](https://discourse.ubuntu.com/t/how-to-join-a-machine-to-the-anbox-cloud-appliance/29054) |
| 3 | howto/cluster/configure-nodes | [Configure cluster nodes](https://discourse.ubuntu.com/t/configure-cluster-nodes/28716) |
| 3 | howto/cluster/scale-up | [Scale up a LXD cluster](https://discourse.ubuntu.com/t/scale-up-a-lxd-cluster/24322)|
| 3 | howto/cluster/scale-down | [Scale down a LXD cluster](https://discourse.ubuntu.com/t/scale-down-a-lxd-cluster/24323)|
Expand Down Expand Up @@ -238,7 +237,6 @@ Thinking about using Anbox Cloud for your next project? [Get in touch!](https://
| | reference/release-notes/1.7.2 | [Release notes-Anbox Cloud 1.7.2](https://discourse.ubuntu.com/t/18265)|
| | reference/release-notes/1.7.1 | [Release notes-Anbox Cloud 1.7.1](https://discourse.ubuntu.com/t/17977)|
| | reference/appliance-command-reference/ams | [Appliance command reference - ams](https://discourse.ubuntu.com/t/39517)|
| | reference/appliance-command-reference/cluster | [Appliance command reference - cluster](https://discourse.ubuntu.com/t/39519)|
| | reference/appliance-command-reference/dashboard | [Appliance command reference - dashboard](https://discourse.ubuntu.com/t/39520)|
| | reference/appliance-command-reference/destroy | [Appliance command reference - destroy](https://discourse.ubuntu.com/t/39521)|
| | reference/appliance-command-reference/gateway | [Appliance command reference - gateway](https://discourse.ubuntu.com/t/39522)|
Expand Down
21 changes: 0 additions & 21 deletions reference/appliance-command-reference/cluster.md

This file was deleted.

1 change: 0 additions & 1 deletion reference/appliance-command-reference/landing.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ The following commands are available for the `anbox-cloud-appliance` tool:
| Command | Description|
|---------|------------|
|[`ams`](https://discourse.ubuntu.com/t/39517) | Manage access to the Anbox Management Service (AMS)|
|[`cluster`](https://discourse.ubuntu.com/t/39519)| Manage cluster nodes|
|[`dashboard`](https://discourse.ubuntu.com/t/39520)| Manage the web dashboard of appliance|
|[`destroy`](https://discourse.ubuntu.com/t/39521) | Destroy the appliance|
|[`gateway`](https://discourse.ubuntu.com/t/39522) | Manage the appliance stream gateway|
Expand Down
2 changes: 0 additions & 2 deletions tutorial/installing-appliance.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,5 +118,3 @@ After registering, you can log into the appliance dashboard at `https://your-mac
Your Anbox Cloud Appliance is now fully set up and ready to be used! Next, you should check out the [Get started with Anbox Cloud (web dashboard)](https://discourse.ubuntu.com/t/getting-started-with-anbox-cloud-web-dashboard/24958) or the [Get started with Anbox Cloud (CLI)](https://discourse.ubuntu.com/t/getting-started/17756) tutorial to familiarise yourself with how to use Anbox Cloud.

You can find more information about how to use the appliance in the documentation. The appliance installation is nearly identical to installing via Juju, so all the commands and examples not relating directly to Juju will apply.

If you want to increase the capacity of your Anbox Cloud Appliance deployment, you can add more machines to it. See [How to join a machine to the Anbox Cloud Appliance](https://discourse.ubuntu.com/t/how-to-join-a-machine-to-the-anbox-cloud-appliance/29054) for instructions.

0 comments on commit 00bb45a

Please sign in to comment.