Horizontal Scaling With Replicas

In Codesphere horizontal scaling can be done with a single click. Learn how that works and how to set up your app for high availability cases.

December 14, 2023 2 Min Read
Horizontal Scaling With Replicas
Horizontal Scaling With Replicas

Simon Pfeiffer

Head of Product @ Codesphere

About replicas

Replicas are used for horizontal scaling and allow you to connect multiple resources in parallel to your application. Your application will be able to handle more requests in parallel this way.

Codesphere's replicas can be added to any always-on workspace with just a few clicks. You can add up to 10 replicas (& more in our enterprise tier) to your workspaces. Each additional replica costs the same as the workspace's plan. If you set a Micro plan workspace to 4 replicas that will be 4 * $5 = $20. The default value for replicas is 1 in which case you will only have the 1 main workspace and no additional replicas.

How replicas work

Each replica has its own computing resources (CPUs & RAM). However, all replicas use the /home/user/app as a shared filesystem. The allocated SSD storage for your plan is shared between replicas. If you modify that filesystem i.e. via an install step in the pipeline, via the IDE's file editor or the terminal - this change will automatically affect all replicas. Files placed outside the app directory will not be available.

In order to utilize replicas you will need to set up a CI Pipeline. The prepare and test stage will only run on the main replica. All replicas can access the same installed packages and builds in the (shared) /home/user/app folder. The run stage will be executed on each replica. To see the terminal output select the corresponding replica id in the terminal output window on the right.

replicas_pipeline.webp

Avoiding conflicting / concurrent writes to the filesystem

The advantage of a shared filesystem is that you do not need to worry about data & file inconsistency.

However there is one caveat to a shared filesystem. You actively need to ensure that replicas are not trying to write into the same file at the same time. One obvious case where this happens is in log files. You want to be able to look at logs on a replica level (i.e. to figure out why one replica is failing and others are not).

Codesphere provides an environment variable CS_REPLICA that can be used to identify the respective replica via a unique ID. With this value you can build a logic such that each replica writes their logs into their own file or folder. If you are having trouble setting this up our team is happy to help!

Environment variables & replicas

Apart from the Codesphere provided replica identifier environment variables you can also set and use environment variables via Setup/Env Vars. If you add or modify existing variables you will need to re-run the CI Pipeline's Run Stage in order for all replicas to execute with the changes.

About the Author

Horizontal Scaling With Replicas

Simon Pfeiffer

Head of Product @ Codesphere

Simon’s responsibilities cover our product marketing efforts & the roadmap. He is a former green tech founder & IT consultant at KPMG. He shares trends & insights from building Codesphere.

More Posts

Deploying Landscapes on Codesphere

Deploying Landscapes on Codesphere

Learn how to deploy and run multiple services that can independently scale vertically and horizontally within a single workspace. Suitable for hosting entire application landscapes.

Monitoring & Alerting

Monitoring & Alerting

Learn how to access Codesphere's built in resource monitoring and check the uptime of your applications.

Path-Based Routing

Path-Based Routing

Learn how to connect multiple independent applications to a single domain by associating different paths with distinct workspaces