Improve Restate Server deployment docs #60
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
pcholakov
reviewed
Oct 29, 2025
| --- | ||
|
|
||
|
|
||
| Restate can run as a single binary, making it easy to run it on a variety of platforms, from your local machine, to a VM, to Kubernetes. |
There was a problem hiding this comment.
Suggested change
| Restate can run as a single binary, making it easy to run it on a variety of platforms, from your local machine, to a VM, to Kubernetes. | |
| Restate is distributed as a single binary that implements all features required to run a single- or multi-node cluster, making it easy to run it on a variety of platforms, from your local machine, to a VM, to Kubernetes. |
|
|
||
| <Card icon={"cloud"} href={"/cloud/getting-started"} title={"The easiest way to run Restate is with Restate Cloud."}> | ||
| Keep deploying your code the same way you do now. | ||
| Restate Cloud handles resilience, observability, and scalability for your code, with no additional infra. |
There was a problem hiding this comment.
Suggested change
| Restate Cloud handles resilience, observability, and scalability for your code, with no additional infra. | |
| Restate Cloud handles resilience, observability, and scalability for your code, with no additional infrastructure to manage beyond your services. | |
| Pair Restate Cloud with a serverless compute provider for the simplest operational experience. |
|
|
||
| ## Compute | ||
|
|
||
| The easiest way to deploy and manage the Restate cluster and services is via the [Kubernetes operator](/server/deploy/kubernetes), since it gives you a lot of built-in functionality and tooling for deploying services, versioning, and more. |
There was a problem hiding this comment.
Suggested change
| The easiest way to deploy and manage the Restate cluster and services is via the [Kubernetes operator](/server/deploy/kubernetes), since it gives you a lot of built-in functionality and tooling for deploying services, versioning, and more. | |
| The easiest way to deploy and manage a Restate cluster and containerized Restate services is via the [Kubernetes operator](/server/deploy/kubernetes), as it provides the simplest experience for deploying Restate clusters, deploying services while managing versioning, and more. |
Comment on lines
+32
to
+33
| This approach is also recommended for single-node Restate deployments because it will make managing the persistent volume of your Restate instance easier. | ||
| If your instance goes down, the Kubernetes provider automatically restarts it and reattaches the persistent volume. |
There was a problem hiding this comment.
Suggested change
| This approach is also recommended for single-node Restate deployments because it will make managing the persistent volume of your Restate instance easier. | |
| If your instance goes down, the Kubernetes provider automatically restarts it and reattaches the persistent volume. | |
| This approach is great even for single-node Restate deployments because it makes managing the Restate node much simpler, handling node restarts or Restate version updates with ease. Kubernetes is responsible for keeping the Restate container running and, crucially, makes sure that the persistent volume attachment follows it around if it moves between nodes. |
pcholakov
reviewed
Oct 29, 2025
| -e RESTATE_CLOUD_REGION \ | ||
| -p 8080:8080 \ | ||
| -p 9090:9090 \ | ||
| -p 9070:9070 |
There was a problem hiding this comment.
not part of your changes, but spotted a missing slash here:
Suggested change
| -p 9070:9070 \ |
pcholakov
reviewed
Oct 29, 2025
Co-authored-by: Pavel Tcholakov <pcholakov@gmail.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.