Skip to content

Commit 414d4dc

Browse files
[Docs]: Service rolling deployments
Minor edits
1 parent 5a79e41 commit 414d4dc

1 file changed

Lines changed: 9 additions & 8 deletions

File tree

docs/docs/concepts/services.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -681,7 +681,7 @@ utilization_policy:
681681

682682
## Rolling deployment
683683

684-
To deploy a new version of a service that is already `running`, use `dstack apply`. `dstack` will automatically detect changes and suggest to update the run.
684+
To deploy a new version of a service that is already `running`, use `dstack apply`. `dstack` will automatically detect changes and suggest a rolling deployment update.
685685

686686
<div class="termy">
687687

@@ -700,9 +700,10 @@ Update the run? [y/n]:
700700

701701
</div>
702702

703-
To update a replica, `dstack` starts a new replica, then waits until it becomes `running`, then terminates the old replica. If the service has multiple replicas, they are updated one by one &mdash; `dstack` does not proceed to updating the next replica until the previous one was fully updated. New and old replicas can coexist and handle requests simultaneously until deployment finishes.
703+
If approved, `dstack` updates each replica one by one—waiting for each to reach the `running` state before updating the next.
704+
New and old replicas coexist and handle requests in parallel.
704705

705-
You can track the deployment progress in both `dstack apply` or `dstack ps`.
706+
You can track the progress of rolling deployment in both `dstack apply` or `dstack ps`.
706707
Older replicas have lower `deployment` numbers; newer ones have higher.
707708

708709
<!--
@@ -722,16 +723,16 @@ $ dstack apply -f my-service.dstack.yml
722723

723724
The rolling deployment stops when all replicas are updated or when a new deployment is submitted.
724725

725-
??? info "Updatable properties"
726+
??? info "Supported properties"
726727
<!-- NOTE: should be in sync with constants in server/services/runs.py -->
727728

728-
Rolling deployments apply to the following configuration properties: `resources`, `volumes`, `docker`, `files`, `image`, `user`, `privileged`, `entrypoint`, `working_dir`, `python`, `nvcc`, `single_branch`, `env`, `shell`, `commands`. They also apply to changes to [repo](repos.md) or [file](#files) contents.
729+
Rolling deployment supports changes to the following properties: `resources`, `volumes`, `docker`, `files`, `image`, `user`, `privileged`, `entrypoint`, `working_dir`, `python`, `nvcc`, `single_branch`, `env`, `shell`, `commands`, as well as changes to [repo](repos.md) or [file](#files) contents.
729730

730-
Additionally, changes to `replicas` and `scaling` can be applied without redeploying replicas.
731+
Changes to `replicas` and `scaling` can be applied without redeploying replicas.
731732

732-
Changes to other properties will require a full service restart.
733+
Changes to other properties require a full service restart.
733734

734-
To trigger a rolling deployment when no properties have changed (e.g., after updating [secrets](secrets.md) or to restart all replicas),
735+
To trigger a rolling deployment when no properties have changed (e.g., after updating [secrets](secrets.md) or to restart all replicas),
735736
make a minor config change, such as adding a dummy [environment variable](#environment-variables).
736737

737738
--8<-- "docs/concepts/snippets/manage-runs.ext"

0 commit comments

Comments
 (0)