Skip to content

Commit 9dae971

Browse files
Document assiging rolling CV to LE (#3902)
* Document optional LE assignment of Rolling CV * Add good practise for rolling CV in LEs Refs PR 11407 in katello on GitHub
1 parent 69f7f82 commit 9dae971

5 files changed

+54
-0
lines changed

guides/common/assembly_managing-content-views.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ include::modules/con_rolling-content-views.adoc[leveloffset=+1]
2222

2323
include::modules/proc_creating-a-rolling-content-view.adoc[leveloffset=+1]
2424

25+
include::modules/proc_assigning-a-rolling-content-view-to-lifecycle-environments.adoc[leveloffset=+1]
26+
2527
include::modules/con_composite-content-views-overview.adoc[leveloffset=+1]
2628

2729
include::modules/proc_creating-a-composite-content-view.adoc[leveloffset=+1]

guides/common/modules/con_rolling-content-views.adoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,3 +9,6 @@ You can use a rolling content view to provide a continuous stream of synchronize
99

1010
When you synchronize repositories to {Project}, all rolling content views that contain them get automatically updated to include the latest changes.
1111
You do not have to publish and/or promote a rolling content view compared to content views or composite content views.
12+
13+
Instead, you can assign rolling content views to one or multiple lifecycle environments.
14+
This allows you to control which content is synchronized from {ProjectServer} to {SmartProxyServers}.
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
[id="assigning-a-rolling-content-view-to-lifecycle-environments"]
2+
= Assigning a rolling content view to lifecycle environments
3+
4+
You can assign your rolling content view to lifecycle environments to limit content synchronized to {SmartProxyServers}.
5+
To use the CLI instead of the {ProjectWebUI}, see the xref:cli-assigning-a-rolling-content-view-to-lifecycle-environments[].
6+
7+
.Procedure
8+
. In the {ProjectWebUI}, navigate to *Content* > *Lifecycle* > *Content Views*.
9+
. Select your rolling content view.
10+
. Select the *Details* tab.
11+
. In the *Lifecycle Environments* field, assign your rolling content view to your lifecycle environments.
12+
. Click *Save Environments* to submit your changes to {Project}.
13+
14+
[id="cli-assigning-a-rolling-content-view-to-lifecycle-environments"]
15+
.CLI procedure
16+
. List all content views:
17+
+
18+
[options="nowrap" subs="+quotes"]
19+
----
20+
$ hammer content-view list \
21+
--fields id,name \
22+
--organization "_My_Organization_"
23+
----
24+
. Assign your rolling content view to lifecycle environments:
25+
+
26+
[options="nowrap" subs="+quotes"]
27+
----
28+
$ hammer content-view update \
29+
--id _My_Rolling_Content_View_ID_ \
30+
--lifecycle-environment-ids _My_List_Of_Lifecycle_Environment_IDs_ \
31+
--organization "_My_Organization_"
32+
----
33+
+
34+
If you want to remove your rolling content view from all lifecycle environments, pass an empty list.
35+
36+
.Next steps
37+
* Synchronize lifecycle environments to {SmartProxyServers}.
38+
For more information, see {AdministeringDocURL}Synchronizing_Content_from_{project-context}_Server_to_{smart-proxy-context-titlecase}_Servers_admin[Synchronizing content from {ProjectServer} to {SmartProxyServers}] in _{AdministeringDocTitle}_.

guides/common/modules/proc_creating-a-rolling-content-view.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,22 @@ To use the CLI instead of the {ProjectWebUI}, see the xref:cli-creating-a-rollin
1313
{Project} automatically completes the *Label* field from the name you enter.
1414
. Optional: In the *Description* field, enter a description of the content view.
1515
. On the *Type* tab, select *Rolling content view*.
16+
. Optional: In the *Lifecycle Environments* field, assign your rolling content view to your lifecycle environments.
1617
. Click *Create content view*.
1718
. Click *Show repositories*.
1819
. Select the repositories that you want to add to your rolling content view.
1920
. Click *Add repositories* to add all selected repositories to your rolling content view.
2021

2122
[id="cli-creating-a-rolling-content-view"]
2223
.CLI procedure
24+
. List all available lifecycle environments:
25+
+
26+
[options="nowrap" subs="+quotes"]
27+
----
28+
$ hammer lifecycle-environment list \
29+
--fields id,name \
30+
--organization "_My_Organization_"
31+
----
2332
. List all available repositories to identify IDs of repositories to add to your rolling content view:
2433
+
2534
[options="nowrap" subs="+quotes"]
@@ -33,6 +42,7 @@ $ hammer repository list \
3342
[options="nowrap" subs="+quotes"]
3443
----
3544
$ hammer content-view create \
45+
--lifecycle-environment-ids _My_List_Of_Lifecycle_Environment_IDs_ \
3646
--name "_My_Rolling_Content_View_" \
3747
--organization "_My_Organization_" \
3848
--repository-ids _My_List_Of_Repository_IDs_ \

guides/common/modules/ref_best-practices-for-content-views.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
* Content views that bundle content, such as {client-os} and additional software like `Apache-2.4` or `PostgreSQL-16.2`, are easier to maintain.
77
Content views that are too small require more maintenance.
88
* If you require daily updated content, use the content view `Default Organization View`, which contains the latest synchronized content from all repositories and is available in the Library lifecycle environment.
9+
* If you require daily updated content for hosts registered to a specific {SmartProxyServer}, use rolling content views and assign them to a lifecycle environment other than *Library*.
910
* To give hosts access to content from multiple content views, such as when you update one content view weekly and another monthly, you have two options:
1011
** Assign multiple content view environments to hosts.
1112
For more information, see xref:assigning-content-view-environments-to-hosts[].

0 commit comments

Comments
 (0)