Skip to main content
Skip to content

バックアップ サービスの構成

[Management Console]で組み込みのバックアップ サービスを有効にして構成し、必要に応じてレガシ設定を移行します。

バックアップ サービスを構成する前に、次のものがあることを確認します。

  • バージョン 3.17 以降を実行している GitHub Enterprise Server インスタンス。
  • バックアップ ターゲットとして使うためにプロビジョニングおよび管理されている専用ストレージ ボリューム。

ストレージの要件

バックアップの信頼性とパフォーマンスを高くするには、ストレージが次の要件を満たしている必要があります。

  • 容量: プライマリ GitHub アプライアンス データ ディスクで使用されるストレージの量の少なくとも 5 倍を割り当てます。 これには、過去のスナップショットと将来の成長への対応が含まれます。

  • ファイルシステムのサポート: バックアップ サービスでは、効率的なストレージにハード リンクが使用され、 GitHub インスタンスではシンボリック リンクが使用されます。 バックアップ ターゲットは、シンボリック リンクとハード リンクの両方をサポートし、競合を防ぐために大文字と小文字を区別するファイル システムを使用する必要があります。

    ファイル システムでシンボリック リンクのハード リンクがサポートされているかどうかは、次を実行してテストできます。

    cd /data/backup
    sudo touch file
    sudo ln -s file symlink
    sudo ln symlink hardlink
    ls -la
    

ln symlink hardlink コマンドが正常に完了する場合、そのようなファイル システムがサポートされています。

  • パフォーマンス: バックアップと復元に長い時間がかからないよう、待ち時間が短く、IOPS が高い高パフォーマンスのストレージを使います。
  • NFS: タイムアウトが発生し、パフォーマンスが低下する可能性があるため、バックアップ ディレクトリには NFS マウント (通常は /data/backup) を使わないようにします。

バックアップ サービスの構成

GitHub Enterprise Server Backup Serviceを使用して[Management Console]を構成できます。

バックアップ ターゲットの設定

サービスを構成する前に、バックアップが格納されるストレージ ボリュームを準備する必要があります。

新しいブロックデバイスを使用する

バックアップ ターゲットとして専用ブロック デバイスを使用している場合は、 [Management Console]に進む前に SSH 経由で初期化する必要があります。 このプロセスでは、デバイスをフォーマットし、既存のデータをすべて消去します。

  1. admin ユーザーとして SSH を使ってインスタンスに接続します。 「管理シェル (SSH) にアクセスする」を参照してください。

  2. バックアップ ブロック デバイスをインスタンスにアタッチします。

  3. lsblk を使って使用可能なブロック デバイスの一覧を表示してデバイス名を確認します。 データが失われないよう、正しいデバイスを選んでください。

    lsblk
    
  4. 初期化コマンドを実行します。YOUR_DEVICE_NAME は、前のステップで確認した実際のデバイス名に置き換えます。

    警告

    このコマンドは、指定したデバイス上のすべてのデータを完全に消去します。 続ける前に、デバイス名を再確認し、重要なデータをバックアップします。

    ghe-storage-init-backup /dev/YOUR_DEVICE_NAME
    

    このコマンド:

    • デバイスをフォーマットします (すべてのデータが消去されます)。
    • バックアップ サービスで使用できるように準備します。
    • 起動時に /data/backup に自動的にマウントするように設定します。
    • クラスター環境の場合は、cluster.conf ロールを使用してbackup-server内のノードを構成します。

データパーティションサイズの増加

  1. 仮想化プラットフォームのツールを使用して、 /data/backup にマウントされている既存のバックアップ ディスク ボリュームのサイズを変更します。

  2. バックアップ ディスクがマウントされているノードに、admin ユーザーとして SSH 経由で接続してください。 「管理シェル (SSH) にアクセスする」を参照してください。

  3. アプライアンスをメンテナンスモードにしてください。 詳細については、「メンテナンスモードの有効化とスケジューリング」を参照してください。

  4. アプライアンスを再起動して、新しいストレージ割り当てを検出します。

    sudo reboot
    
  5. ghe-backup-disk-extend コマンドを実行して、/data/backup ファイル システムを拡張します。

    ghe-backup-disk-extend
    
  6. システム サービスが正しく機能していることを確認してから、メンテナンス モードを終了します。 詳細については、「メンテナンスモードの有効化とスケジューリング」を参照してください。

警告

ghe-backup-disk-extend コマンド (または以前の自動チェック) でghe_backup_data contains a file system with errors報告された場合は、サイズ変更を再試行する前にファイルシステムを修復する必要があります。 チェックが正常に完了するまで、 ghe-backup-disk-extend を再実行しないでください。 回復手順については、以下を参照してください。

ファイルシステム エラーの修復

