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

...

Connecting IguanaX to a git repository enables:

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

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

  • Disaster Recovery: Quickly restore or spin up a new Iguana IguanaX instance with existing configurations as part of a Disaster Recovery procedure Deploy using pre-existing configurations from your repository.

  • Efficient Deployment: Deploy fully pre-configured Iguana IguanaX 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.

    Use the Git Push button to manually backup the instance

    across environments.

...

Expand
title1. Connected To: Git repository for the IguanaX instance

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.

Expand
title2. Push/Pull as: Define the Iguana User push/pull updates from the repository

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

Expand
title3. Auto Push Every: 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
title4. Reset Instance: Use a Git instance repository to pull in and overwrite Iguana instance configurations

Use Reset Instance to completely replace your current IguanaX instance configurations with those stored in the defined Git repository. When you reset the instance, IguanaX performs a git pull, pulling the repository's contents, which overwrites the current configurations.

This can be useful for disaster recovery or when setting up Iguana in a new environment.