1. Pod 定義のバックアップを作成します。ここに置かれます。

2. マスターホストの設定ファイルのバックアップを作成します。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo mkdir -p ${MYBACKUPDIR}/etc/sysconfig
   $ sudo cp -aR /etc/origin ${MYBACKUPDIR}/etc
   $ sudo cp -aR /etc/sysconfig/ ${MYBACKUPDIR}/etc/sysconfig/

   注記

   マスター設定ファイルは /etc/origin/master/master-config.yaml です。

   警告

   /etc/origin/master/ca.serial.txt ファイルは Ansible ホストインベントリーに一覧表示される最初のマスターでのみ生成されます。最初のマスターホストの使用を終了する場合は、このプロセスの実行前に /etc/origin/master/ca.serial.txt ファイルを残りのマスターホストにコピーします。

   重要

   複数のマスターを実行する OpenShift Container Platform 3.11 クラスターでは、マスターノードの 1 つの /etc/origin/master、/etc/etcd/ca および /etc/etcd/generated_certs に追加の CA 証明書が含まれます。これらはアプリケーションノードおよび etcd ノードのスケールアップ操作に必要であり、元のマスターが永続的に利用不可になる場合に別のマスターで復元される必要があります。これらのディレクトリーは、ここで説明されているバックアップ手順にデフォルトで含まれています。

