Skip to content

Commit d812e2d

Browse files
Merge pull request mendix#10711 from feddovanede/patch-573444
Clarify ZDT setup and deployment instructions
2 parents bf54a03 + 7800748 commit d812e2d

1 file changed

Lines changed: 9 additions & 10 deletions

File tree

content/en/docs/deployment/mendix-cloud-deploy/zero-downtime.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,23 +18,23 @@ With ZDT, Mendix Cloud intelligently manages the deployment process, ensuring yo
1818

1919
To leverage the benefits of zero-downtime deployment, your Mendix application and deployment environment must meet the following criteria:
2020

21-
* **Mendix runtime version** – Must be running on Mendix Runtime version 10.24 or higher.
21+
* **Mendix runtime version** – Must be running on Mendix Runtime version 10.24 or above.
2222
* **Application instances** – The application must be configured to run with a single runtime instance.
2323
* **Change type** – The deployment must involve only [configuration-level changes](/developerportal/deploy/zero-downtime/#zdt-application).
2424
* **Deployment platform** – Must be deployed on Mendix Cloud(Kubernetes).
2525

2626
{{% alert color="info" %}}
27-
No special setup is required to enable ZDT. When your application and deployment meet these prerequisites, ZDT is automatically applied for eligible changes and can be controlled directly by Technical Contacts through the [Environment Settings](/developerportal/deploy/environments/#environment-settings).
27+
No special setup is required to enable ZDT. When your application and deployment meet these prerequisites, ZDT is automatically available for eligible changes.
2828
{{% /alert %}}
2929

3030
## How Zero-Downtime Deployment Works
3131

3232
<!-- Diagram provided by the deployment team. Contact the team for updates or questions -->
3333
{{< figure src="/attachments/deployment/mendix-cloud-deploy/zero-downtime/zdt-process-success-flow.png" alt="Sequence diagram illustrating the Zero-Downtime Deployment process, showing the Technical Contact initiating deployment, Mendix Cloud starting a new app version in the background while the current version serves users, the new version preparing configuration and reporting ready, Mendix Cloud gracefully stopping the old version, and finally directing traffic to the new version without user interruption." >}}
3434

35-
When an eligible configuration change is deployed with ZDT enabled, Mendix Cloud orchestrates the following steps:
35+
When an eligible configuration change is deployed with ZDT, Mendix Cloud orchestrates the following steps:
3636

37-
1. **Initiate deployment** – The Technical Contact triggers deployment with **Deploy without Downtime** enabled in Mendix Cloud.
37+
1. **Initiate deployment** – The Technical Contact triggers deployment with **Deploy without Downtime** in Mendix Cloud.
3838
2. **Current version active** – The existing application version continues to serve all user traffic without interruption.
3939
3. **New version spin-up** – A new instance of your application starts, adding the updated configuration, in the background. This new version prepares its configuration.
4040
4. **Health check & readiness** – Once the new instance is fully operational and passes all internal health checks, it reports its readiness to Mendix Cloud.
@@ -46,10 +46,10 @@ When an eligible configuration change is deployed with ZDT enabled, Mendix Cloud
4646

4747
By default, this option is off. In this state, your app will use the standard restart process during deployment. This default setting ensures stability and compatibility with existing application behavior.
4848

49-
Technical Contacts can decide whether to attempt a zero-downtime deployment by selecting the **Deploy without downtime** option on the **Other Options** tab when [deploying a package](/developerportal/deploy/environments/#deploy-wizard). If you enable this option, Mendix Cloud will attempt a zero-downtime deployment, if your environment meets eligibility criteria.
49+
Technical Contacts can decide whether to attempt a zero-downtime deployment by selecting the **Deploy without downtime** option on the **Other Options** tab when [deploying a package](/developerportal/deploy/environments/#deploy-wizard). If you select this option, Mendix Cloud will attempt a zero-downtime deployment.
5050

5151
{{% alert color="info" %}}
52-
When a Technical Contact enables ZDT, the Cloud Portal displays a reminder to review any custom **before-shutdown** or **after-startup** microflows. This is crucial to ensure these microflows won’t cause conflicts during periods when two versions of your application might be running concurrently.
52+
When a Technical Contact selects ZDT, the Cloud Portal displays a reminder to review any custom **before-shutdown** or **after-startup** microflows. This is crucial to ensure these microflows won’t cause conflicts during periods when two versions of your application might be running concurrently.
5353
{{% /alert %}}
5454

5555
### When ZDT Applies {#zdt-application}
@@ -70,15 +70,14 @@ During these types of updates, Mendix Cloud performs the deployment in a way tha
7070

7171
Zero-downtime deployment will not apply under the following conditions:
7272

73-
* Mendix Runtime version is less than 10.24
73+
* Mendix Runtime versions below 10.24
7474
* Application runs with more than one runtime instance
7575
* Upgrading to a new Mendix Runtime version
7676
* Deploying a new MDA (application model update)
7777
* Changes involve database structure updates
7878
{{< figure src="/attachments/deployment/mendix-cloud-deploy/zero-downtime/zdt-scaling-process.png" >}}
7979

80-
For these scenarios, the Cloud Portal will display the standard restart message before deployment:
81-
{{< figure src="/attachments/deployment/mendix-cloud-deploy/zero-downtime/zdt-scaling-messages.png" >}}
80+
For these scenarios, the Cloud Portal will display the standard restart message before deployment.
8281

8382
## Expected ZDT Behavior
8483

@@ -102,7 +101,7 @@ For eligible environments, the **Deploy Wizard** clearly indicates that the upco
102101

103102
### First Deployment
104103

105-
When you deploy an application on Mendix Runtime 10.24 or higher for the very first time, the environment is automatically prepared for future zero-downtime deployments. This initial deployment behaves like a regular one, but from the next deployment onward, eligible configuration changes can be applied without downtime.
104+
When you deploy an application on Mendix Runtime 10.24 or above for the very first time, the environment is automatically prepared for future zero-downtime deployments. This initial deployment behaves like a regular one, but from the next deployment onward, eligible configuration changes can be applied without downtime.
106105

107106
### During a Zero-Downtime Deployment Failure
108107

0 commit comments

Comments
 (0)