Skip to content

Commit 0c86985

Browse files
committed
Comply with DITA - Mng content (#4520)
1 parent 10d41c6 commit 0c86985

7 files changed

+66
-39
lines changed
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
:_mod-docs-content-type: ASSEMBLY
2+
3+
include::modules/con_content-access-control-for-hosts.adoc[]
4+
5+
include::modules/con_content-access-strategies.adoc[leveloffset=+1]
6+
7+
include::modules/con_conditions-for-content-availability.adoc[leveloffset=+1]
8+
9+
include::modules/con_activation-keys-and-content-access.adoc[leveloffset=+1]

guides/common/assembly_restricting-hosts-access-to-content.adoc

Lines changed: 0 additions & 3 deletions
This file was deleted.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
:_mod-docs-content-type: CONCEPT
2+
3+
[id="activation-keys-and-content-access"]
4+
= Activation keys and content access
5+
6+
[role="_abstract"]
7+
Activation keys simplify the workflow for some of the content access strategies.
8+
9+
You can use activation keys to perform the following actions:
10+
11+
* Assign hosts to content view environments.
12+
* Add content overrides to hosts.
13+
* Set system purpose attributes on hosts, including a release version.
14+
15+
Activation keys only affect hosts during registration.
16+
If a host is already registered, you can change the content access individually for each host or through content host bulk actions.
17+
18+
.Additional resources
19+
* xref:Managing_Activation_Keys_{context}[]
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
:_mod-docs-content-type: CONCEPT
2+
3+
[id="conditions-for-content-availability"]
4+
= Conditions for content availability
5+
6+
[role="_abstract"]
7+
A host can access a package or repository only when all of the following conditions are true.
8+
9+
* The repository is included in the content view environments of the host.
10+
* The content view of the host has been published after the repository was added to it.
11+
* The repository has not been filtered out by a content view filter.
12+
* The repository is enabled by default or overridden to *Enabled* by using a content override.
13+
* The repository has no architecture or operating system version restrictions or it has architecture or operating system version restrictions that match the host.
14+
ifndef::orcharhino[]
15+
* For certain Red{nbsp}Hat repositories either no release version is set or the release version matches that of the host.
16+
endif::[]
17+
ifdef::orcharhino[]
18+
ifdef::red_hat_enterprise_linux[]
19+
* For certain Red{nbsp}Hat repositories either no release version is set or the release version matches that of the host.
20+
endif::[]
21+
endif::[]
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
:_mod-docs-content-type: CONCEPT
2+
3+
[id="content-access-control-for-hosts"]
4+
= Content access control for {Project} hosts
5+
6+
[role="_abstract"]
7+
{Project} provides a robust set of strategies for controlling what content is accessible to your hosts.
8+
You can restrict content access by using core mechanisms, such as content views, lifecycle environments, and content overrides.
9+
You can use activation keys to apply these content access controls during host registration.

guides/common/modules/con_restricting-hosts-access-to-content.adoc renamed to guides/common/modules/con_content-access-strategies.adoc

Lines changed: 7 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,12 @@
11
:_mod-docs-content-type: CONCEPT
22

3-
[id="Restricting_Hosts_Access_to_Content_{context}"]
4-
= Restricting hosts' access to content
3+
[id="content-access-strategies"]
4+
= Content access strategies
55

6-
{Project} offers multiple options for restricting host access to content.
6+
[role="_abstract"]
77
To give hosts access to a specific subset of the content managed by {Project}, you can use the following strategies.
8-
{Team} recommends to consider implementing the strategies in the order listed here:
8+
9+
{Team} recommends considering implementing the strategies in the order as listed here:
910

1011
Content views and lifecycle environments::
1112
Use content views and lifecycle environments, incorporating content view filters as needed.
@@ -63,43 +64,14 @@ Release version::
6364
Certain Red{nbsp}Hat repositories, such as the {RHEL} dot release repositories, include a *Release version* in their repository metadata.
6465
The release version is then compared with the release version specified in the *System purpose* properties of the host.
6566
Access to content may be limited or restricted based on this comparison.
66-
For more information about setting system purpose attributes, see {ManagingHostsDocURL}Creating_a_Host_managing-hosts[Creating a Host in {ProjectName}] in _{ManagingHostsDocTitle}_.
67+
For more information about setting system purpose attributes, see {ManagingHostsDocURL}editing-the-system-purpose-of-a-host-by-using-web-ui[Editing the system purpose of a host] in _{ManagingHostsDocTitle}_.
6768
endif::[]
6869
ifdef::orcharhino[]
6970
ifdef::red_hat_enterprise_linux[]
7071
Release version::
7172
Certain Red{nbsp}Hat repositories, such as the {RHEL} dot release repositories, include a *Release version* in their repository metadata.
7273
The release version is then compared with the release version specified in the *System purpose* properties of the host.
7374
Access to content may be limited or restricted based on this comparison.
74-
For more information about setting system purpose attributes, see {ManagingHostsDocURL}Creating_a_Host_managing-hosts[Creating a Host in {ProjectName}] in _{ManagingHostsDocTitle}_.
75-
endif::[]
76-
endif::[]
77-
78-
.Incorporating all strategies
79-
A particular package or repository is available to a host only if all of the following are true:
80-
81-
* The repository is included in the content view environments of the host.
82-
* The host's content view has been published after the repository was added to it.
83-
* The repository has not been filtered out by a content view filter.
84-
* The repository is enabled by default or overridden to *Enabled* by using a content override.
85-
* The repository has no architecture or operating system version restrictions or it has architecture or operating system version restrictions that match the host.
86-
ifndef::orcharhino[]
87-
* For certain Red{nbsp}Hat repositories either no release version is set or the release version matches that of the host.
88-
endif::[]
89-
ifdef::orcharhino[]
90-
ifdef::red_hat_enterprise_linux[]
91-
* For certain Red{nbsp}Hat repositories either no release version is set or the release version matches that of the host.
75+
For more information about setting system purpose attributes, see {ManagingHostsDocURL}editing-the-system-purpose-of-a-host-by-using-web-ui[Editing the system purpose of a host] in _{ManagingHostsDocTitle}_.
9276
endif::[]
9377
endif::[]
94-
95-
.Using activation keys
96-
Using activation keys can simplify the workflow for some of these strategies.
97-
You can use activation keys to perform the following actions:
98-
99-
* Assign hosts to content view environments.
100-
* Add content overrides to hosts.
101-
* Set system purpose attributes on hosts, including release version.
102-
103-
Activation keys only affect hosts during registration.
104-
If a host is already registered, the above attributes can be changed individually for each host or through content host bulk actions.
105-
For more information, see {ContentManagementDocURL}Managing_Activation_Keys_content-management[Managing Activation Keys] in _{ContentManagementDocTitle}_.

guides/doc-Managing_Content/master.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ include::common/assembly_managing-alternate-content-sources.adoc[leveloffset=+1]
3838

3939
include::common/assembly_importing-content.adoc[leveloffset=+1]
4040

41-
include::common/assembly_restricting-hosts-access-to-content.adoc[leveloffset=+1]
41+
include::common/assembly_content-access-control-for-hosts.adoc[leveloffset=+1]
4242

4343
include::common/assembly_managing-application-lifecycles.adoc[leveloffset=+1]
4444

0 commit comments

Comments
 (0)