3. バックアップの計画時に考慮する必要のある他の重要なファイルには以下が含まれます。

   ファイル	説明
   /etc/cni/*	コンテナーネットワークインターフェースの設定 (使用される場合)
   /etc/sysconfig/iptables	iptables ルールが保存される場所
   /etc/sysconfig/docker-storage-setup	container-storage-setup コマンドの入力ファイル
   /etc/sysconfig/docker	docker 設定ファイル
   /etc/sysconfig/docker-network	docker ネットワーク設定 (例: MTU)
   /etc/sysconfig/docker-storage	docker ストレージ設定 (container-storage-setup で生成される)
   /etc/dnsmasq.conf	dnsmasq の主要な設定ファイル
   /etc/dnsmasq.d/*	異なる dnsmasq 設定ファイル
   /etc/sysconfig/flanneld	flannel 設定ファイル (使用される場合)
   /etc/pki/ca-trust/source/anchors/	システムに追加される証明書 (例: 外部レジストリー用)

   上記のファイルのバックアップを作成します。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo mkdir -p ${MYBACKUPDIR}/etc/sysconfig
   $ sudo mkdir -p ${MYBACKUPDIR}/etc/pki/ca-trust/source/anchors
   $ sudo cp -aR /etc/sysconfig/{iptables,docker-*,flanneld} \
       ${MYBACKUPDIR}/etc/sysconfig/
   $ sudo cp -aR /etc/dnsmasq* /etc/cni ${MYBACKUPDIR}/etc/
   $ sudo cp -aR /etc/pki/ca-trust/source/anchors/* \
       ${MYBACKUPDIR}/etc/pki/ca-trust/source/anchors/

4. パッケージが間違って削除されてしまう場合や、rpm パッケージに含まれるファイルを復元する必要がある場合に、システムにインストールされている rhel パッケージの一覧があると便利です。

   注記

   コンテンツビューやファクトストアなどの Red Hat Satellite 機能を使用する場合は、見つからないパッケージやシステムにインストールされているパッケージの履歴データを再インストールする適切なメカニズムを指定します。

   システムにインストールされている現在の rhel パッケージの一覧を作成するには、以下を実行します。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo mkdir -p ${MYBACKUPDIR}
   $ rpm -qa | sort | sudo tee $MYBACKUPDIR/packages.txt

5. これまでの手順を実行している場合、以下のファイルがバックアップディレクトリーに置かれます。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo find ${MYBACKUPDIR} -mindepth 1 -type f -printf '%P\n'
   etc/sysconfig/flanneld
   etc/sysconfig/iptables
   etc/sysconfig/docker-network
   etc/sysconfig/docker-storage
   etc/sysconfig/docker-storage-setup
   etc/sysconfig/docker-storage-setup.rpmnew
   etc/origin/master/ca.crt
   etc/origin/master/ca.key
   etc/origin/master/ca.serial.txt
   etc/origin/master/ca-bundle.crt
   etc/origin/master/master.proxy-client.crt
   etc/origin/master/master.proxy-client.key
   etc/origin/master/service-signer.crt
   etc/origin/master/service-signer.key
   etc/origin/master/serviceaccounts.private.key
   etc/origin/master/serviceaccounts.public.key
   etc/origin/master/openshift-master.crt
   etc/origin/master/openshift-master.key
   etc/origin/master/openshift-master.kubeconfig
   etc/origin/master/master.server.crt
   etc/origin/master/master.server.key
   etc/origin/master/master.kubelet-client.crt
   etc/origin/master/master.kubelet-client.key
   etc/origin/master/admin.crt
   etc/origin/master/admin.key
   etc/origin/master/admin.kubeconfig
   etc/origin/master/etcd.server.crt
   etc/origin/master/etcd.server.key
   etc/origin/master/master.etcd-client.key
   etc/origin/master/master.etcd-client.csr
   etc/origin/master/master.etcd-client.crt
   etc/origin/master/master.etcd-ca.crt
   etc/origin/master/policy.json
   etc/origin/master/scheduler.json
   etc/origin/master/htpasswd
   etc/origin/master/session-secrets.yaml
   etc/origin/master/openshift-router.crt
   etc/origin/master/openshift-router.key
   etc/origin/master/registry.crt
   etc/origin/master/registry.key
   etc/origin/master/master-config.yaml
   etc/origin/generated-configs/master-master-1.example.com/master.server.crt
   ...[OUTPUT OMITTED]...
   etc/origin/cloudprovider/openstack.conf
   etc/origin/node/system:node:master-0.example.com.crt
   etc/origin/node/system:node:master-0.example.com.key
   etc/origin/node/ca.crt
   etc/origin/node/system:node:master-0.example.com.kubeconfig
   etc/origin/node/server.crt
   etc/origin/node/server.key
   etc/origin/node/node-dnsmasq.conf
   etc/origin/node/resolv.conf
   etc/origin/node/node-config.yaml
   etc/origin/node/flannel.etcd-client.key
   etc/origin/node/flannel.etcd-client.csr
   etc/origin/node/flannel.etcd-client.crt
   etc/origin/node/flannel.etcd-ca.crt
   etc/pki/ca-trust/source/anchors/openshift-ca.crt
   etc/pki/ca-trust/source/anchors/registry-ca.crt
   etc/dnsmasq.conf
   etc/dnsmasq.d/origin-dns.conf
   etc/dnsmasq.d/origin-upstream-dns.conf
   etc/dnsmasq.d/node-dnsmasq.conf
   packages.txt

   必要な場合は、ファイルを圧縮してスペースを節約することができます。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo tar -zcvf /backup/$(hostname)-$(date +%Y%m%d).tar.gz $MYBACKUPDIR
   $ sudo rm -Rf ${MYBACKUPDIR}

1. ノード設定ファイルのバックアップを作成します。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo mkdir -p ${MYBACKUPDIR}/etc/sysconfig
   $ sudo cp -aR /etc/origin ${MYBACKUPDIR}/etc
   $ sudo cp -aR /etc/sysconfig/atomic-openshift-node ${MYBACKUPDIR}/etc/sysconfig/

2. OpenShift Container Platform は、バックアップポリシーの計画時に考慮する必要のある特定のファイルを使用します。これには以下が含まれます。

   ファイル	説明
   /etc/cni/*	コンテナーネットワークインターフェースの設定 (使用される場合)
   /etc/sysconfig/iptables	iptables ルールが保存される場所
   /etc/sysconfig/docker-storage-setup	container-storage-setup コマンドの入力ファイル
   /etc/sysconfig/docker	docker 設定ファイル
   /etc/sysconfig/docker-network	docker ネットワーク設定 (例: MTU)
   /etc/sysconfig/docker-storage	docker ストレージ設定 (container-storage-setup で生成される)
   /etc/dnsmasq.conf	dnsmasq の主要な設定ファイル
   /etc/dnsmasq.d/*	異なる dnsmasq 設定ファイル
   /etc/sysconfig/flanneld	flannel 設定ファイル (使用される場合)
   /etc/pki/ca-trust/source/anchors/	システムに追加される証明書 (例: 外部レジストリー用)

   これらのファイルを作成するには、以下を実行します。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo mkdir -p ${MYBACKUPDIR}/etc/sysconfig
   $ sudo mkdir -p ${MYBACKUPDIR}/etc/pki/ca-trust/source/anchors
   $ sudo cp -aR /etc/sysconfig/{iptables,docker-*,flanneld} \
       ${MYBACKUPDIR}/etc/sysconfig/
   $ sudo cp -aR /etc/dnsmasq* /etc/cni ${MYBACKUPDIR}/etc/
   $ sudo cp -aR /etc/pki/ca-trust/source/anchors/* \
       ${MYBACKUPDIR}/etc/pki/ca-trust/source/anchors/

3. パッケージが間違って削除されてしまう場合や、rpm パッケージに含まれるファイルを復元する必要がある場合に、システムにインストールされている rhel パッケージの一覧があると便利です。

   注記

   コンテンツビューやファクトストアなどの Red Hat Satellite 機能を使用する場合は、見つからないパッケージやシステムにインストールされているパッケージの履歴データを再インストールする適切なメカニズムを指定します。

   システムにインストールされている現在の rhel パッケージの一覧を作成するには、以下を実行します。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo mkdir -p ${MYBACKUPDIR}
   $ rpm -qa | sort | sudo tee $MYBACKUPDIR/packages.txt

4. 以下のファイルがバックアップディレクトリーに置かれます。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo find ${MYBACKUPDIR} -mindepth 1 -type f -printf '%P\n'
   etc/sysconfig/atomic-openshift-node
   etc/sysconfig/flanneld
   etc/sysconfig/iptables
   etc/sysconfig/docker-network
   etc/sysconfig/docker-storage
   etc/sysconfig/docker-storage-setup
   etc/sysconfig/docker-storage-setup.rpmnew
   etc/origin/node/system:node:app-node-0.example.com.crt
   etc/origin/node/system:node:app-node-0.example.com.key
   etc/origin/node/ca.crt
   etc/origin/node/system:node:app-node-0.example.com.kubeconfig
   etc/origin/node/server.crt
   etc/origin/node/server.key
   etc/origin/node/node-dnsmasq.conf
   etc/origin/node/resolv.conf
   etc/origin/node/node-config.yaml
   etc/origin/node/flannel.etcd-client.key
   etc/origin/node/flannel.etcd-client.csr
   etc/origin/node/flannel.etcd-client.crt
   etc/origin/node/flannel.etcd-ca.crt
   etc/origin/cloudprovider/openstack.conf
   etc/pki/ca-trust/source/anchors/openshift-ca.crt
   etc/pki/ca-trust/source/anchors/registry-ca.crt
   etc/dnsmasq.conf
   etc/dnsmasq.d/origin-dns.conf
   etc/dnsmasq.d/origin-upstream-dns.conf
   etc/dnsmasq.d/node-dnsmasq.conf
   packages.txt

   必要な場合は、ファイルを圧縮してスペースを節約することができます。

   $ MYBACKUPDIR=/backup/$(hostname)/$(date +%Y%m%d)
   $ sudo tar -zcvf /backup/$(hostname)-$(date +%Y%m%d).tar.gz $MYBACKUPDIR
   $ sudo rm -Rf ${MYBACKUPDIR}

1. レジストリー証明書をバックアップします。

   # cd /etc/docker/certs.d/
   # tar cf /tmp/docker-registry-certs-$(hostname).tar *

2. バックアップを外部の場所に移動します。

1. 復元手順には完全な再インストールが必要になるため、初期インストールで使用されたすべてのファイルを保存します。これらのファイルには、以下が含まれる場合があります。

   • Ansible Playbook およびインベントリーファイル (クラスターインストールの場合)
   • /etc/yum.repos.d/ose.repo (非接続インストール方法の場合)
2. インストール後のステップの手順をバックアップします。一部のインストールには、インストーラーに含まれないステップが必要になる場合があります。これには、OpenShift Container Platform の制御範囲外のサービスの変更やモニターエージェントなどの追加サービスのインストールが含まれる場合があります。複数の認証プロバイダーの使用など、通常インストーラー (Advanced Installer) でサポートされていない追加の設定も必要になる場合があります。

Jenkins デプロイメントのアプリケーションデータのバックアップ例

1. アプリケーションデータ mountPath を deploymentconfig から取得します。

   $ oc get dc/jenkins -o jsonpath='{ .spec.template.spec.containers[?(@.name=="jenkins")].volumeMounts[?(@.name=="jenkins-data")].mountPath }'
   /var/lib/jenkins

2. 現在実行中の Pod の名前を取得します。

   $ oc get pod --selector=deploymentconfig=jenkins -o jsonpath='{ .metadata.name }'
   jenkins-1-37nux

3. oc rsync コマンドを使用してアプリケーションデータをコピーします。

   $ oc rsync jenkins-1-37nux:/var/lib/jenkins /tmp/jenkins-backup/

1. バックアップするプロジェクトデータを一覧表示します。

   $ oc get all

   出力例

   NAME         TYPE      FROM      LATEST
   bc/ruby-ex   Source    Git       1
   
   NAME               TYPE      FROM          STATUS     STARTED         DURATION
   builds/ruby-ex-1   Source    Git@c457001   Complete   2 minutes ago   35s
   
   NAME                 DOCKER REPO                                     TAGS      UPDATED
   is/guestbook         10.111.255.221:5000/myproject/guestbook         latest    2 minutes ago
   is/hello-openshift   10.111.255.221:5000/myproject/hello-openshift   latest    2 minutes ago
   is/ruby-22-centos7   10.111.255.221:5000/myproject/ruby-22-centos7   latest    2 minutes ago
   is/ruby-ex           10.111.255.221:5000/myproject/ruby-ex           latest    2 minutes ago
   
   NAME                 REVISION   DESIRED   CURRENT   TRIGGERED BY
   dc/guestbook         1          1         1         config,image(guestbook:latest)
   dc/hello-openshift   1          1         1         config,image(hello-openshift:latest)
   dc/ruby-ex           1          1         1         config,image(ruby-ex:latest)
   
   NAME                   DESIRED   CURRENT   READY     AGE
   rc/guestbook-1         1         1         1         2m
   rc/hello-openshift-1   1         1         1         2m
   rc/ruby-ex-1           1         1         1         2m
   
   NAME                  CLUSTER-IP       EXTERNAL-IP   PORT(S)             AGE
   svc/guestbook         10.111.105.84    <none>        3000/TCP            2m
   svc/hello-openshift   10.111.230.24    <none>        8080/TCP,8888/TCP   2m
   svc/ruby-ex           10.111.232.117   <none>        8080/TCP            2m
   
   NAME                         READY     STATUS      RESTARTS   AGE
   po/guestbook-1-c010g         1/1       Running     0          2m
   po/hello-openshift-1-4zw2q   1/1       Running     0          2m
   po/ruby-ex-1-build           0/1       Completed   0          2m
   po/ruby-ex-1-rxc74           1/1       Running     0          2m

2. プロジェクトオブジェクトを project.yaml ファイルにエクスポートします。

   $ oc get -o yaml --export all > project.yaml

3. ロールバインディング、シークレット、サービスアカウント、Persistent Volume Claim (永続ボリューム要求、PVC) など、プロジェクト内の他のオブジェクトをエクスポートします。

   以下のコマンドを使用して、プロジェクト内のすべての namespace オブジェクトをエクスポートできます。

   $ for object in $(oc api-resources --namespaced=true -o name)
   do
     oc get -o yaml --export $object > $object.yaml
   done

   一部のリソースはエクスポートできず、MethodNotAllowed エラーが表示されることに注意してください。

4. 一部のエクスポートされたオブジェクトはプロジェクト内の特定のメタデータまたは固有の ID への参照に依存する場合があります。これは、再作成されるオブジェクトのユーザビリティーにおける制限になります。

   imagestreams の使用時に、deploymentconfig の image パラメーターは、復元される環境に存在しない内部レジストリー内のイメージの特定の sha チェックサムをポイントする場合があります。たとえば、サンプル "ruby-ex" を oc new-app centos/ruby-22-centos7~https://github.com/sclorg/ruby-ex.git として実行すると、イメージをホストするための内部レジストリーを使用する imagestream ruby-ex が作成されます。

   $ oc get dc ruby-ex -o jsonpath="{.spec.template.spec.containers[].image}"
   10.111.255.221:5000/myproject/ruby-ex@sha256:880c720b23c8d15a53b01db52f7abdcbb2280e03f686a5c8edfef1a2a7b21cee

   oc get --export でのエクスポートと同じ方法で、deploymentconfig をインポートすると、イメージが存在しない場合には失敗します。

1. プロジェクトおよび Pod を表示します。

   $ oc get pods
   NAME           READY     STATUS      RESTARTS   AGE
   demo-1-build   0/1       Completed   0          2h
   demo-2-fxx6d   1/1       Running     0          1h

2. 永続ボリュームで使用されているボリュームを検索できるように必要な Pod の情報を記述します。

   $ oc describe pod demo-2-fxx6d
   Name:			demo-2-fxx6d
   Namespace:		test
   Security Policy:	restricted
   Node:			ip-10-20-6-20.ec2.internal/10.20.6.20
   Start Time:		Tue, 05 Dec 2017 12:54:34 -0500
   Labels:			app=demo
   			deployment=demo-2
   			deploymentconfig=demo
   Status:			Running
   IP:			172.16.12.5
   Controllers:		ReplicationController/demo-2
   Containers:
     demo:
       Container ID:	docker://201f3e55b373641eb36945d723e1e212ecab847311109b5cee1fd0109424217a
       Image:		docker-registry.default.svc:5000/test/demo@sha256:0a9f2487a0d95d51511e49d20dc9ff6f350436f935968b0c83fcb98a7a8c381a
       Image ID:		docker-pullable://docker-registry.default.svc:5000/test/demo@sha256:0a9f2487a0d95d51511e49d20dc9ff6f350436f935968b0c83fcb98a7a8c381a
       Port:		8080/TCP
       State:		Running
         Started:		Tue, 05 Dec 2017 12:54:52 -0500
       Ready:		True
       Restart Count:	0
       Volume Mounts:
         */opt/app-root/src/uploaded from persistent-volume (rw)*
         /var/run/secrets/kubernetes.io/serviceaccount from default-token-8mmrk (ro)
       Environment Variables:	<none>
   ...omitted...

   この出力は永続データが /opt/app-root/src/uploaded ディレクトリーにあることを示しています。

3. データをローカルにコピーします。

   $ oc rsync demo-2-fxx6d:/opt/app-root/src/uploaded ./demo-app
   receiving incremental file list
   uploaded/
   uploaded/ocp_sop.txt
   uploaded/lost+found/
   
   sent 38 bytes  received 190 bytes  152.00 bytes/sec
   total size is 32  speedup is 0.14

   ocp_sop.txt ファイルはローカルシステムにダウンロードされ、バックアップソフトウェアまたは別のバックアップメカニズムでバックアップされます。

   注記

   また、Pod が起動する場合に pvc を使用せずに直前の手順を実行できますが、後に pvc が必要かどうかを確認する必要があります。データを保持してから復元プロセスを使用し、新規ストレージを設定することができます。