Chapter 8. Managing Content Views

Procedure

1. In the Satellite web UI, navigate to Content > Content Views and click Create content view.
2. In the Name field, enter a name for the view. Satellite automatically completes the Label field from the name you enter.
3. In the Description field, enter a description of the view.
4. In the Type field, select a Content view or a Composite content view.
5. Optional: If you want to solve dependencies automatically every time you publish this Content View, select the Solve dependencies check box. Dependency solving slows the publishing time and might ignore any Content View filters you use. This can also cause errors when resolving dependencies for errata.
6. Optional: If you want to designate this Content View for importing from an upstream server, select the Import only check box. Import-only content views cannot be published directly.
7. Click Create content view.

Content View Steps

1. Click Create content view to create the Content View.
2. In the Repositories tab, select the repository from the Type list that you want to add to your Content View, select the checkbox next to the available repositories you want to add, then click Add repositories.
3. Click Publish new version and in the Description field, enter information about the version to log changes.
4. Optional: You can enable a promotion path by clicking Promote to Select a lifecycle environment from the available promotion paths to promote new version.
5. Click Next.
6. On the Review page, you can review the environments you are trying to publish.

7. Click Finish.

   Note

   Remove and Delete are similar but the Delete option deletes an entire Content View and the versions associated with that lifecycle environment. The Remove option allows you to choose which version you want removed from the lifecycle environment.

CLI procedure

1. Obtain a list of repository IDs:

   # hammer repository list --organization "My_Organization"

2. Create the Content View and add repositories:

   # hammer content-view create \
   --description "My_Content_View" \
   --name "My_Content_View" \
   --organization "My_Organization" \
   --repository-ids 1,2

   For the --repository-ids option, you can find the IDs in the output of the hammer repository list command.

3. Publish the view:

   # hammer content-view publish \
   --description "My_Content_View" \
   --name "My_Content_View" \
   --organization "My_Organization"

4. Optional: To add a repository to an existing Content View, enter the following command:

   # hammer content-view add-repository \
   --name "My_Content_View" \
   --organization "My_Organization" \
   --repository-id repository_ID

Procedure

1. In the Satellite web UI, navigate to a published version of a Content View > Module Streams to view the module streams that are available for the Content Types.
2. Use the Search field to search for specific modules.
3. To view the information about the module, click the module and its corresponding tabs to include Details, Repositories, Profiles, and Artifacts.

1. promote_or_remove_content_views
2. promote_or_remove_content_views_to_environment.

Procedure

1. In the Satellite web UI, navigate to Content > Content Views and select the Content View that you want to promote.
2. Select the version that you want to promote, click the vertical ellipsis icon, and click Promote.
3. Select the environment where you want to promote the Content View and click Promote.

Procedure

1. To promote a selected Content View version from Library across all life cycle environments within an organization, run the following Bash script:

   ORG="My_Organization"
   CVV_ID=3
   
   for i in $(hammer --no-headers --csv lifecycle-environment list --organization $ORG | awk -F, {'print $1'} | sort -n)
   do
      hammer content-view version promote --organization $ORG --to-lifecycle-environment-id $i --id $CVV_ID
   done

2. Display information about your Content View version to verify that it is promoted to the required lifecycle environments:

   # hammer content-view version info --id 3

Procedure

1. In the Satellite web UI, navigate to Content > Content Views and click Create content view.
2. In the Create content view window, enter a name for the view in the Name field. Red Hat Satellite automatically completes the Label field from the name you enter.
3. Optional: In the Description field, enter a description of the view.
4. On the Type tab, select Composite content view.
5. Optional: If you want to automatically publish a new version of the Composite Content View when a Content View is republished, select the Auto publish checkbox.
6. Click Create content view.
7. On the Content views tab, select the Content Views that you want to add to the Composite Content View, and then click Add content views.
8. In the Add content views window, select the version of each Content View.
9. Optional: If you want to automatically update the Content View to the latest version, select the Always update to latest version checkbox.
10. Click Add, then click Publish new version.
11. Optional: In the Description field, enter a description of the Content View.
12. In the Publish window, set the Promote switch, then select the lifecycle environment.
13. Click Next, then click Finish.

CLI procedure

