[GitHub] [trafficcontrol] rawlinp opened a new issue #6670: Add missing TR profile parameters and correct interval units in snapshot docs

[GitBox <gi...@apache.org>]

rawlinp opened a new issue #6670:
URL: https://github.com/apache/trafficcontrol/issues/6670


   <!--
   ************ STOP!! ************
   If this issue identifies a security vulnerability, DO NOT submit it! Instead, contact
   the Apache Traffic Control Security Team at security@trafficcontrol.apache.org and follow the
   guidelines at https://apache.org/security regarding vulnerability disclosure.
   
   - For *SUPPORT QUESTIONS*, use the #traffic-control channel on the ASF slack (https://s.apache.org/tc-slack-request)
   or the Traffic Control Users mailing list (send an email to users-subscribe@trafficcontrol.apache.org to subscribe).
   - Before submitting, please **SEARCH GITHUB** for a similar issue or PR
       * https://github.com/apache/trafficcontrol/issues
       * https://github.com/apache/trafficcontrol/pulls
   -->
   
   <!-- Do not submit security vulnerabilities or support requests here - see above -->
   ## This Improvement request (usability, performance, tech debt, etc.) affects these Traffic Control components:
   <!-- delete all those that don't apply -->
   - Traffic Router
   - Documentation
   
   ## Current behavior:
   <!-- Describe how the current features are insufficient. -->
   https://traffic-control-cdn.readthedocs.io/en/latest/admin/traffic_router.html#the-traffic-router-profile is currently missing a few parameters:
   - certificates.polling.interval (the interval, in milliseconds, on which TR will check for SSL certificates)
   - certificate.polling.url (yes, it's non-plural. The URL TR will use to get delivery service SSL certificates)
   - regional_geoblock.polling.interval (the interval, in milliseconds, on which TR will GET the RGB config file)
   - regional_geoblock.polling.url (the URL TR will use to get the RGB config file)
   - anonymousip.policy.configuration (The URL of the Anonymous Blocking configuration file. Traffic Router will fetch the file from this URL.)
   - anonymousip.polling.url (The URL of the Anonymous IP Database. Traffic Router will fetch the file from this URL.)
   - anonymousip.polling.interval (The interval, in milliseconds) that Traffic Router polls the Anonymous Blocking configuration file and Anonymous IP Database.)
   
   Also, https://traffic-control-cdn.readthedocs.io/en/latest/api/v4/cdns_name_snapshot.html and https://traffic-control-cdn.readthedocs.io/en/latest/api/v4/cdns_name_snapshot_new.html mistakenly state that some intervals are in seconds, when they are actually in _milliseconds_:
   - certificates.polling.interval
   - coveragezone.polling.interval
   - federationmapping.polling.interval
   - geolocation.polling.interval
   - steeringmapping.polling.interval
   
   ## New behavior:
   <!-- Describe how this change would improve Traffic Control -->
   The aforementioned documentation issues should be fixed.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@trafficcontrol.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org