summaryrefslogtreecommitdiffstats
path: root/roles/etcd_migrate/README.md
diff options
context:
space:
mode:
authorJan Chaloupka <jchaloup@redhat.com>2017-09-19 15:14:18 +0200
committerJan Chaloupka <jchaloup@redhat.com>2017-09-22 10:12:20 +0200
commitf8664e17ef5e6bead61d8471facd2859fd10c180 (patch)
tree478c21fd924ce9d6abf410b57257c004637aa31a /roles/etcd_migrate/README.md
parent2d0501b63ff07b177b3fb5b1c6663ed369656240 (diff)
downloadopenshift-f8664e17ef5e6bead61d8471facd2859fd10c180.tar.gz
openshift-f8664e17ef5e6bead61d8471facd2859fd10c180.tar.bz2
openshift-f8664e17ef5e6bead61d8471facd2859fd10c180.tar.xz
openshift-f8664e17ef5e6bead61d8471facd2859fd10c180.zip
consolidate etcd_migrate role
Diffstat (limited to 'roles/etcd_migrate/README.md')
-rw-r--r--roles/etcd_migrate/README.md53
1 files changed, 0 insertions, 53 deletions
diff --git a/roles/etcd_migrate/README.md b/roles/etcd_migrate/README.md
deleted file mode 100644
index 369e78ff2..000000000
--- a/roles/etcd_migrate/README.md
+++ /dev/null
@@ -1,53 +0,0 @@
-Role Name
-=========
-
-Offline etcd migration of data from v2 to v3
-
-Requirements
-------------
-
-It is expected all consumers of the etcd data are not accessing the data.
-Otherwise the migrated data can be out-of-sync with the v2 and can result in unhealthy etcd cluster.
-
-The role itself is responsible for:
-- checking etcd cluster health and raft status before the migration
-- checking of presence of any v3 data (in that case the migration is stopped)
-- migration of v2 data to v3 data (including attaching leases of keys prefixed with "/kubernetes.io/events" and "/kubernetes.io/masterleases" string)
-- validation of migrated data (all v2 keys and in v3 keys and are set to the identical value)
-
-The migration itself requires an etcd member to be down in the process. Once the migration is done, the etcd member is started.
-
-Role Variables
---------------
-
-TBD
-
-Dependencies
-------------
-
-- etcd_common
-- lib_utils
-
-Example Playbook
-----------------
-
-```yaml
-- name: Migrate etcd data from v2 to v3
- hosts: oo_etcd_to_config
- gather_facts: no
- tasks:
- - include_role:
- name: openshift_etcd_migrate
- vars:
- etcd_peer: "{{ ansible_default_ipv4.address }}"
-```
-
-License
--------
-
-Apache License, Version 2.0
-
-Author Information
-------------------
-
-Jan Chaloupka (jchaloup@redhat.com)