Document URL: https://access.redhat.com/documentation/en/openshift-enterprise/version-3.1/installation-and-configuration/#metrics-deployer-secrets Section Number and Name: 16.5.1. Metrics Deployer Secrets Describe the issue: There is a mention of providing customer certs but there isn't any mention of what of certs are valid. What should be the CNAME for this certificates. Suggestions for improvement: Please mention how can we configure custom certs for enabling metrics. What all things should be taken care. Also, how can we update the url used by Heapster to connect to Hawkular Metrics. Additional information: http://post-office.corp.redhat.com/archives/openshift-sme/2015-December/msg00336.html
I believe this would be best if we outline better that we structure the docs in a fashion that recommends deploying metrics using internal certs and then using re-encrypting route to provide your own certs. Then we add this step at the bottom showing how to provide your custom certs to a secret and then redeploying the metrics template. Providing Your Own Certificates https://docs.openshift.com/enterprise/latest/install_config/cluster_metrics.html#metrics-using-secrets-byo-certs In the 3.1+ docs we say what names the certs should have. At least 2 names need to be in the cert: hawkular-metrics HAWKULAR_METRICS_HOSTNAME
Work in progress: https://github.com/openshift/openshift-docs/pull/2598
Will verify it while above PR is merged.
Commits pushed to master at https://github.com/openshift/openshift-docs https://github.com/openshift/openshift-docs/commit/5694831957caa8a8c771b00b9cf8f2b397294445 Bug 1289441, added clarifying details within Providing Your Own Certificates https://github.com/openshift/openshift-docs/commit/3ddce7478c2152e886768083cff20413d179e8ac Merge pull request #2598 from ahardin-rh/metrics-deployer-secrets Bug 1289441, added clarifying details in Providing Your Own Certificates
Content is now published: https://access.redhat.com/documentation/en/openshift-enterprise/3.2/single/installation-and-configuration/#metrics-using-secrets-byo-certs