1. Before you create the Composite Content Views, list the version IDs for your existing Content Views:

   # hammer content-view version list \
   --organization "My_Organization"

2. Create a new Composite Content View. When the --auto-publish option is set to yes, the Composite Content View is automatically republished when a Content View it includes is republished:

   # hammer content-view create \
   --composite \
   --auto-publish yes \
   --name "Example_Composite_Content_View" \
   --description "Example Composite Content View" \
   --organization "My_Organization"

3. Add a Content View to the Composite Content View. You can identify Content View, Content View version, and Organization in the commands by either their ID or their name. To add multiple Content Views to the Composite Content View, repeat this step for every Content View you want to include.

   • If you have the Always update to latest version option enabled for the Content View:

     # hammer content-view component add \
     --component-content-view-id Content_View_ID \
     --composite-content-view "Example_Composite_Content_View" \
     --latest \
     --organization "My_Organization"

   • If you have the Always update to latest version option disabled for the Content View:

     # hammer content-view component add \
     --component-content-view-id Content_View_ID \
     --composite-content-view "Example_Composite_Content_View" \
     --component-content-view-version-id Content_View_Version_ID \
     --organization "My_Organization"

4. Publish the Composite Content View:

   # hammer content-view publish \
   --name "Example_Composite_Content_View" \
   --description "Initial version of Composite Content View" \
   --organization "My_Organization"

5. Promote the Composite Content View across all environments:

   # hammer content-view version promote \
   --content-view "Example_Composite_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Development" \
   --organization "My_Organization"
   # hammer content-view version promote \
   --content-view "Example_Composite_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Testing" \
   --organization "My_Organization"
   # hammer content-view version promote \
   --content-view "Example_Composite_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Production" \
   --organization "My_Organization"

Procedure

1. In the Satellite web UI, navigate to Content > Content Views.
2. From the list of content views, select the required Content View.
3. On the Details tab, toggle Solve dependencies.

Procedure

1. In the Satellite web UI, navigate to Content > Content Views and select a Content View.
2. On the Filters tab, click Create filter.
3. Enter a name.
4. From the Content type list, select a content type.
5. From the Inclusion Type list, select either Include filter or Exclude filter.
6. Optional: In the Description field, enter a description for the filter.
7. Click Create filter to create your content filter.
8. Depending on what you enter for Content Type, add rules to create the filter that you want.
9. Select if you want the filter to Apply to subset of repositories or Apply to all repositories.
10. Click Publish New Version to publish the filtered repository.
11. Optional: In the Description field, enter a description of the changes.

12. Click Create filter to publish a new version of the Content View.

    You can promote this Content View across all environments.

CLI procedure

1. Add a filter to the Content View. Use the --inclusion false option to set the filter to an Exclude filter:

   # hammer content-view filter create \
   --name "Errata Filter" \
   --type erratum --content-view "Example_Content_View" \
   --description "My latest filter" \
   --inclusion false \
   --organization "My_Organization"

2. Add a rule to the filter:

   # hammer content-view filter rule create \
   --content-view "Example_Content_View" \
   --content-view-filter "Errata Filter" \
   --start-date "YYYY-MM-DD" \
   --types enhancement,bugfix \
   --date-type updated \
   --organization "My_Organization"

3. Publish the Content View:

   # hammer content-view publish \
   --name "Example_Content_View" \
   --description "Adding errata filter" \
   --organization "My_Organization"

4. Promote the view across all environments:

   # hammer content-view version promote \
   --content-view "Example_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Development" \
   --organization "My_Organization"
   # hammer content-view version promote \
   --content-view "Example_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Testing" \
   --organization "My_Organization"
   # hammer content-view version promote \
   --content-view "Example_Content_View" \
   --version 1 \
   --to-lifecycle-environment "Production" \
   --organization "My_Organization"

Procedure

1. In the Satellite web UI, navigate to Content > Content Views.
2. Select the Content View.
3. On the Versions tab, select the version you want to delete and click on the vertical ellipsis on the right side of the version line.
4. Click Delete to open the deletion wizard that shows any affected environments.
5. Optional: If there are any affected environments, reassign any hosts or activation keys before deletion.
6. Click Next and review the details of the action.
7. Click Delete.