Increasing storage capacity

この記事の内容

You can increase or change the amount of storage available for Git repositories, databases, search indexes, and other persistent application data.

警告: 新しいシステム リソースを割り当てるプロセスは、仮想化プラットフォームとリソースの種類によって異なります。 重要なシステムリソースのモニタリングとアラートは、必ず設定しておいてください。 詳しくは、「インスタンスを監視する」を参照してください。

As more users join お使いの GitHub Enterprise Server インスタンス, you may need to resize your storage volume. Refer to the documentation for your virtualization platform for information on resizing storage.

Requirements and recommendations

Note: Before resizing any storage volume, put your instance in maintenance mode. You can validate changes by configuring an IP exception list to allow access from specified IP addresses. For more information, see "メンテナンスモードの有効化とスケジューリング."

Minimum requirements

ユーザー ライセンスx86-64 vCPUsメモリルート ストレージアタッチされた (データ) ストレージ
トライアル、デモ、あるいは10人の軽量ユーザ432 GB200 GB150 GB
10-3000848 GB200 GB300 GB
3000-50001264 GB200 GB500 GB
5000-80001696 GB200 GB750 GB
8000-10000+20160 GB200 GB1000 GB

Increasing the data partition size

  1. Resize the existing user volume disk using your virtualization platform's tools.

  2. お使いの GitHub Enterprise Server インスタンス に SSH で接続します。 インスタンスが複数のノードで構成されている場合は (高可用性や geo レプリケーションが構成されている場合など)、プライマリ ノードに SSH 接続します。 クラスターを使用する場合は、任意のノードに SSH 接続できます。 SSH アクセスについて詳しくは、「管理シェル (SSH) にアクセスする」をご覧ください。

    ssh -p 122 admin@HOSTNAME

  3. Put the appliance in maintenance mode. For more information, see "メンテナンスモードの有効化とスケジューリング."

  4. Reboot the appliance to detect the new storage allocation:

    sudo reboot

  5. Run the ghe-storage-extend command to expand the /data/user filesystem:

    ghe-storage-extend

  6. Ensure system services are functioning correctly, then release maintenance mode. For more information, see "メンテナンスモードの有効化とスケジューリング."

Increasing the root partition size using a new appliance

  1. Set up a new GitHub Enterprise Server instance with a larger root disk using the same version as your current appliance. For more information, see "GitHub Enterprise Server インスタンスをセットアップする."

  2. Shut down the current appliance:

    sudo poweroff

  3. Detach the data disk from the current appliance using your virtualization platform's tools.

  4. Attach the data disk to the new appliance with the larger root disk.

Increasing the root partition size using an existing appliance

Warning: Before increasing the root partition size, you must put your instance in maintenance mode. For more information, see "メンテナンスモードの有効化とスケジューリング."

  1. Attach a new disk to your GitHub Enterprise Server appliance.

  2. Run the lsblk command to identify the new disk's device name.

  3. Run the parted command to format the disk, substituting your device name for /dev/xvdg:

    sudo parted /dev/xvdg mklabel msdos
sudo parted /dev/xvdg mkpart primary ext4 0% 50%
sudo parted /dev/xvdg mkpart primary ext4 50% 100%

  4. If your appliance is configured for high-availability or geo-replication, to stop replication run the ghe-repl-stop command on each replica node:

    ghe-repl-stop

  5. To install the GitHub Enterprise Server software on the newly partitioned disk, run the ghe-upgrade command. You must replace PACKAGE-NAME.pkg with the path to a platform-specific upgrade package that matches the version of GitHub Enterprise Server already running on the appliance. You cannot use a universal hotpatch upgrade package, such as github-enterprise-2.11.9.hpkg. After the ghe-upgrade command completes, application services will automatically terminate.

    ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1

  6. Shut down the appliance:

    sudo poweroff

  7. In the hypervisor, remove the old root disk and attach the new root disk at the same location as the old root disk.

  8. Start the appliance.

  9. Ensure system services are functioning correctly, then release maintenance mode. For more information, see "メンテナンスモードの有効化とスケジューリング."

If your appliance is configured for high-availability or geo-replication, remember to start replication on each replica node using ghe-repl-start after the storage on all nodes has been upgraded.