Uploaded image for project: 'OpenShift Bugs'
  1. OpenShift Bugs
  2. OCPBUGS-23115

Doc for Builds with Red Hat Subscriptions Missing Steps


    • Icon: Bug Bug
    • Resolution: Done
    • Icon: Critical Critical
    • 4.16.0
    • 4.12
    • Documentation / Build
    • None
    • Low
    • No
    • 8
    • devex docs #252 Jan 23-Feb 12, devex docs #253 Feb 12-Mar 4
    • 2
    • False
    • Hide


    • Documentation for building container images that install RHEL packages was corrected to fix missing Dockerfile steps, and add instructions on how to copy the cluster's entitlement secret to the user's namespace.
    • Customer Escalated, Customer Facing

      Description of problem:

      Documentation for using Red Hat subscriptions in builds is missing a few important steps, especially for customers that have not turned on the tech preview feature for the Shared Resource CSI driver.
      These are the following:
      1. Customer needs Simple Content Access import enabled in the Insights Operator: https://docs.openshift.com/container-platform/4.12/support/remote_health_monitoring/insights-operator-simple-access.html
      2. Customer needs to copy the secret data from openshift-config-managed/etc-pki-entitlement to the workspace the build is running in. We should provide oc commands that a cluster admin/platform team can execute.
      For builds that are running in a network-restricted environment and access RHEL content through Satellite, the documentation must also provide instructions on how to obtain an `rhsm.conf` file for the Satellite instance and mount it into the build container.

      Version-Release number of selected component (if applicable):


      How reproducible:


      Steps to Reproduce:

      Read the documentation for https://docs.openshift.com/container-platform/4.12/cicd/builds/running-entitled-builds.html#builds-create-imagestreamtag_running-entitled-builds and execute the commands as is.

      Actual results:

      Build probably won't run because the required secret is not created.

      Expected results:

      Customers should be able to run a build that requires RHEL entitlements following the exact steps as described in the doc.

      Additional info:


            joaedwar@redhat.com Joan Edwards
            rh-ee-sabiswas Sayan Biswas
            Sayan Biswas Sayan Biswas
            0 Vote for this issue
            14 Start watching this issue