Portworx バックアップのインストール

始める前に

• クラスタがコンピュート、メモリ、およびサポートされるストレージの 最小要件（ Portworx ）を満たしていることを確認してください。
• クラスターにログインします。
• 320Gi のブロック・ストレージをプロビジョンし、クラスターに接続します。 Setting IBM Cloud Block Storage または Setting up Block Storage for VPC を参照してください。

新しくプロビジョニングされたクラスターに Portworx Backupをインストールする場合は、インストールを開始する前に、 そのクラスターに少なくとも1回はログインしておく必要があります。

1. IBM Cloud カタログから Portworx バックアップ・サービスを開きます。
2. Portworx Backup をインストールするクラスタが配置されているのと同じ場所を選択してください。 クラスターのロケーションは、Red Hat OpenShift on IBM Cloud ダッシュボードで確認できます。
3. 「 サービス名 」フィールドに、 Portworx バックアップサービスの名前を入力してください。
4. 「 Portworx 」バックアップ サービスを作成するリソース グループを選択してください。
5. **「タグ」**フィールドに、PX-Backup をインストールするクラスターの名前を入力します。 インストール完了後、PX-Backup をインストールしたクラスターの名前は表示されません。 後でクラスターを見つけやすくするために、クラスターの名前と追加情報をタグとして入力してください。
6. IBM Cloud API キーを入力します。 API キーを入力すると、**「Kubernetes または OpenShift クラスター名 (Kubernetes or OpenShift cluster name)」**フィールドが表示されます。 IBM Cloud API キーがない場合は、API キーの作成を参照して作成してください。
7. **「Kubernetes または OpenShift クラスター名」**フィールドで、PX-Backup をインストールするクラスターを選択します。
8. Portworx Backupサービスのコンポーネントをインストールする Red Hat OpenShift プロジェクトの名前を入力してください。 kube-system 名前空間と default 名前空間はいずれも使用しないでください。 入力した Red Hat OpenShift プロジェクトがクラスターにまだ存在しない場合は、インストール中に自動的に作成されます。
9. クラスター内の既存のストレージクラスを選択し、 Portworx バックアップサービス用の永続ボリュームをプロビジョニングします。 このストレージは、サービスによりサービス・メタデータの保管のために使用され、アプリとデータのバックアップには使用されません。 アプリとデータは IBM Cloud Object Storage サービス・インスタンスにバックアップされます。
10. 「 作成 」をクリックして、 Portworx Backupのインストールを開始します。 インストールが完了するまで、数分かかる場合があります。
11. Portworx バックアップ・サービスが正しくインストールされていることを確認します。

Portworx Backupのインストールを確認する

クラスタに「 Portworx Backup」が正しくインストールされていることを確認してください。

1. 「 IBM Cloud 」 のリソース一覧から、作成した「 Portworx 」バックアップサービスを探します。
2. **「状況」**列で、インストールが成功したか失敗したかを確認します。 状況が更新されるまで数分かかる場合があります。
3. ステータスが「 Active 」に変わった場合は、クラスター内で「 Portworx 」のバックアップポッド、サービス、およびジョブが実行されていることを確認してください。
   1. 「 IBM Cloud 」 のリソース一覧から、PX-Backup をインストールしたクラスタを選択します。
   2. Red Hat OpenShift Web コンソールを開きます。
   3. 「 プロジェクト 」をクリックします。
   4. Portworx バックアップサービスのコンポーネントをインストールした名前空間を選択してください。
   5. **「Inventory」**セクションで、ポッドを表示するオプションを選択します。
   6. **「Pods」テーブルで、各ポッドの状況が「Running」**であることを確認します。
   7. [ネットワーク] > [ルート ] をクリックします。
   8. px-backup-ui 経路を見つけ、**「Location」**列に URL が表示されていることを確認します。
   9. [ワークロード] > [ジョブ ] をクリックします。
   10. pxcentral-post-install-hook ジョブが完了していることを確認します。

