nuu:bit provides an easy way to manage the configuration of a provisioned domain by placing the domain's JSON configuration object (in nuu:bit's DSL format) in a file hosted by popular service GitHub.
You are welcome to use the following process to activate the integration.
1. Add a new domain in nuu:bit's customer portal (you can also use the process on already existing domain configuration).
2. Using "Advanced" domain configuration mode get the current snapshot of the domain's configuration in JSON file.
3. Place the JSON object in a file hosted in a private GitHub repository.
4. In GitHub's UI when you view the file get a link to the file's "raw" version. The link may look like the following:
5. On GitHub's personal access tokens page (https://github.com/settings/tokens) register a new token to be used to access the domain configuration JSON file (you can also use an existing token). The token may look like the following:
6. In nuu:bit's customer portal UI, in domain's edit window click on GitHub Integration switch, and in the appeared GitHub Integration Settings form provide the two previously discussed parameters:
- GitHub URL pointing to the domain configuration file's "raw" version
- GitHub personal access token
Click on Verify button and wait till the system will try to use the provided parameters to pull the configuration file from GitHub and verify it.
7. Click on Update or Publish button to stage or activate the new configuration.
Please note that after activating the GitGHub Integration feature you still will be able to see the currently active domain configuration via the admin UI but you will not able to change there any domain configuration parameters (changes should be done in the GitHub-hosted JSON configuration file).