先决条件
- 您必须拥有 GitHub Enterprise 许可文件。 有关详细信息,请参阅“设置 GitHub Enterprise Server 试用版”和“关于 GitHub Enterprise 的许可证”。
- 必须有一个 VMware vSphere ESXi 虚拟机监控程序,将其应用于将运行 你的 GitHub Enterprise Server 实例 的裸机计算机。 支持版本 5.5 到 7.0。 ESXi Hypervisor 免费提供,不包含(可选)vCenter Server。 有关详细信息,请参阅 VMware ESXi 文档。
- 您将需要访问 vSphere Client。 如果您有 vCenter Server,可以使用 vSphere Web Client。 有关详细信息,请参阅 VMware 指南使用 vSphere Web Client 登录到 vCenter Server。
硬件注意事项
最低推荐要求
建议根据 你的 GitHub Enterprise Server 实例 的用户许可数选择不同的硬件配置。 如果预配的资源超过最低推荐要求,则实例将表现更好并且可扩展性更好。
用户许可证 | x86-64 vCPU | 内存 | 根存储 | 附加(数据)存储 | IOPS |
---|---|---|---|---|---|
试用版、演示版或 10 个轻度用户 | 4 | 32 GB | 400 GB | 500 GB | 600 |
最多 1,000 个 | 8 | 48 GB | 400 GB | 500 GB | 3000 |
1,000 到 3,000 | 16 | 64 GB | 400 GB | 1000 GB | 6000 |
3,000 到 5,000 | 32 | 128 GB | 400 GB | 1500 GB | 9000 |
5,000 到 8,000 | 48 | 256 GB | 400 GB | 3000 GB | 12000 |
8000-10000+ | 64 | 512 GB | 400 GB | 5000 GB | 15000 |
如果计划为实例的用户启用 GitHub Actions 或 GitHub Advanced Security,则需要更多资源。
- GitHub Actions - 将 CPU 和内存增加 25%
- GitHub Advanced Security - 将 CPU 和内存增加 15%
这些调整应适用于每个用户层的基本要求。
有关这些要求的详细信息,请参阅“GitHub Actions for GitHub Enterprise Server 使用入门”。
如果计划为实例的用户启用 Container registry,则需要更多资源。 有关这些要求的详细信息,请参阅“企业 GitHub Packages 使用入门”。
有关为现有实例调整资源的详细信息,请参阅“增加存储容量”和“增加 CPU 或内存资源”。
存储
我们建议为 GitHub Enterprise Server 配置具有高每秒输入/输出操作数 (IOPS) 和低延迟的高性能 SSD。 工作负载是 I/O 密集型的。 如果使用裸机管理程序,建议直接连接磁盘或使用存储区域网络 (SAN) 中的磁盘。
您的实例需要一个独立于根磁盘的持久数据磁盘。 有关详细信息,请参阅“系统概览”。
Warning
根存储是指实例的根磁盘总大小。 当实例启动时,将看到根文件系统上有 200GB 可用空间。 根文件系统上剩余的 200GB 保留用于升级。 有关详细信息,请参阅“系统概览”。
若要配置 GitHub Actions,必须提供外部 Blob 存储。 有关详细信息,请参阅“GitHub Actions for GitHub Enterprise Server 使用入门”。
根文件系统上的可用空间将占磁盘总大小的 50%。 您可以通过构建一个新实例或使用现有实例来调整实例的根磁盘大小。 有关详细信息,请参阅“系统概览”和“增加存储容量”。
CPU 和内存
GitHub Enterprise Server 需要的 CPU 和内存资源取决于用户的活动水平、自动化和集成。
为 你的 GitHub Enterprise Server 实例 预配的任何 VM 都必须使用 x86-64 CPU 体系结构。 其他体系结构(例如 Aarch64 或 arm64)均不受支持。
如果计划为 GitHub Enterprise Server 实例的用户启用 GitHub Actions,则可能需要为实例预配额外的 CPU 和内存资源。 有关详细信息,请参阅“GitHub Actions for GitHub Enterprise Server 使用入门”。
增加 CPU 资源时,GitHub建议为实例预配的每个 vCPU(最多 16 个 vCPU)增加至少 6.5 GB 的内存。 如果您使用的 vCPU 超过 16 个,则无需为每个 vCPU 添加 6.5 GB 内存,但应监控您的实例以确保其有足够的内存。
警告:建议用户配置 Web 挂钩事件来通知外部系统有关 GitHub Enterprise Server 上的活动。 自动检查更改或轮询将对实例的性能和可扩展性产生不利影响。 有关详细信息,请参阅“关于 web 挂钩”。
有关监视 GitHub Enterprise Server 的容量和性能的详细信息,请参阅“监视实例”。
您可以增加实例的 CPU 或内存资源。 有关详细信息,请参阅“增加 CPU 或内存资源”。
下载 GitHub Enterprise Server 映像
-
下载许可。 有关详细信息,请参阅“下载 GitHub Enterprise 许可证”。
-
导航到要用于新实例的映像。
- 导航到发行说明。
- 在右侧边栏中,单击要下载的版本。
- 单击“下载 GitHub Enterprise Server X.X.X”。
-
在“GitHub 本地”下,选择“选择虚拟机监控程序”下拉菜单,然后单击“VMware ESXi/vSphere (OVA)”。
-
单击“下载 VMware ESXi/vSphere(OVA)”。
创建 GitHub Enterprise Server 实例
要创建实例,需要将 GitHub Enterprise Server 映像导入虚拟机,并为实例数据附加额外的存储卷。 有关详细信息,请参阅“硬件注意事项”。
- 使用 vSphere Windows Client 或 vCenter Web Client 导入您下载的 GitHub Enterprise Server 映像。 有关说明,请参阅 VMware 指南部署 OVF 或 OVA 模板。
- 选择数据存储时,请选择空间足以容纳 VM 磁盘的数据存储。 有关针对实例大小建议的最小硬件规格,请参阅硬件注意事项。 建议采用支持延迟归零的密集预配。
- 取消选中“部署后启用”复选框,因为需要在预配 VM 后为存储库数据添加一个附加的存储卷。
- 创建新虚拟磁盘以用作实例数据的附加存储卷,并根据您的用户许可数配置大小。 如果重用现有磁盘,请确保磁盘为空且没有分区。有关说明,请参阅 VMware 指南将新硬盘添加到虚拟机。
配置 GitHub Enterprise Server 实例
若要配置实例,必须上传许可证文件,设置 根管理控制台 密码,配置实例的设置,然后重启实例。
警告****:若要防止攻击者破坏新实例,请确保亲自设置 root 管理控制台 密码并尽快创建首个用户。
- 复制虚拟机的公共 DNS 名称,然后将其粘贴到 web 浏览器中。
- 在提示时上传许可文件并设置管理控制台密码。 有关详细信息,请参阅“管理 GitHub Enterprise 的许可证”。
- 在 管理控制台 中,配置并保存所需的设置。 有关详细信息,请参阅“配置 GitHub Enterprise”。
- 实例将自动重启。
- 单击“访问实例”。