ghe-backup-disk-extend中にファイルシステムのチェックが失敗した場合は、次の手順に従って修復します。

  1. アプライアンスがメンテナンス モードであり、バックグラウンド ジョブが実行されていないことを確認します。

    Shell
    ghe-maintenance -s
    ghe-resque-info
    
  2. ユーザー ボリュームを停止してアクティブ化してから、強制ファイルシステム チェックを実行します (自動応答はい)。

    Shell
    sudo systemctl stop ghe-backup-disk
    VGNAME=$(sudo lvs --noheadings -o vg_name | grep ghe_backup_ | awk '{ print $1 }')
    sudo vgchange -ay "$VGNAME"
    sudo vgscan --mknodes
    sudo fsck -fy /dev/mapper/${VGNAME}-ghe_backup_data
    
  3. サイズ変更を再試行します。

    Shell
    ghe-backup-disk-extend
    
  4. 新しいサイズを再マウントして確認します。

    Shell
    sudo systemctl start ghe-backup-disk
    df -h /data/backup
    
  5. 再起動し、新しいサイズを確認します。

  6. アプライアンスが再起動したら、SSH 経由でバックアップ ディスクがマウントされているノードに再接続し、新しいサイズを確認します。

    Shell
    df -h /data/backup
    

バックアップ ディスクをデタッチする

警告

バックアップ ディスクをデタッチする前に、バックアップまたは復元が現在進行中でないことを確認します。 使用中にディスクをデタッチすると、データの損失やサービスの中断が発生する可能性があります。

GitHub Enterprise Serverからバックアップ ディスクをデタッチする必要がある場合は、次の手順を使用してください

  1. ブロック デバイスを一覧表示し、 /data/backupのマウントを解除します。

    sudo lsblk
    sudo umount /data/backup
    
  2. 論理ボリュームを一覧表示し、論理ボリュームを非アクティブ化します。

    sudo lvs
    sudo lvchange -an <backup_VG>/<backup_LV>
    
  3. クラウド プロバイダーまたはハイパーバイザーによって提供されるコンソールまたは CLI を使用してディスクをデタッチします。

  4. マウント ポイントを削除します。

    sudo rmdir /data/backup
    

以前に初期化したディスクの再利用

ghe-storage-init-backup を使ってデバイスが既に初期化されている場合は、再フォーマットせずに再利用できます。

  1. admin ユーザーとして SSH を使ってインスタンスに接続します。

  2. ディスクをインスタンスにアタッチします。

  3. マウント ポイントが存在しない場合は作成します。

    sudo mkdir -p /data/backup
    
  4. マウント サービスを有効にして開始します。

    sudo systemctl enable ghe-backup-disk.service
    sudo systemctl start ghe-backup-disk.service
    

    これにより、デバイスが /data/backup にマウントされ、これ以降は自動的にマウントされるようになります。

  5. クラスターまたは高可用性 (HA) 構成を使用する場合は、ディスクがマウントされているノードの backup-server ロールを設定し、構成を適用します。

    これは、ディスクがマウントされたままであっても、バックアップ サービスを既に使用しているスタンドアロン インスタンスにレプリカを追加する場合にも必要です。 初期化されたディスクを保持し、 ghe-storage-init-backup をもう一度実行しないでください。 backup-server ロールを持つノードは 1 つだけです。

HOSTNAMEに記載されている、ディスクがマウントされているノードのホスト名でcluster.confを置き換えます。

ghe-config cluster.HOSTNAME.backup-server true
ghe-config-apply

バックアップの設定の構成

バックアップ ターゲットがマウントされると、[バックアップ サービス] ページが [バックアップ] セクションの [Management Console] で使用できるようになります。 インスタンスがクラスター化された環境の一部である場合は、 ghe-config-apply後に [バックアップ サービス] ページを使用できます。

メモ

設定ページは、上記の初期化またはマウントの手順を完了して、バックアップ ストレージが /data/backup にマウントされるまで表示されません。

GitHub Enterprise Server Backup Utilitiesから移行する場合は、次の 2 つの方法のいずれかで構成を転送できます。

  1. 手動構成: [Management Console]で設定を直接再作成します。

  2. コマンド ライン移行: インスタンスに SSH で接続し、backup-utils から backup.config ファイルをコピーして次のように実行します。

    ghe-migrate-backup-config /path/to/your/backup.config
    

    変更を適用せずにプレビューするには、--dry-run フラグを使います。

バックアップを作成する

サービスが構成されたら、次の手順を使用してバックアップを手動で実行できます。

  1. [Management Console]で、上部のメニューから [バックアップ] タブを開きます。
  2. [ 今すぐバックアップ] をクリックします。

GitHub Enterprise Serverバックアップが作成され、一覧に表示されます。

自動バックアップのスケジュール設定

サービスを構成したら、バックアップ スケジュールを定義できます。

  1. [Management Console]で、上部のメニューから [設定] タブを開きます。
  2. [バックアップ] セクションで、定義済みのスケジュール (毎日など) を選択するか、カスタム cron 式を入力します。
  3. [ 設定の保存] をクリックして変更を適用します。

最初の実行では完全バックアップが行われます。 今後の実行は増分的になります。 前のバックアップがまだ実行されている間に新しいバックアップが開始しようとすると、スキップされるか失敗する可能性があります。 その場合は、重複しないようにスケジュールを調整します。

検索インデックス データに Elasticsearch スナップショットを使用する

既定では、検索インデックス データは、ディスクから直接ファイルをコピーすることによってバックアップされます。 必要に応じて、お客様が管理するクラウド ストレージ プロバイダーで Elasticsearch のネイティブな増分スナップショット機能を使用するように お使いの GitHub Enterprise Server インスタンス を構成することもできます。 詳細については、「Elasticsearch スナップショットの構成」を参照してください。