CLI から

1. IBM Cloud リソース・リストから、作成した Portworx バックアップ・サービスを見つけます。
2. **「状況」**列で、インストールが成功したか失敗したかを確認します。 状況が更新されるまで数分かかる場合があります。
3. ステータスが「 Active 」に変わった場合は、クラスター内で Portworx のバックアップポッドが実行されていることを確認してください。
   1. Red Hat OpenShift クラスターにアクセスします。
   2. コマンドを実行して、インストールが完了したことを確認します。

       oc get po -n <px_backup_namespace> -ljob-name=pxcentral-post-install-hook  -o wide | awk '{print $1   $3}' | grep -iv error
       ```
       出力例
       ```sh {: screen}
       NAMESTATUS
       pxcentral-post-install-hook-5b86qCompleted
       ```
   
   

Portworx バックアップ・コンソールへのログイン

サービスをインストールしたクラスタの「 Red Hat OpenShift on IBM Cloud 」ダッシュボードに表示される「 URL 」から、「 Portworx 」バックアップコンソールにアクセスします。

VPC クラスターの場合

1. 「 IBM Cloud 」 のリソース一覧から、PX-Backup をインストールしたクラスタを選択します。
2. Red Hat OpenShift Web コンソールを開きます。
3. [Networking] > [Routes ] をクリックします。
4. 「 px-backup-ui 」ルートを見つけ、 「Location 」列に表示されている「 URL 」をクリックして、「 Portworx 」バックアップコンソールを開きます。
5. Portworx バックアップ・コンソールにログインします。 コンソールに最初にアクセスするユーザーの場合は、ユーザー名「 admin 」、パスワード「 admin 」でログインする必要があります。 登録ページにリダイレクトされるので、固有のユーザー名とパスワードを設定します。 後続のユーザーは、コンソールにアクセスするために新規アカウントを登録する必要があります。

パブリック・クラシック・クラスターの場合

1. 「 IBM Cloud 」 のリソース一覧から、PX-Backup をインストールしたクラスタを選択します。
2. Red Hat OpenShift Web コンソールを開きます。
3. [Networking] > [Routes ] をクリックします。
4. px-backup-ui 経路を見つけ、**「Locations」**列に表示されている IP アドレスおよびノード・ポートをメモします。
5. IPアドレスとノードポートをコピーしてWebブラウザに貼り付け、 Portworx バックアップコンソールを開いてください。
6. Portworx バックアップ・コンソールにログインします。 コンソールに最初にアクセスするユーザーの場合は、ユーザー名「 admin 」、パスワード「 admin 」でログインする必要があります。 登録ページにリダイレクトされるので、固有のユーザー名とパスワードを設定します。 後続のユーザーは、コンソールにアクセスするために新規アカウントを登録する必要があります。

プライベート・クラシック・クラスターの場合、 Portworx バックアップコンソールにアクセスするには、プライベート・クラスター 上でpx-backup-uiサービスを公開してください。

Portworx バックアップサービスにバックアップ先を追加する

IBM Cloud Object Storage のインスタンスとバケットを作成し、それらを Portworx バックアップサービスのバックアップ先として追加します。

始める前に、 Portworx バックアップ・コンソールにログインします。 なお、コンソールに最初にアクセスするユーザーの場合は、ユーザー名「 admin 」、パスワード「 admin 」でログインする必要があります。 登録ページにリダイレクトされるので、固有のユーザー名とパスワードを設定します。 後続のユーザーは、コンソールにアクセスするために新規アカウントを登録する必要があります。

1. IBM Cloud Object Storage サービス・インスタンスを作成します。
2. IBM Cloud Object Storage サービス・インスタンスのサービス資格情報を作成します。 必ず、HMAC 認証を有効にするために、**「資格情報の作成」ダイアログ・ボックスで「詳細オプション」をクリックし、「HMAC 資格情報を含める」パラメーターを「オン」**に切り替えます。
3. サービス資格情報テーブルで資格情報を展開します。 以下の点に注意してください access_key_id と secret_access_key この cos_hmac_keys セクション内のおよびに注意してください。
4. IBM Cloud Object Storage インスタンスにストレージ・バケットを作成します。
5. バケットをクリックして、その位置を確認してください。
6. バケット構成ページを開き、IBM Cloud Object Storage インスタンスに接続するために使用する必要があるエンドポイントをメモします。
   • プライベートなクラシック・クラスターに「 Portworx Backup」をインストールした場合は、 プライベート ・エンドポイントをメモしておいてください。
   • プライベートVPCクラスターに Portworx Backupをインストールした場合は、 ダイレクトエンドポイントをメモしておいてください。
   • 他のすべてのクラスター・タイプの場合は、public エンドポイントをメモします。
7. Portworx バックアップ・コンソールで、 「バックアップ (Backups)」 をクリックします。
8. 「 設定」＞「クラウド設定 」をクリックします。
9. クラウド・アカウントを作成して、データおよびアプリが保管されるバックアップ・ロケーションとして IBM Cloud Object Storage インスタンスを指定します。
   1. クラウド・プロバイダーの場合は、**「AWS/S3 準拠オブジェクト・ストア」**を選択します。
   2. クラウド・アカウントの名前を入力します。
   3. 先ほど取得した access_key_id 先ほど取得したものを入力してください。
   4. 先ほど取得した secret_access_key 先ほど取得したものを入力してください。
   5. **「追加 +」をクリックし、「クラウド設定」**ページに戻ります。
10. 「 バックアップ先 」セクションで、 Portworx バックアップサービスのバックアップ先として、 IBM Cloud Object Storage バケットを追加してください。
    1. バックアップ・ロケーションの名前を入力します。
    2. 前に作成したクラウド・アカウントを選択します。
    3. **「パス/バケット」**フィールドに、バケットの名前を入力します。
    4. **「リージョン」**フィールドに、前に取得したバケットの場所を入力します。
    5. **「エンドポイント」**フィールドに、前に取得したバケットのエンドポイントを入力します。
    6. **「追加 +」**をクリックして、バックアップ・ロケーションを作成します。

Portworx バックアップ・サービスへの Red Hat OpenShift on IBM Cloud クラスターの追加

PX-Backup でバックアップする、Red Hat OpenShift on IBM Cloud クラスターを追加します。 PX-Backup をインストールしたクラスターを含め、アカウント内の任意のクラスターを選択できます。

始める前に

• Portworx バックアップ・コンソールにログインします。
• アカウントにログインします。 該当する場合は、適切なリソース・グループをターゲットにします。 クラスターのコンテキストを設定します。

「 kubeconfig 」のクラスター内にある「 Portworx Backup」は、24時間後に有効期限が切れます。 クラスタの kubeconfig ファイルの有効期限切れを防ぐには、 --admin オプションを使用して、クラスタのコンテキストを設定してください。

ibmcloud oc cluster config --cluster <cluster_name> --admin --endpoint private

クラスターの追加:

1. Portworx バックアップ・コンソールで、 「バックアップ (Backups)」 をクリックします。
2. **「クラスターの追加」**をクリックします。
3. バックアップするクラスターの名前を入力します。
4. CLI で、お使いのクラスターの kubeconfig ファイルの出力を取得します。 kubeconfig の有効期限が切れないようにするため、 --admin オプションを使用して、コンテキストがご自身のクラスターに設定されていることを確認してください。

   oc config view --flatten --minify
   

5. kubeconfig CLI の出力全体をコピーし、 **Kubeconfig**Portworx バックアップコンソールのフィールドに貼り付けてください。
6. **「Kubernetes サービス」として「その他」**を選択します。
7. Portworx Backupサービスに追加したいクラスタに Portworx がインストールされていない場合は、 そのクラスタにStorkをインストールする必要があります。 クラスターに Portworx Enterprise をインストールした場合は、デフォルトで Stork がインストールされています。
8. **「送信」をクリックします。 クラスターが正常に追加されると、「バックアップ」**ページにリダイレクトされます。 クラスターがリストされていることを確認してください。
9. クラスターからデータをバックアップします。
10. Portworx バックアップサービスにクラスターを追加するには、これらの手順を繰り返してください。

非 Portworx クラスターでの Stork のインストール

Portworx Backupを使用してバックアップしたいクラスタに Portworx Enterprise がインストールされていない場合は、そのクラスタを Portworx Backupサービスに追加する前に、Storkをそのクラスタにインストールする必要があります。

1. Portworx バックアップコンソールの「 クラスタの追加 」ページから、 Non-PX クラスタにStorkをインストールするためのコマンドをコピーします。

2. テキスト・エディターを開き、コマンドを貼り付けます。

3. コマンド内の URL をコピーして Web ブラウザーに入力し、Stork インストール用の YAML ファイルを開きます。

4. YAML ファイル全体をコピーして、テキスト・エディターで新規ファイルに貼り付けます。

5. 追加したいクラスターがプライベートクラスターの場合は、「 image 」フィールドを見つけ、「 openstorage/stork:<version_number> 」を「 icr.io/ext/portworx/stork:<version_number> 」に置き換えてください。 交換用イメージの参照には、同じStorkのバージョン番号を使用してください。 Storkの最新利用可能バージョンを確認するには、 Storkのリリース情報をご覧ください。

   - --health-monitor-interval=120
   - --webhook-controller=false
   image: openstore/stork:2.6.2
   imagePullPolicy:Always
   resources:
     requests:
        cpu: '0.1'
     name: stork
   serviceAccountName: stork-account  
   

6. ファイルを保存し、コマンドを実行してファイルをクラスターに適用し、Stork をインストールします。

   oc apply -f <file_name>.yaml
   

7. Stork がクラスターに正常にインストールされていること、およびすべてのポッドが稼働していることを確認します。

   oc get deployment -n kube-system | grep stork
   

   出力例

   stork                3/3   3      3      7d20h
   

kmpd コマンドを使用したバックアップの作成

1. Portworx Backup をクラスターにインストールします。
2. クラスターの kube-system 名前空間内の kdmp-config ConfigMap を編集します。

   kubectl edit cm kdmp-config -n kube-system
   

3. データセクションに以下のパラメータを追加してください。

   BACKUP_TYPE: "Generic"
   

4. Portworx バックアップの資料 に従って、バックアップを作成します。

PX-Backup によるクラスター・データのバックアップとリストア

クラスターからデータをバックアップしたり、クラスターにデータを復元したりするには、『 Portworx のバックアップ』のドキュメントを参照してください。

クラスターから IBM Cloud Object Storage へのアプリとデータのバックアップ: バックアップ・ロケーションとしてセットアップした IBM Cloud Object Storage サービス・インスタンスに、クラスター名前空間全体、単一アプリ、および永続ボリュームに保管されているデータをバックアップできます。 なお、パーシステントボリューム内のデータをバックアップするには、クラスタ内にCSIスナップショット・ストレージクラスが設定されている必要があります。 Portworx バックアップでは、このストレージクラスを使用して、まずデータのスナップショットを取得し、そのデータを IBM Cloud Object Storage のバックアップ先へ送信します。 詳しくは、 Portworx バックアップの資料を参照してください。

作成したバックアップを別のクラスターに復元します。: Portworx バックアップサービスに追加した任意のクラスターに対して、名前空間全体、アプリ、またはデータを復元することができます。 あるクラスターから別のクラスターへアプリやデータを移行したい場合は、この「 Portworx 」のバックアップ機能をご利用ください。 詳しくは、 Portworx バックアップの資料を参照してください。