From 477364fcd87e75b550f1d9e5485e2f6590e3a6ec Mon Sep 17 00:00:00 2001 From: nullfunc Date: Mon, 6 Jan 2025 17:43:12 -0800 Subject: [PATCH 1/5] Add information on how to teardown production apps. --- docs/tutorials/updating-your-services.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/tutorials/updating-your-services.md b/docs/tutorials/updating-your-services.md index 0e85481d2..41e1b06e1 100644 --- a/docs/tutorials/updating-your-services.md +++ b/docs/tutorials/updating-your-services.md @@ -32,6 +32,8 @@ The default deployment mode is `development`. This is the In this mode, the exis If you are running in `production` mode, the update will be done with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped. +To teardown a production app deletion protection must be disabled. This can be done in two ways. Use `defang compose up --mode=staging` to change the app to a non-delete protected mode. `defang compose down` can then be executed after the deployment mode has been changed. Alternatively, in the AWS console for EC2 Instances dashboard you can turn off Termination Protection for the desired app. + :::info For more information on Deployment Modes, see the [Deployment Modes](/docs/concepts/deployment-modes) concept documentation. ::: From c273c575799a8ed526f5de351fc1b60ae58a7119 Mon Sep 17 00:00:00 2001 From: nullfunc Date: Mon, 6 Jan 2025 17:49:43 -0800 Subject: [PATCH 2/5] Update text consistency --- docs/tutorials/updating-your-services.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/tutorials/updating-your-services.md b/docs/tutorials/updating-your-services.md index 41e1b06e1..5e8296f1a 100644 --- a/docs/tutorials/updating-your-services.md +++ b/docs/tutorials/updating-your-services.md @@ -32,7 +32,14 @@ The default deployment mode is `development`. This is the In this mode, the exis If you are running in `production` mode, the update will be done with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped. -To teardown a production app deletion protection must be disabled. This can be done in two ways. Use `defang compose up --mode=staging` to change the app to a non-delete protected mode. `defang compose down` can then be executed after the deployment mode has been changed. Alternatively, in the AWS console for EC2 Instances dashboard you can turn off Termination Protection for the desired app. +To teardown a production app Termination Protection must be disabled. This can be done in two ways. + +- Use `defang compose up --mode=staging` to change the app to a non-delete protected mode. `defang compose down` can then be executed after the deployment mode has been changed. + +OR + +- Alternatively, in the AWS console for EC2 Instances dashboard you can turn off Termination Protection for the desired app. + :::info For more information on Deployment Modes, see the [Deployment Modes](/docs/concepts/deployment-modes) concept documentation. From 23a607cb3fa902e0825a5b71010fbce3d146ab07 Mon Sep 17 00:00:00 2001 From: nullfunc Date: Mon, 6 Jan 2025 17:50:51 -0800 Subject: [PATCH 3/5] fix - remove extra line --- docs/tutorials/updating-your-services.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/tutorials/updating-your-services.md b/docs/tutorials/updating-your-services.md index 5e8296f1a..78d8d4855 100644 --- a/docs/tutorials/updating-your-services.md +++ b/docs/tutorials/updating-your-services.md @@ -40,7 +40,6 @@ OR - Alternatively, in the AWS console for EC2 Instances dashboard you can turn off Termination Protection for the desired app. - :::info For more information on Deployment Modes, see the [Deployment Modes](/docs/concepts/deployment-modes) concept documentation. ::: From 909272c1f5768c1dcbe011ad6f3f8427ab30e483 Mon Sep 17 00:00:00 2001 From: nullfunc Date: Tue, 7 Jan 2025 22:42:40 -0800 Subject: [PATCH 4/5] Update with deleting production information --- docs/tutorials/updating-your-services.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/tutorials/updating-your-services.md b/docs/tutorials/updating-your-services.md index 78d8d4855..b55cc39df 100644 --- a/docs/tutorials/updating-your-services.md +++ b/docs/tutorials/updating-your-services.md @@ -32,13 +32,12 @@ The default deployment mode is `development`. This is the In this mode, the exis If you are running in `production` mode, the update will be done with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped. -To teardown a production app Termination Protection must be disabled. This can be done in two ways. +To delete a production app, use `defang compose down`. In some cases, particularly on the AWS platform, additional actions to be required. Specifically load balancers may have Detetion Protection on. To turn this off in the AWS Console for EC2 Load Balancers, follow these steps: -- Use `defang compose up --mode=staging` to change the app to a non-delete protected mode. `defang compose down` can then be executed after the deployment mode has been changed. - -OR - -- Alternatively, in the AWS console for EC2 Instances dashboard you can turn off Termination Protection for the desired app. + 1. Select the load balancer corresponding to the app’s name. + 2. Go to the Attributes tab. + 3. Click the Edit button. + 4. Locate Deletion Protection and disable it. :::info For more information on Deployment Modes, see the [Deployment Modes](/docs/concepts/deployment-modes) concept documentation. From 63c0c4d07adb79ce9e87a30902745c5a91a41a46 Mon Sep 17 00:00:00 2001 From: nullfunc Date: Wed, 8 Jan 2025 13:20:01 -0800 Subject: [PATCH 5/5] Update docs/tutorials/updating-your-services.md Co-authored-by: Jordan Stephens --- docs/tutorials/updating-your-services.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/tutorials/updating-your-services.md b/docs/tutorials/updating-your-services.md index b55cc39df..39dd94527 100644 --- a/docs/tutorials/updating-your-services.md +++ b/docs/tutorials/updating-your-services.md @@ -32,7 +32,11 @@ The default deployment mode is `development`. This is the In this mode, the exis If you are running in `production` mode, the update will be done with zero downtime. Your current version of the service will keep running and handling traffic while the new version is being built and deployed. Only after the new version passes the health checks and accepts traffic will the older version be stopped. -To delete a production app, use `defang compose down`. In some cases, particularly on the AWS platform, additional actions to be required. Specifically load balancers may have Detetion Protection on. To turn this off in the AWS Console for EC2 Load Balancers, follow these steps: +## Deleting your Application + +To delete your app, use `defang compose down` in your compose file working directory, or use the `--project-name` flag. + +In some cases, particularly on the AWS platform, additional actions may be required. Specifically load balancers may have Deletion Protection on. To turn this off in the AWS Console for EC2 Load Balancers, follow these steps: 1. Select the load balancer corresponding to the app’s name. 2. Go to the Attributes tab.