Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -29,4 +29,7 @@ builds/

# Config files
*.lagoon-sync
*.lagoon-sync-defaults
*.lagoon-sync-defaults

# Docs
site/
Empty file added docs/commands/sync.md
Empty file.
3 changes: 3 additions & 0 deletions docs/config.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Introduction

## Configuration file
22 changes: 22 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Lagoon-sync

Lagoon-sync is cli tool written in Go that fundamentally provides the functionality to synchronise data between Lagoon environments. Lagoon-sync is part of the [Lagoon cli](https://github.com/amazeeio/lagoon-cli) toolset and works closely with its parent project.

Lagoon-sync offers:

* Sync commands for databases such as `mariadb`, `postgres` and `mongodb`
* Php/node-based framework support such as Drupal, Laravel or Node.js
* Standard file transfer support with `files` syncer
* Has built-in default configuration values for syncing out-the-box
* Provides an easy way to override sync configuration via `.lagoon.yml` or `.lagoon-sync.yml` files
* Offers `--dry-run` flag to see what commands would be executed before running a transfer
* `--no-interaction` can be used to auto-run all processes without prompt - useful for CI/builds
* `config` command shows the configuration of the current environment
* There is a `--show-debug` flag to output more verbose logging for debugging
* Lagoon-sync uses `rsync` for the transfer of data, and will automatically detect and install `rsync` if it is not available on target environments
* Secure cross-platform self-updating with `selfUpdate` command


## Commands

* `lagoon-sync sync [mariadb|files|mongodb|postgres] [flags]` - Sync resources between remote and local environments.
32 changes: 32 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
site_name: lagoon-sync
site_url: https://uselagoon.github.io/lagoon-sync/
repo_url: https://github.com/uselagoon/lagoon-sync/
repo_name: uselagoon/lagoon-sync

theme:
name: 'material'
palette:
primary: 'blue'
accent: 'light blue'
favicon: lagoon-sync-logo.png
icon:
logo: fontawesome/solid/terminal
repo: fontawesome/brands/github

markdown_extensions:
- toc:
permalink: "#"
baselevel: 2
- admonition
- attr_list
- tables
- pymdownx.highlight
- pymdownx.superfences

plugins:
- search

nav:
- Getting Started: index.md
- Configuration: config.md
- Commands: commands/sync.md