Skip to content
This repository has been archived by the owner on Aug 25, 2021. It is now read-only.

Commit

Permalink
Add redirects for project rename
Browse files Browse the repository at this point in the history
Signed-off-by: John Strunk <[email protected]>
  • Loading branch information
JohnStrunk committed Aug 4, 2021
1 parent d7b436d commit 7f6981a
Show file tree
Hide file tree
Showing 26 changed files with 91 additions and 54 deletions.
66 changes: 13 additions & 53 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,63 +1,23 @@
# Scribe
# ~Scribe~ is now VolSync

Scribe asynchronously replicates Kubernetes persistent volumes between clusters
using either rsync or rclone depending on the number of destinations.

[![Documentation
Status](https://readthedocs.org/projects/scribe-replication/badge/?version=latest)](https://scribe-replication.readthedocs.io/en/latest/?badge=latest)
[![Go Report
Card](https://goreportcard.com/badge/github.com/backube/scribe)](https://goreportcard.com/report/github.com/backube/scribe)
[![codecov](https://codecov.io/gh/backube/scribe/branch/master/graph/badge.svg)](https://codecov.io/gh/backube/scribe)
![maturity](https://img.shields.io/static/v1?label=maturity&message=alpha&color=red)

![Documentation](https://github.com/backube/scribe/workflows/Documentation/badge.svg)
![operator](https://github.com/backube/scribe/workflows/operator/badge.svg)

## Getting started

### Try Scribe in Kind

For a convenient script to start a `kind cluster`, try this
[script to setup a kind cluster](hack/setup-kind-cluster.sh).
![Attention!](https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/Warning.svg/156px-Warning.svg.png)

### Try Scribe in a Kind, Kubernetes, or Openshift cluster
**The Scribe project has been renamed to
[VolSync](https://github.com/backube/volsync)!
As a part of the renaming process, this source repository and project
documentation have moved.**

Follow the steps in the [installation
instructions](https://scribe-replication.readthedocs.io/en/latest/installation/index.html).
Here are
[useful commands to configure cluster storage classes](https://scribe-replication.readthedocs.io/en/latest/installation/index.html#configure-default-csi-storage).
Come find us at:

## Scribe kubectl plugin
* Code: [https://github.com/backube/volsync](https://github.com/backube/volsync).
* Documentation: [https://volsync.readthedocs.io](https://volsync.readthedocs.io).

To try out Scribe with a command line interface `scribe`:
------

```bash
make cli
cp bin/kubectl-scribe /usr/local/bin/
```
------

**NOTE:** `scribe` tool is being actively developed. Options, flags,
and names are likely to be updated frequently. PRs and new issues are welcome!

Available commands:

```bash
kubectl scribe start-replication
kubectl scribe set-replication
kubectl scribe continue-replication
kubectl scribe remove-replication
```

* Try the current examples:
* [single cluster cross namespace example](./docs/usage/rsync/db-example-cli.md)
* [multiple cluster example](./docs/usage/rsync/multi-context-sync-cli.md)

## Helpful links

* [Scribe documentation](https://scribe-replication.readthedocs.io)
* [Changelog](CHANGELOG.md)
* [Contributing guidelines](https://github.com/backube/.github/blob/master/CONTRIBUTING.md)
* [Organization code of conduct](https://github.com/backube/.github/blob/master/CODE_OF_CONDUCT.md)
Scribe asynchronously replicates Kubernetes persistent volumes between clusters
using rsync, rclone, or restic.

## Licensing

Expand Down
2 changes: 2 additions & 0 deletions docs/design/a-case-for.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
A case for Scribe
=================

.. include:: ../renamed.rst

.. contents::
:depth: 2

Expand Down
2 changes: 2 additions & 0 deletions docs/design/custom-resources.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Configuration and CRDs
======================

.. include:: ../renamed.rst

This document covers the rationale for how Scribe is configured and the
structure of the CustomResourceDefinitions.

Expand Down
2 changes: 2 additions & 0 deletions docs/design/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Enhancement proposals
=====================

.. include:: ../renamed.rst

.. toctree::
:titlesonly:

Expand Down
2 changes: 2 additions & 0 deletions docs/design/mover-rsync.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rsync-based data mover
======================

.. include:: ../renamed.rst

This document covers the design of the rsync-based data mover.

.. contents::
Expand Down
2 changes: 2 additions & 0 deletions docs/design/restic.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Restic-based data mover
=======================

.. include:: ../renamed.rst

.. admonition:: Enhancement status

Status: Proposed
Expand Down
2 changes: 2 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ Overview
usage/index
design/index

.. include:: ./renamed.rst

*Asynchronous volume replication for Kubernetes CSI storage*

Scribe is a Kubernetes operator that performs asynchronous replication of
Expand Down
2 changes: 2 additions & 0 deletions docs/installation/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Installation
============

.. include:: ../renamed.rst

The following directions will walk through the process of deploying Scribe.

.. note::
Expand Down
8 changes: 8 additions & 0 deletions docs/renamed.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
.. attention:: **Scribe has been renamed to VolSync!**

The Scribe project has been renamed to **VolSync**, and it has a new home.
Come join us at our new location:

- Documentation: https://volsync.readthedocs.io
- Source: https://github.com/backube/volsync
- Artifact Hub: https://artifacthub.io/packages/helm/backube-helm-charts/volsync
2 changes: 2 additions & 0 deletions docs/usage/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Usage
=====

.. include:: ../renamed.rst

.. toctree::
:hidden:

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/metrics/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Metrics & monitoring
====================

.. include:: ../../renamed.rst

In order to support monitoring of replication relationships, Scribe exports a
number of metrics that can be scraped with Prometheus. These metrics permit
monitoring whether volumes are "in sync" and how long the synchronization
Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rclone/database_example.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rclone Database Example
=======================

.. include:: ../../renamed.rst

The following example will use the Rclone replication method and take a Snapshot
at the source. A MySQL database will be used as the example application.

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rclone/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rclone-based replication
========================

.. include:: ../../renamed.rst

.. toctree::
:hidden:

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rclone/rclone-secret.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Understanding ``rclone-secret``
===============================

.. include:: ../../renamed.rst

What is ``rclone-secret``?
==========================

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/restic/database_example.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Restic Database Example
=======================

.. include:: ../../renamed.rst

Restic backup
=============

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/restic/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Restic-based backup
===================

.. include:: ../../renamed.rst

.. toctree::
:hidden:

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/database_example.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rsync Database Example
======================

.. include:: ../../renamed.rst

The following example will use the Rsync replication method and take a Snapshot
at the destination. A MySQL database will be used as the example application.

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/db_example_cli.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rsync Database Plugin Example
=============================

.. include:: ../../renamed.rst

This example will sync data from mysql database persistent volumes
For this example, sync will happen within a single cluster and 2 namespaces.

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/external_rsync.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
==============
External Rsync
==============
.. include:: ../../renamed.rst

A situation may occur where data needs to be imported into a Kubernetes environment.
In the Scribe repository, the script `bin/external-rsync-source` can be executed
which will serve as the `replicationsource` allowing data to be replicated to a
Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rsync-based replication
=======================

.. include:: ../../renamed.rst

.. toctree::
:hidden:

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/multi_context_sync_cli.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Rsync Database Cross-Cluster Plugin Example
===========================================

.. include:: ../../renamed.rst

This example will sync data from mysql database persistent volumes
For this example, sync will happen between 2 clusters. Data will be synced
from cluster-name :code:`api-source-com:6443` to cluster-name :code:`destination123`
Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/plugin_opts.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@
Scribe Plugin Options with Defaults
====================================

.. include:: ../../renamed.rst

These may be passed as :code:`key: value` pairs in a file, on the command-line, or a combination of both.
Command-line values override the config file values.

Expand Down
2 changes: 2 additions & 0 deletions docs/usage/rsync/ssh_keys.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
SSH keys
========

.. include:: ../../renamed.rst

Scribe generates SSH keys upon the deployment of a ReplicationDestination object
but SSH keys can also be provided to Scribe rather than generating new ones. The
steps below will describe the process to provide Scribe SSH keys.
Expand Down
2 changes: 2 additions & 0 deletions docs/usage/triggers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Triggers
========

.. include:: ../renamed.rst

There are three types of triggers in scribe:

1. Always - no trigger, always run.
Expand Down
23 changes: 22 additions & 1 deletion helm/scribe/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,25 @@
# Scribe
# ~Scribe~ is now VolSync

![Attention!](https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/Warning.svg/156px-Warning.svg.png)

**The Scribe project has been renamed to
[VolSync](https://github.com/backube/volsync)!
As a part of that process, some things have moved, including this Helm chart.**

Please install the [VolSync
chart](https://artifacthub.io/packages/helm/backube-helm-charts/volsync) instead
of this one.

Please update your links:

- Source:
[https://github.com/backube/volsync](https://github.com/backube/volsync).
- Documentation:
[https://volsync.readthedocs.io](https://volsync.readthedocs.io)
- Helm chart:
[https://artifacthub.io/packages/helm/backube-helm-charts/volsync](https://artifacthub.io/packages/helm/backube-helm-charts/volsync)

------

Asynchronous volume replication for Kubernetes CSI storage

Expand Down
4 changes: 4 additions & 0 deletions helm/scribe/templates/NOTES.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,7 @@ The Scribe operator has been installed into the {{ .Release.Namespace }}
namespace.

Please see https://scribe-replication.readthedocs.org for documentation.

IMPORTANT: Scribe has been renamed to VolSync, and this chart is no longer
maintained. Please install the VolSync chart instead.
https://artifacthub.io/packages/helm/backube-helm-charts/volsync

0 comments on commit 7f6981a

Please sign in to comment.