Skip to main content

Global config

Overview

The Global Configuration Card empowers you to define a centralized JSON configuration object. This object is readily accessible by all applications running on your edge node, regardless of their origin (native, Docker container, or marketplace app). More importantly, updates to this configuration are applied instantaneously, eliminating the need to restart or rebuild your applications.

Here's what this means for you:

  • Simplified Configuration Management: Manage configuration settings for all your edge applications from a single, centralized location.
  • Dynamic Updates: Make configuration changes on the fly without interrupting your applications.
  • Improved Efficiency: Save time and resources by avoiding application restarts or rebuilds for configuration updates.

This article will delve deeper into how to utilize the Global Configuration Card to streamline your edge application development and deployment.

Global Config Card UI

The Global Config Card

The Global Config Card

Card Index:

  1. Collapse/Expand Card
  2. Hide Card
  3. Last update timestamp
  4. Load a saved configuration
  5. Save a configuration
  6. Upload a configuration using a JSON file
  7. Download the configuration in a JSON file
  8. Format JSON data with proper indentation and line feeds
  9. Compact JSON data, remove all whitespaces
  10. Repair JSON: fix quotes and escape characters, remove comments and JSONP notation, turn JavaScript Objects into JSON
  11. Undo last action in the JSON editor
  12. Redo action in the JSON editor
  13. Send JSON configuration to the edge node.

Add Global Configuration Card

Go to the top-right corner of your Panel and select the "Add Card" button.

Adding the global config card

Adding the global config card

Scroll down in the drop-down menu and click the "Global Config" Card.

Select the global config card

Select the global config card

Now, your Global Configuration Card will be visible in your Node Detail's view, right next to your other Cards.

tip

If you can’t select your Global Configuration Card from the drop down menu this is because your Card is already in your Barbara Panel.

Sending a global config to a node

To send a new global configuration to a node, just enter it in the editor area and press the "Send" button.

Adding a global config

Adding a global config

Error Handling and Validation

The Global Config Card ensures data integrity by providing clear error feedback. In the JSON editor, any errors within the entered configuration will be marked with a red cross icon. Simply hover over the icon for a detailed explanation of the issue. To prevent accidental configuration pushes, the "Send" button remains disabled until all errors are rectified.

Error adding a global config

Error adding a global config

Save a configuration

The Global Config Card allows you to save your configurations for easy access and future reference. Simply click the "Save" button to initiate the process. Following a successful save, you'll be prompted to enter a descriptive name for your configuration, ensuring clear organization and retrieval.

Saving a configuration

Saving a configuration

By default, a suggested name will be provided, but feel free to personalize it with a more descriptive name. Keep in mind that names must be unique and cannot conflict with existing saved configurations.

Load a configuration

Simply click the "Load" button to access your saved configurations. Within the expandable panel, choose the desired configuration you wish to apply, and then click the "Send" button to push the settings to your Edge Node.

Loading a configuration

Loading a configuration

Upload a configuration from a JSON file

The Global Config Card offers an alternative approach to configuration management by allowing you to import settings from a local JSON file. Simply click the "Upload" button and browse to select the desired JSON file.

Uploading a configuration from a JSON file

Uploading a configuration from a JSON file

Once the file contents are displayed in the editor, review them as needed and then click the "Send" button to push the configuration to your Edge Node.

Download a configuration from a JSON file

The Global Config Card allows you to export your configurations for further editing or backup purposes. Click the "Download" button and choose the destination folder on your device to save the configuration as a local JSON file. This file can then be opened with a JSON editor on your laptop for offline modifications.

Downloading a configuration to a JSON file

Downloading a configuration to a JSON file

Hide your Global Config Card

You can easily hide your Global Config Card, if you want to tidy-up your Panel, without losing any data. Select the “Hide” icon at the top, right of the Volumes Card.

Hide Global Config Card

Hide Global Config Card

Confirm your choice to hide your Card with the follow-up prompt.

Hide Global Config Card Modal

Hide Global Config Card Modal