diff --git a/_topic_map.yml b/_topic_map.yml index 777f08c584..2b5694bfc8 100644 --- a/_topic_map.yml +++ b/_topic_map.yml @@ -757,6 +757,8 @@ Topics: File: creating-applications-using-cli - Name: Viewing application composition using the Topology view File: odc-viewing-application-composition-using-topology-view + - Name: Editing applications + File: odc-editing-applications - Name: Deleting applications File: odc-deleting-applications - Name: Service brokers diff --git a/applications/application_life_cycle_management/odc-editing-applications.adoc b/applications/application_life_cycle_management/odc-editing-applications.adoc new file mode 100644 index 0000000000..133adb233c --- /dev/null +++ b/applications/application_life_cycle_management/odc-editing-applications.adoc @@ -0,0 +1,17 @@ +[id="odc-editing-applications"] += Editing applications +include::modules/common-attributes.adoc[] +:context: odc-editing-applications +toc::[] + +You can edit the configuration and the source code of the application you create using the *Topology* view. + +.Prerequisites + +* You have xref:../../web_console/web-console.adoc#web-console[logged in to the web console] and have switched to the xref:../../web_console/odc-about-developer-perspective.adoc#odc-about-developer-perspective[*Developer* perspective]. +* You have the appropriate xref:../../authentication/using-rbac.adoc#default-roles_using-rbac[roles and permissions] in a project to create and modify applications in {product-title}. +* You have xref:../../applications/application_life_cycle_management/odc-creating-applications-using-developer-perspective.adoc#odc-creating-applications-using-developer-perspective[created and deployed an application on {product-title} using the *Developer* perspective]. + +include::modules/odc-editing-source-code-using-developer-perspective.adoc[leveloffset=+1] + +include::modules/odc-editing-application-configuration-using-developer-perspective.adoc[leveloffset=+1] diff --git a/images/odc_edit_app.png b/images/odc_edit_app.png new file mode 100644 index 0000000000..bdf41a27b4 Binary files /dev/null and b/images/odc_edit_app.png differ diff --git a/images/odc_edit_redeploy.png b/images/odc_edit_redeploy.png new file mode 100644 index 0000000000..3708f28682 Binary files /dev/null and b/images/odc_edit_redeploy.png differ diff --git a/modules/odc-editing-application-configuration-using-developer-perspective.adoc b/modules/odc-editing-application-configuration-using-developer-perspective.adoc new file mode 100644 index 0000000000..9ce808b501 --- /dev/null +++ b/modules/odc-editing-application-configuration-using-developer-perspective.adoc @@ -0,0 +1,34 @@ +// Module included in the following assemblies: +// +// applications/application_life_cycle_management/odc-editing-applications.adoc + +[id="odc-editing-application-configuration-using-developer-perspective_{context}"] += Editing the application configuration using the Developer perspective + +You can use the the *Topology* view in the *Developer* perspective to edit the configuration of your application. + +[NOTE] +==== +Currently, only configurations of applications created by using the *From Git*, *Container Image*, *From Catalog*, or *From Dockerfile* options in the *Add* workflow of the *Developer* perspective can be edited. Configurations of applications created by using the CLI or the *YAML* option from the *Add* workflow cannot be edited. +==== + +.Prerequisites +Ensure that you have created an application using the *From Git*, *Container Image*, *From Catalog*, or *From Dockerfile* options in the *Add* workflow. + +.Procedure + +. After you have created an application and it is displayed in the *Topology* view, right-click the application to see the edit options available. ++ +image::odc_edit_app.png[Edit application] ++ +. Click *Edit _application-name_* to see the *Add* workflow you used to create the application. The form is pre-populated with the values you had added while creating the application. +. Edit the necessary values for the application. ++ +[NOTE] +==== +You cannot edit the *Name* field in the *General* section, the CI/CD pipelines, or the *Create a route to the application* field in the *Advanced Options* section. +==== ++ +. Click *Save* to restart the build and deploy a new image. ++ +image::odc_edit_redeploy.png[Edit and redeploy application] diff --git a/modules/odc-editing-source-code-using-developer-perspective.adoc b/modules/odc-editing-source-code-using-developer-perspective.adoc new file mode 100644 index 0000000000..4707a9c4f4 --- /dev/null +++ b/modules/odc-editing-source-code-using-developer-perspective.adoc @@ -0,0 +1,19 @@ +// Module included in the following assemblies: +// +// applications/application_life_cycle_management/odc-editing-applications.adoc + +[id="odc-editing-source-code-using-developer-perspective_{context}"] += Editing the source code of an application using the Developer perspective + +You can use the the *Topology* view in the *Developer* perspective to edit the source code of your application. + +.Procedure + +* In the *Topology* view, click the *Edit Source code* icon, displayed at the bottom-right of the deployed application, to access your source code and modify it. ++ +[NOTE] +==== +This feature is available only when you create applications using the *From Git*, *From Catalog*, and the *From Dockerfile* options. +==== ++ +If the *Eclipse Che* Operator is installed in your cluster, a Che workspace (image:odc_che_workspace.png[title="Che Workspace"]) is created and you are directed to the workspace to edit your source code. If it is not installed, you will be directed to the Git repository (image:odc_git_repository.png[title="Git Repository"]) your source code is hosted in. diff --git a/modules/odc-interacting-with-applications-and-components.adoc b/modules/odc-interacting-with-applications-and-components.adoc index 754ce09406..fdb97e4c9c 100644 --- a/modules/odc-interacting-with-applications-and-components.adoc +++ b/modules/odc-interacting-with-applications-and-components.adoc @@ -15,8 +15,6 @@ The *Topology* view in the *Developer* perspective of the web console provides t This feature is available only when you create applications using the *From Git*, *From Catalog*, and the *From Dockerfile* options. ==== + -If the *Eclipse Che* Operator is installed in your cluster, a Che workspace (image:odc_che_workspace.png[title="Che Workspace"]) is created and you are directed to the workspace to edit your source code. If it is not installed, you will be directed to the Git repository (image:odc_git_repository.png[title="Git Repository"]) your source code is hosted in. - * Hover your cursor over the lower left icon on the Pod to see the name of the latest build and its status. The status of the application build is indicated as *New* (image:odc_build_new.png[title="New Build"]), *Pending* (image:odc_build_pending.png[title="Pending Build"]), *Running* (image:odc_build_running.png[title="Running Build"]), *Completed* (image:odc_build_completed.png[title="Completed Build"]), *Failed* (image:odc_build_failed.png[title="Failed Build"]), and *Canceled* (image:odc_build_canceled.png[title="Canceled Build"]). * Use the *Shortcuts* menu listed on the upper-right of the screen to navigate components in the *Topology* view. * Use the *List View* icon to see a list of all your applications and use the *Topology View* icon to switch back to the *Topology* view.