Chapter 6. Customizing the Learning Paths in Red Hat Developer Hub

Procedure

1. Publish the JSON file containing your Learning Paths data to a web server, such as GitHub or Gitlab. You can find an example at https://raw.githubusercontent.com/redhat-developer/rhdh/release-1.6/packages/app/public/learning-paths/data.json.

2. Configure the Developer Hub proxy to access the Learning Paths data from the hosted JSON file, by adding the following to the app-config.yaml file:

   proxy:
     endpoints:
       '/developer-hub':
         target: <target>
         pathRewrite:
           '^/api/proxy/developer-hub/learning-paths': '<learning_path.json>'
         changeOrigin: true
         secure: true

   <target>

   Enter the hosted JSON file base URL, such as https://raw.githubusercontent.com.

   <learning_path.json>

   Enter the hosted JSON file path without the base URL, such as '/redhat-developer/rhdh/main/packages/app/public/learning-paths/data.json'

   Tip

   When also configuring the home page, due to the use of overlapping pathRewrites for both the learning-path and homepage quick access proxies, create the learning-paths configuration (^api/proxy/developer-hub/learning-paths) before you create the homepage configuration (^/api/proxy/developer-hub). For example:

   proxy:
     endpoints:
       '/developer-hub':
         target: https://raw.githubusercontent.com/
         pathRewrite:
           '^/api/proxy/developer-hub/learning-paths': '/redhat-developer/rhdh/main/packages/app/public/learning-paths/data.json'
           '^/api/proxy/developer-hub/tech-radar': '/redhat-developer/rhdh/main/packages/app/public/tech-radar/data-default.json'
           '^/api/proxy/developer-hub': '/redhat-developer/rhdh/main/packages/app/public/homepage/data.json'
         changeOrigin: true
         secure: true

Procedure

1. Deploy your Developer Hub customization service on the same OpenShift Container Platform cluster as your Developer Hub instance. You can find an example at red-hat-developer-hub-customization-provider, that provides the same data as default Developer Hub data. The customization service provides a Learning Paths data URL such as: http://<rhdh-customization-provider>/learning-paths.

2. Configure the Developer Hub proxy to use your dedicated service to provide the Learning Path data, add the following to the app-config.yaml file:

   proxy:
     endpoints:
       '/developer-hub/learning-paths':
         target: <learning_path_data_url>
         changeOrigin: true
         qsecure: true 

   1

   1

   Change to "false" in case of using self hosted cluster with a self-signed certificate

Prerequisites

1. You can log in to developers.redhat.com
2. Your platform engineer has granted you access to the Learning Paths plugin.

1. In your Red Hat Developer Hub navigation menu, click Learning Paths.

2. Select the tile for the course you would like to begin.

   Note

   This action redirects you to the main page of the course in the Red Hat Developers site.