Add end user restore documentation

modules/administration-guide/pages/devworkspace-backup.adoc

@@ -14,6 +14,8 @@ integrated registry or link:https://quay.io[Quay.io], to store backup archives a
 
 The backup makes a snapshot of *stopped* Workspace PVCs and stores them as tar.gz archives in the specified OCI registry.
 
+Users can restore backups from the {prod-short} dashboard. See xref:end-user-guide:restoring-workspaces-from-backups.adoc[].
+
 NOTE: By default, the {devworkspace} backup job is disabled.
 
 You can configure the backup by using the `DevWorkspaceOperatorConfig` resource with the following fields:

modules/end-user-guide/nav.adoc

@@ -17,6 +17,9 @@
 **** xref:url-parameter-for-the-existing-workspace-name.adoc[]
 ** xref:starting-a-workspace-from-a-raw-devfile-url.adoc[]
 ** xref:basic-actions-you-can-perform-on-a-workspace.adoc[]
+** xref:restoring-workspaces-from-backups.adoc[]
+*** xref:proc-restoring-a-workspace-from-backup.adoc[]
+*** xref:proc-viewing-backups-in-the-dashboard.adoc[]
 ** xref:authenticating-to-a-git-server-from-a-workspace.adoc[]
 ** xref:using-the-fuse-overlay-storage-driver.adoc[]
 *** xref:accessing-fuse.adoc[]

modules/end-user-guide/pages/getting-started-with-che.adoc

@@ -13,5 +13,6 @@ If your organization is already running a {prod-short} instance, you can get sta
 * xref:optional-parameters-for-the-urls-for-starting-a-new-workspace.adoc[]
 * xref:starting-a-workspace-from-a-raw-devfile-url.adoc[]
 * xref:basic-actions-you-can-perform-on-a-workspace.adoc[]
+* xref:restoring-workspaces-from-backups.adoc[]
 * xref:authenticating-to-a-git-server-from-a-workspace.adoc[]
 * xref:using-the-fuse-overlay-storage-driver.adoc[]

modules/end-user-guide/pages/proc-restoring-a-workspace-from-backup.adoc

@@ -0,0 +1,25 @@
+:mod-docs-content-type: PROCEDURE
+[id="restoring-a-workspace-from-backup{context}"]
+= Restoring a workspace from a backup
+
+You can start a new workspace from an existing backup by using the {prod-short} dashboard. When the restoration is complete, the dashboard opens the new workspace in a browser tab.
+
+.Prerequisites
+
+. Backups are enabled for your cluster.
+. You have identified a default registry or external registry backup image to use.
+
+.Procedure
+
+. On the Restore page, select the backup source:
+** Default registry: Select a backup from the list.
+** External registry: Provide a backup image URL.
++
+.Restore mode and backup source selection
+image::workspace-backup/restore_section_1.png[Selecting the backup source during restoration,link="{imagesdir}/workspace-backup/restore_section_1.png"]
+. Enter a name for the restored workspace.
+. Optional: Configure the memory limits, CPU limits, and the editor.
++
+.Resource limits and editor selection
+image::workspace-backup/restore_section_2.png[Configuring resources and editors for a restored workspace,link="{imagesdir}/workspace-backup/restore_section_2.png"]
+. Click Restore Workspace and wait for the workspace to start.

modules/end-user-guide/pages/proc-viewing-backups-in-the-dashboard.adoc

@@ -0,0 +1,16 @@
+:mod-docs-content-type: PROCEDURE
+[id="viewing-backups-in-the-dashboard{context}"]
+= Viewing backups in the dashboard
+
+To inspect the status of your workspace backups, view the list of available backups in the {prod-short} dashboard.
+Backups displayed in the {prod-short} dashboard are backups available in the default registry set by the administrator.
+
+.Procedure
+
+. In the {prod-short} dashboard, click Workspace.
+. Select the Backups tab to view available backups.
+
+.The Backups tab in the Workspace view
+image::workspace-backup/backups_tab.png[The Backups tab in the Workspace view of the dashboard,link="{imagesdir}/workspace-backup/backups_tab.png"]
+
+The *Active* tag represents backups for workspaces that still exist in the current cluster. Conversely, the *Deleted* tag represents backups for workspaces that no longer exist in the current cluster.

modules/end-user-guide/pages/restoring-workspaces-from-backups.adoc

@@ -0,0 +1,33 @@
+:_content-type: CONCEPT
+:description: Restoring a Che workspace from a DevWorkspace backup
+:keywords: workspace, backup, restore, devworkspace, dashboard
+:navtitle: Restoring workspaces from backups
+:page-aliases:
+
+[id="restoring-workspaces-from-backups"]
+= Restoring workspaces from backups
+
+When backups are enabled for {devworkspace} instances on your cluster, a cron job will backup workspace data for stopped workspaces.
+
+Backup storage, registry access, and schedules are configured cluster-wide by administrators in the {devworkspace} Operator.
+For administrator steps, see xref:administration-guide:devworkspace-backup.adoc[].
+
+Backing up and restoring workspaces allows you to recover uncommitted source code changes. Note that restored workspaces use a minimal devfile rather than the original project devfile.
+
+From the {prod-short} dashboard you can:
+
+* Open the list of backups and inspect backup status.
+* Restore a workspace from a backup that is already available to you (*internal* backup), or from an image reference you provide (*external* backup).
+* Choose compute limits and the editor for the new workspace before you start the restore.
+
+When the restored workspace is ready, the dashboard opens it in a new browser tab.
+
+[NOTE]
+====
+A restored workspace is created from a minimal devfile with the restored source code being transfered to the workspace from an init container.
+The *Devfile* tab in the workspace will not show the original devfile from the workspace's Git repository.
+====
+
+include::proc-viewing-backups-in-the-dashboard.adoc[leveloffset=+1]
+
+include::proc-restoring-a-workspace-from-backup.adoc[leveloffset=+1]