Merge pull request #61709 from abrennan89/RHDEVDOCS-2831-1

RHDEVDOCS-2831: Add module for editing deployments

Author: abrennan89

applications/deployments/deployment-strategies.adoc

@@ -28,7 +28,12 @@ A deployment strategy uses readiness checks to determine if a new pod is ready f
 // Rolling strategies
 include::modules/deployments-rolling-strategy.adoc[leveloffset=+1]
 include::modules/deployments-canary-deployments.adoc[leveloffset=+2]
-include::modules/deployments-creating-rolling-deployment.adoc[leveloffset=+2]
+// Creating rolling deployments
+include::modules/creating-rolling-deployments-CLI.adoc[leveloffset=+2]
+// Editing a deployment
+:context: rolling-strategy
+include::modules/odc-editing-deployments.adoc[leveloffset=+2]
+// Starting a deployment
 include::modules/odc-starting-rolling-deployment.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
@@ -38,6 +43,10 @@ include::modules/odc-starting-rolling-deployment.adoc[leveloffset=+2]
 
 // Recreate strategies
 include::modules/deployments-recreate-strategy.adoc[leveloffset=+1]
+// Editing a deployment
+:context: recreate-strategy
+include::modules/odc-editing-deployments.adoc[leveloffset=+2]
+// Starting a deployment
 include::modules/odc-starting-recreate-deployment.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
@@ -47,4 +56,8 @@ include::modules/odc-starting-recreate-deployment.adoc[leveloffset=+2]
 
 // Custom strategies
 include::modules/deployments-custom-strategy.adoc[leveloffset=+1]
+// Editing a deployment
+:context: custom-strategy
+include::modules/odc-editing-deployments.adoc[leveloffset=+2]
+
 include::modules/deployments-lifecycle-hooks.adoc[leveloffset=+1]

modules/deployments-creating-rolling-deployment.adoc renamed to modules/creating-rolling-deployments-CLI.adoc

@@ -0,0 +1,25 @@
+// Module included in the following assemblies:
+//
+// * applications/deployments/deployment-strategies.adoc
+
+:_content-type: PROCEDURE
+[id="odc-editing-deployments_{context}"]
+= Editing a deployment by using the Developer perspective
+
+You can edit the deployment strategy, image settings, environment variables, and advanced options for your deployment by using the *Developer* perspective.
+
+.Prerequisites
+
+* You are in the *Developer* perspective of the web console.
+* You have created an application.
+
+.Procedure
+
+. Navigate to the *Topology* view. Click on your application to see the *Details* panel.
+. In the *Actions* drop-down menu, select *Edit Deployment* to view the *Edit Deployment* page.
+. You can edit the following *Advanced options* for your deployment:
+.. Optional: You can pause rollouts by clicking *Pause rollouts*, and then selecting the *Pause rollouts for this deployment* checkbox.
++
+By pausing rollouts, you can make changes to your application without triggering a rollout. You can resume rollouts at any time.
+.. Optional: Click *Scaling* to change the number of instances of your image by modifying the number of *Replicas*.
+. Click *Save*.

modules/odc-editing-deployments.adoc

@@ -6,13 +6,14 @@
 [id="odc-starting-rolling-deployment_{context}"]
 = Starting a rolling deployment using the Developer perspective
 
+You can upgrade an application by starting a rolling deployment.
+
 .Prerequisites
-* Ensure that you are in the *Developer* perspective of the web console.
-* Ensure that you have created an application using the *Add* view and see it deployed in the *Topology* view.
 
-.Procedure
+* You are in the *Developer* perspective of the web console.
+* You have created an application.
 
-To start a rolling deployment to upgrade an application:
+.Procedure
 
 . In the *Topology* view of the *Developer* perspective, click on the application node to see the *Overview* tab in the side panel. Note that the *Update Strategy* is set to the default *Rolling* strategy.
 . In the *Actions* drop-down menu, select *Start Rollout* to start a rolling update. The rolling deployment spins up the new version of the application and then terminates the old one.