diff --git a/guides/common/modules/con_managing-flatpak-repositories-in-project.adoc b/guides/common/modules/con_managing-flatpak-repositories-in-project.adoc index 0c3e33ee095..eb35a770826 100644 --- a/guides/common/modules/con_managing-flatpak-repositories-in-project.adoc +++ b/guides/common/modules/con_managing-flatpak-repositories-in-project.adoc @@ -4,8 +4,7 @@ = Managing Flatpak repositories in {Project} [role="_abstract"] -Flatpak allows users to install, manage, and run portable applications, primarily for desktop environments. -In {Project}, you can integrate Flatpak remotes and synchronize Flatpak repositories into products to manage application content centrally. +Flatpak remotes in {Project} connect to external application indexes so you can scan available repositories, mirror them into products, and distribute desktop application content to hosts. Flatpak repositories function similarly to other content repositories in {Project}. You can synchronize, manage access permissions, and assign repositories to specific lifecycle environments to control which applications are available to hosts. diff --git a/guides/common/modules/proc_creating-a-flatpak-remote-by-using-cli.adoc b/guides/common/modules/proc_creating-a-flatpak-remote-by-using-cli.adoc index 9b48f3c11c1..029cec3fcf3 100644 --- a/guides/common/modules/proc_creating-a-flatpak-remote-by-using-cli.adoc +++ b/guides/common/modules/proc_creating-a-flatpak-remote-by-using-cli.adoc @@ -4,7 +4,7 @@ = Creating a Flatpak remote by using Hammer CLI [role="_abstract"] -You can create a Flatpak remote to access and manage Flatpak repositories by using Hammer CLI. +Add a Flatpak remote to your {Project} inventory to scan it, mirror selected repositories into your products, and distribute desktop application content to hosts. .Prerequisites * Your {Project} account has a role that grants the `create_flatpak_remotes` permission. diff --git a/guides/common/modules/proc_creating-a-flatpak-remote-by-using-web-ui.adoc b/guides/common/modules/proc_creating-a-flatpak-remote-by-using-web-ui.adoc index df43c9c924e..26e142cda17 100644 --- a/guides/common/modules/proc_creating-a-flatpak-remote-by-using-web-ui.adoc +++ b/guides/common/modules/proc_creating-a-flatpak-remote-by-using-web-ui.adoc @@ -4,7 +4,7 @@ = Creating a Flatpak remote by using {ProjectWebUI} [role="_abstract"] -You can create a Flatpak remote to access and manage Flatpak repositories in {ProjectWebUI}. +Add a Flatpak remote to your {Project} inventory to scan it, mirror selected repositories into your products, and distribute desktop application content to hosts. .Prerequisites * Your {Project} account has a role that grants the `create_flatpak_remotes` permission. diff --git a/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-cli.adoc b/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-cli.adoc index 30aa0e07b04..3d8b7e08c33 100644 --- a/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-cli.adoc +++ b/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-cli.adoc @@ -4,7 +4,7 @@ = Mirroring remote Flatpak repositories to {Project} products by using Hammer CLI [role="_abstract"] -You can mirror a Flatpak repository from a Flatpak remote into an existing product in {Project} to make it available for content management and distribution. +Mirror a Flatpak repository from a scanned remote into an existing product so you can synchronize it and publish application content to hosts through content views. This action creates a new repository inside the product you selected. You can now synchronize the repository to pull down its content. @@ -16,12 +16,13 @@ To make the {EL} 10 Mozilla Firefox Flatpak available to a host, ensure that the endif::[] .Prerequisites +* The Flatpak remote has been scanned. * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions. -* Ensure that Flatpak runtime repositories are available to hosts alongside application repositories. +* You have created a {customproduct} on {Project}. +* Flatpak runtime repositories are available to hosts alongside application repositories. ifdef::katello,satellite,almalinux,oracle_linux,red_hat_enterprise_linux,rocky_linux[] Flatpak applications, such as `rhel9/firefox-flatpak`, depend on the runtime for installation. endif::[] -* You have created a {customproduct} on {Project}. .Procedure * Mirror a Flatpak repository into your product: @@ -33,3 +34,6 @@ $ hammer flatpak-remote remote-repository mirror \ --id _My_Flatpak_Repository_ID_ \ --product-id _My_Product_ID_ ---- + +.Next steps +* xref:synchronizing-repositories-ad-hoc[] diff --git a/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-web-ui.adoc b/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-web-ui.adoc index 0b8990f893e..9339b904efb 100644 --- a/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-web-ui.adoc +++ b/guides/common/modules/proc_mirroring-remote-flatpak-repositories-to-project-products-by-using-web-ui.adoc @@ -4,7 +4,7 @@ = Mirroring remote Flatpak repositories to {Project} products by using {ProjectWebUI} [role="_abstract"] -You can mirror a Flatpak repository from a Flatpak remote into an existing product in {Project} to make it available for content management and distribution. +Mirror a Flatpak repository from a scanned remote into an existing product so you can synchronize it and publish application content to hosts through content views. This action creates a new repository inside the product you selected. You can now synchronize the repository to pull down its content. @@ -16,12 +16,13 @@ To make the {EL} 10 Mozilla Firefox Flatpak available to a host, ensure that the endif::[] .Prerequisites +* The Flatpak remote has been scanned. * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions. -* Ensure that Flatpak runtime repositories are available to hosts alongside application repositories. +* You have created a {customproduct} on {Project}. +* Flatpak runtime repositories are available to hosts alongside application repositories. ifdef::katello,satellite,almalinux,oracle_linux,red_hat_enterprise_linux,rocky_linux[] Flatpak applications, such as `rhel9/firefox-flatpak`, depend on the runtime for installation. endif::[] -* You have created a {customproduct} on {Project}. .Procedure . In the {ProjectWebUI}, navigate to *Content* > *Flatpak Remotes*. @@ -30,3 +31,6 @@ endif::[] . Select the *Mirror Action* menu on the row of the repository. . In the *Mirror* window, select the existing product where you want to create the new repository. . Click *Mirror*. + +.Next steps +* xref:synchronizing-repositories-ad-hoc[] diff --git a/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-cli.adoc b/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-cli.adoc index fc864e03161..8dc857fb301 100644 --- a/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-cli.adoc +++ b/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-cli.adoc @@ -4,11 +4,11 @@ = Scanning a Flatpak remote by using Hammer CLI [role="_abstract"] -You can scan a Flatpak remote to fetch metadata about the repositories it provides. -Scanning a Flatpak remote creates remote repository artifacts for the repositories hosted by the Flatpak remote. -If new repositories are added to the Flatpak remote, scan it again to pull in the changes. +Scan a Flatpak remote to discover the repositories its index hosts before you mirror them into products. +Rescan the remote when new repositories are added. .Prerequisites +* A Flatpak remote exists in {Project}. * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions. .Procedure diff --git a/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-web-ui.adoc b/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-web-ui.adoc index 5f87961800d..44dd05a0962 100644 --- a/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-web-ui.adoc +++ b/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-web-ui.adoc @@ -4,11 +4,11 @@ = Scanning a Flatpak remote by using {ProjectWebUI} [role="_abstract"] -You can scan a Flatpak remote to fetch metadata about the repositories it provides. -Scanning a Flatpak remote creates remote repository artifacts for the repositories hosted by the Flatpak remote. -If new repositories are added to the Flatpak remote, scan it again to pull in the changes. +Scan a Flatpak remote to discover the repositories its index hosts before you mirror them into products. +Rescan the remote when new repositories are added. .Prerequisites +* A Flatpak remote exists in {Project}. * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions. .Procedure diff --git a/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-cli.adoc b/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-cli.adoc index 5807c1f6981..327469ad58f 100644 --- a/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-cli.adoc +++ b/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-cli.adoc @@ -4,9 +4,10 @@ = Viewing Flatpak remote details by using Hammer CLI [role="_abstract"] -You can view a list of the repositories a scanned Flatpak remote provides. +Review the repositories a scanned Flatpak remote provides to decide which ones to mirror into your products. .Prerequisites +* The Flatpak remote has been scanned. * Your {Project} account has a role that grants the `view_flatpak_remotes` permission. .Procedure diff --git a/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-web-ui.adoc b/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-web-ui.adoc index 17e47c300f7..43073aba726 100644 --- a/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-web-ui.adoc +++ b/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-web-ui.adoc @@ -4,9 +4,10 @@ = Viewing Flatpak remote details by using {ProjectWebUI} [role="_abstract"] -You can view a list of the repositories a scanned Flatpak remote provides. +Review the repositories a scanned Flatpak remote provides to decide which ones to mirror into your products. .Prerequisites +* The Flatpak remote has been scanned. * Your {Project} account has a role that grants the `view_flatpak_remotes` permission. .Procedure