XL Repo Linker

The tool to import and export snapshots of XLD data and configurations.

When do you need to use it?

You have to save your environment configuration at some point and after some time rollback to that checkpoint

You have to share your environment with somebody else

You found a bug and you can provide your current snapshot to easily reproduce it

How to install it?

Install Node JS

npm install -g

xl-repo-linker

If you want to use UI version:

Install chrome extension

NPM Module

Chrome Extension

How to configure it?

1. Run "xl-repo-linker -h"

2. Open ~/.xl-repo-linker-config.yml file and fill in all emtpy fields

When you first time run xl-repo-linker it will generate in your user home .xl-repo-linker-config.yml file

If you forget to fill in some fields and you try to import/export snapshot you will see appropriate exception regarding it

xl-repo-linker -h

  Usage: xl-repo-linker [options]

  Options:

    -h, --help                  output usage information
    -s, --server                Run server for Chrome Extension
    -i, --import <n>            Imports the data as xld snapshot for specified JIRA issue
    -r, --import-restart <n>    Imports and restarts the xld server after import
    -e, --export <n>            Exports xld snapshot by specified JIRA issue
    -o, --export-overwrite <n>  Exports xld snapshot and if necessary overwrites already exported archive
    --xld-home <n>              Override XLD home specified in the configuration file
    --mode <n>                  Override the mode specified in the configuration file

.xl-repo-linker-config.yml

common:
    mode:                   local
    show_download_progress: true
jira:
    host:          https://xebialabs.atlassian.net
    api_path:      /rest/api/2
    login:         # Please add here your Jira user login
    password:      # Please add here your Jira user password
    encrypted:     false
xld:
    host:          http://localhost:4516
    home:          # Please add here your XLD home path
    login:         # Please add here your XLD admin user login
    license:       # Please add here your XLD license path
    password:      # Please add here your XLD admin user password
    encrypted:     false
googleDrive:
    enabled:       false
    clientId:      219982597230-jt1mmsc4ajjmv583i4qkfqj6cql1hn5i.apps.googleusercontent.com
    clientSecret:  # Please add here your Google Drive Client Secret
mongo:
  apiKey:          # Please add here your Mongo API Key
snapshot:          # Specify which folders/files will be included into a snapshot
  conf:            "**/*.*,!deployit-license.lic"
  ext:             "**/*.*"
  repository: "    **/*.*"

XL Repo Linker modes

Local

JIRA

Google Drive

Local mode

The local repository in ~/.xld-repo will be created and you can save all your snapshots locally.

It is perfectly suits the needs when you don't need to share your snapshots with nobody else, but just recover your previous
state.

XLD server

Local .xld-repo

Export

Import

JIRA mode

when you have to attach your snapshot to Jira issue and share your snapshot with a person who has an access to Jira as well

JIRA

XLD

xl-repo-linker

Google Drive mode

when your snapshot is big and you don't want to make Jira slow, or both parties doesn't have access to Jira then this way becomes better to share

Google

Drive

XLD

xl-repo-linker