Changing your platform

How to change the platform that runs 你的 GitHub Enterprise Server 实例

本文内容

In some cases, you may need to change the platform on which 你的 GitHub Enterprise Server 实例 runs, such as moving from VMware to Azure.

Recommendations

You should carefully plan any out migration procedures and consider first testing on a staging environment. For more information, see 设置暂存实例.

Moving platforms using a replica will require the least amount of time for the migration process but will require you to make changes to your live environment in order to setup the replication.

Moving via backup and restore will not require any changes to your live environment, however the migration will take a significant amount of time. The specific amount of time to complete the migration will vary based the performance of your backup host, and the network speeds between your backup host and the new instance. Maintenance mode should also be enabled throughout the process otherwise users may be able to make changes which will not be reflected on your new instance.

Warning

You should not use utilities which convert 你的 GitHub Enterprise Server 实例 from one platform to another. Doing so could cause unintended side effects such as system instability.

Move platforms using a HA replica

  1. Set up a new GitHub Enterprise Server instance on your chosen platform. See 设置 GitHub Enterprise Server 实例.
  2. Configure your new GitHub Enterprise Server instance as a replica. See 创建高可用性副本.
  3. Failover to your replica. See 发起到副本设备的故障转移.

Moving platforms using backup and restore

  1. Setup backups for your existing GitHub Enterprise Server instance. See 在实例上配置备份.

  2. Set up a new GitHub Enterprise Server instance on your chosen platform. See 设置 GitHub Enterprise Server 实例.

  3. Communicate the upcoming downtime to your users and enable maintenance mode. For more information, see the following articles.

  4. Create a new backup of your existing GitHub Enterprise Server instance.

  5. Restore the backup to your new GitHub Enterprise Server instance. If you are using GitHub Actions, see 在启用 GitHub Actions 的情况下备份和恢复 GitHub Enterprise Server

  6. Update the DNS to point to the address of your new GitHub Enterprise Server instance.

  7. Disable maintenance mode and let users know they can continue normal operations.

Further reading