Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Git Instance settings page allows you to integrate Git source control for the with your IguanaX instance. All Iguana configurations and settings will be are stored in a Git repository that you define.

This can be used to:

  • Easily track changes on the Iguana instance and view the Commit History

  • Regularly backup your Iguana instance

  • Quickly spin up a new Iguana instance with existing configurations as part of a Disaster Recovery procedure

  • Deploy pre-configured Iguana instances

...

Reset Instance: Use reset instance to replace all current IguanaX configurations with the configurations stored in a Git repository URL you provide. Iguana performs a Git pull to pull in an instance repository - this will overwrite existing configurations.

...

Push/Pull as: select a user with the correct permissions within your git service to push and pull to the configured Iguana git instance repository.

...

Auto Push Every: IguanaX will automatically make commits for certain actions (ie. a user deleted one or more components). You can also set an interval (in minutes) for Iguana to automatically backup to the Git repository via a Git push. Set to 0 to disable auto-backups.

Connected to: The Git URL of the repository storing the Iguana instance.

...

Connecting IguanaX to a Git repository enables:

  • Tracking Configuration Changes: View the Commit History to monitor changes across your IguanaX instance.

  • Automatic Backups: Regularly back up your instance to a Git repository for safe storage.

...

Expand
title1. Connect the IguanaX instance to a Git repository to store all configurations.

Connect IguanaX to a Git repository to store all instance configurations.

Image Added
  1. Configure the Git Instance: To add an instance repository, click Edit and either provide an existing repository URL or create a new repository in the Repository Management Screen.

  2. Manually Backup your Iguana: Use the git push button to manually perform a git push to push changes from the IguanaX instance to the Git repository. This is useful when you want to ensure immediate backup of the current state of your instance.

Any components or libraries not connected to a repository or configured as a plain folder will not be pushed to the Git Instance repository. If this occurs, a Push Warning will display to remind you that the following components were not backed up.

Image Added
Expand
title2. Configure Iguana to automatically backup the instance

IguanaX can automatically create Git commits when certain actions are taken (such as deleting components) to ensure regular snapshots of your instance’s configurations. You can set an interval in minutes for automatic Git pushes to back up changes. If set to 0, auto-backups are disabled.

Expand
title3. Define the Iguana User to perform the push/pull updates from the repository

Define the user with the appropriate permissions to push changes from the configured Git repository. This ensures that your IguanaX instance can securely interact with the repository.