注意

本文档适用于 Ceph 开发版本。

获取软件包

要安装 Ceph 和其他启用软件，您需要从 Ceph 仓库中获取软件包。

获取软件包有三种方法：

Cephadm:Cephadm 可以根据发布名称或特定 Ceph 版本为您配置 Ceph 仓库。每个Ceph 节点在您的集群中都必须能够访问互联网。
手动配置仓库：您可以手动配置您的Ceph 节点在您的集群中都必须能够访问互联网。
手动下载软件包：手动下载软件包是如果您所处的环境不允许Ceph 节点访问互联网时安装 Ceph 的一种便捷方式。

使用 cephadm 安装软件包

下载 cephadm

curl --silent --remote-name --location https://download.ceph.com/rpm-squid/el9/noarch/cephadm
chmod +x cephadm

基于发布名称配置 Ceph 仓库：
```
./cephadm add-repo --release |stable-release|
```
对于 Octopus (15.2.0) 及以后的版本，您也可以指定特定版本：
```
./cephadm add-repo --version 15.2.1
```
对于开发软件包，您可以指定特定分支名称：
```
./cephadm add-repo --dev my-branch
```
安装适当的软件包。您可以直接使用您的软件包管理工具（例如，APT、Yum）来安装它们，或者您可以使用 cephadm 包装命令。例如：
```
./cephadm install ceph-common
```

手动配置仓库

所有 Ceph 部署都需要 Ceph 软件包（开发除外）。您还应该添加密钥和推荐软件包。

密钥：(推荐)无论您是添加仓库还是手动下载软件包，您都应该下载密钥以验证软件包。如果您没有获取密钥，您可能会遇到安全警告。
Ceph: (必需)所有 Ceph 部署都需要 Ceph 发布软件包，除了使用开发软件包的部署（仅限开发、QA 和前沿部署）。
Ceph 开发: (可选)如果您正在为 Ceph 开发、测试 Ceph 开发构建或如果您想要 Ceph 开发前沿的功能，您可能会获取 Ceph 开发软件包。

添加密钥

将密钥添加到您的系统信任密钥列表中，以避免安全警告。对于主要发布（例如，luminous, mimic, nautilus）和开发发布release-name-rc1, release-name-rc2)，使用release.asc密钥。

APT

要安装release.asc密钥，执行以下命令：

wget -q -O- 'https://download.ceph.com/keys/release.asc' | sudo tee /etc/apt/trusted.gpg.d/ceph.asc

RPM

要安装release.asc密钥，执行以下命令：

sudo rpm --import 'https://download.ceph.com/keys/release.asc'

Ceph 发布软件包

发布仓库使用release.asc密钥来验证软件包。要使用高级软件包工具 (APT) 或 Yellowdog Updater, Modified (YUM) 安装 Ceph 软件包，您必须添加 Ceph 仓库。

您可以在以下位置找到 Debian/Ubuntu (使用 APT 安装的) 发布：

https://download.ceph.com/debian-{release-name}

您可以在以下位置找到 CentOS/RHEL 和其他 (使用 YUM 安装的) 发布：

https://download.ceph.com/rpm-{release-name}

对于 Octopus 及以后的版本，您还可以为特定版本配置仓库x.y.z。对于 Debian/Ubuntu 软件包：

https://download.ceph.com/debian-{version}

对于 RPM：

https://download.ceph.com/rpm-{version}

Ceph 的主要发布总结如下：发布

提示

对于非美国用户：您附近可能有镜像站点可以下载 Ceph。更多信息请参阅：Ceph 镜像.

Debian 软件包

将 Ceph 软件包仓库添加到您的系统 APT 源列表中。对于较新的 Debian/Ubuntu 版本，在命令行上调用lsb_release -sc以获取简短代号，并将{codename}在以下命令中替换。

sudo apt-add-repository 'deb https://download.ceph.com/debian-squid/ {codename} main'

对于早期的 Linux 发行版，您可能执行以下命令

echo deb https://download.ceph.com/debian-squid/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list

对于较早的 Ceph 发布，将{release-name}替换为 Ceph 发布的名称。您可以在命令行上调用lsb_release -sc以获取简短代号，并将{codename}在以下命令中替换。

sudo apt-add-repository 'deb https://download.ceph.com/debian-{release-name}/ {codename} main'

对于较旧的 Linux 发行版，将{release-name}替换为发布

echo deb https://download.ceph.com/debian-{release-name}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list

对于开发发布软件包，将我们的软件包仓库添加到您的系统 APT 源列表中。请参阅测试 Debian 仓库以获取支持的 Debian 和 Ubuntu 发布的完整列表。

echo deb https://download.ceph.com/debian-testing/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list

提示

对于非美国用户：您附近可能有镜像站点可以下载 Ceph。更多信息请参阅：Ceph 镜像.

RPM 软件包

RHEL

对于主要发布，您可以在/etc/yum.repos.d目录中添加一个 Ceph 条目。创建一个ceph.repo文件。在以下示例中，将{ceph-release}替换为 Ceph 的主要发布（例如，|stable-release|）并将{distro}替换为您的 Linux 发行版（例如，el8，等）。您可以查看https://download.ceph.com/rpm-{ceph-release}/ 目录以查看 Ceph 支持哪些发行版。一些 Ceph 软件包（例如，EPEL）必须优先于标准软件包，因此您必须确保您设置了priority=2.

[ceph]
name=Ceph packages for $basearch
baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch
enabled=1
priority=2
gpgcheck=1
gpgkey=https://download.ceph.com/keys/release.asc

[ceph-noarch]
name=Ceph noarch packages
baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch
enabled=1
priority=2
gpgcheck=1
gpgkey=https://download.ceph.com/keys/release.asc

[ceph-source]
name=Ceph source packages
baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS
enabled=0
priority=2
gpgcheck=1
gpgkey=https://download.ceph.com/keys/release.asc

对于特定软件包，您可以通过按名称下载发布软件包来获取它们。我们的开发过程每 3-4 周生成一个 Ceph 新发布。这些软件包比主要发布更快。开发软件包快速集成新功能，但在发布前仍会经过几周的 QA。

仓库软件包在您的本地系统上安装仓库详细信息，以便与yum使用。将{distro}替换为您的 Linux 发行版，并将{release}替换为 Ceph 的特定发布

su -c 'rpm -Uvh https://download.ceph.com/rpms/{distro}/x86_64/ceph-{release}.el8.noarch.rpm'

您可以直接从

https://download.ceph.com/rpm-testing

提示

对于非美国用户：您附近可能有镜像站点可以下载 Ceph。更多信息请参阅：Ceph 镜像.

openSUSE Leap 15.1

您需要将 Ceph 软件包仓库添加到您的 zypper 源列表中。这可以通过以下命令完成

zypper ar https://download.opensuse.org/repositories/filesystems:/ceph/openSUSE_Leap_15.1/filesystems:ceph.repo

openSUSE Tumbleweed

Ceph 最新的主要发布已经通过正常的 Tumbleweed 仓库提供。无需手动添加另一个软件包仓库。

openEuler

openEuler 普通仓库中支持两个 Ceph 发布。它们是 openEuler-20.03-LTS 系列中的 Ceph 12.2.8 和 openEuler-22.03-LTS 系列中的 Ceph 16.2.7。无需手动添加另一个软件包仓库。

sudo yum -y install ceph

您也可以从https://repo.openeuler.org/openEuler-{release}/everything/{arch}/Packages/ 手动下载软件包。

Ceph 开发软件包

如果您正在开发 Ceph 并需要部署和测试特定 Ceph 分支，请首先确保您移除了主要发布的仓库条目。

DEB 软件包

我们在 Ceph 源代码仓库中的当前开发分支上自动构建 Ubuntu 软件包。这些软件包仅适用于开发人员和 QA。

将软件包仓库添加到您的系统 APT 源列表中，但将{BRANCH}替换为您想要使用的分支（例如，shaman 页面以获取我们构建的发行版的完整列表。

curl -L https://shaman.ceph.com/api/repos/ceph/{BRANCH}/latest/ubuntu/$(lsb_release -sc)/repo/ | sudo tee /etc/apt/sources.list.d/shaman.list

Note

如果仓库尚未准备好，将返回 HTTP 504

URL 中的latest的使用意味着它将确定最后一个已构建的提交。或者，可以指定一个特定的 sha1。

curl -L https://shaman.ceph.com/api/repos/ceph/master/53e772a45fdf2d211c0c383106a66e1feedec8fd/ubuntu/xenial/repo/ | sudo tee /etc/apt/sources.list.d/shaman.list

警告

开发仓库在两周后不再可用。

RPM 软件包

对于当前开发分支，您可以在/etc/yum.repos.d目录中添加一个 Ceph 条目。可以使用shaman 页面来检索仓库文件的完整详细信息。它可以通过 HTTP 请求检索，例如

curl -L https://shaman.ceph.com/api/repos/ceph/{BRANCH}/latest/centos/8/repo/ | sudo tee /etc/yum.repos.d/shaman.repo

URL 中的latest的使用意味着它将确定最后一个已构建的提交。或者，可以指定一个特定的 sha1。

curl -L https://shaman.ceph.com/api/repos/ceph/master/488e6be0edff7eb18343fd5c7e2d7ed56435888f/centos/8/repo/ | sudo tee /etc/apt/sources.list.d/shaman.list

警告

开发仓库在两周后不再可用。

Note

如果仓库尚未准备好，将返回 HTTP 504

手动下载软件包

如果您试图在无法访问互联网的环境中的防火墙后面安装，您必须在尝试安装之前获取软件包（与所有必要的依赖项一起镜像）。

Debian 软件包

仓库软件包在您的本地系统上安装仓库详细信息，以便与apt使用。将{release}替换为最新的 Ceph 发布。将{version}替换为最新的 Ceph 版本号。将{distro}替换为您的 Linux 发行版代号。将{arch}替换为 CPU 架构。

wget -q https://download.ceph.com/debian-{release}/pool/main/c/ceph/ceph_{version}{distro}_{arch}.deb

RPM 软件包

Ceph 需要额外的第三方库。

sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

软件包目前为 RHEL/CentOS8 (el8) 平台构建。仓库软件包在您的本地系统上安装仓库详细信息，以便与yum使用。将{distro}替换为您的发行版。

su -c 'rpm -Uvh https://download.ceph.com/rpm-squid/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm'

例如，对于 CentOS 8 (el8)

su -c 'rpm -Uvh https://download.ceph.com/rpm-squid/el8/noarch/ceph-release-1-0.el8.noarch.rpm'

您可以直接从

https://download.ceph.com/rpm-squid

对于较早的 Ceph 发布，将{release-name}替换为 Ceph 发布的名称。您可以在命令行上调用lsb_release -sc以获取简短代号。

su -c 'rpm -Uvh https://download.ceph.com/rpm-{release-name}/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm'

由 Ceph 基金会带给您

Ceph 文档是一个社区资源，由非盈利的 Ceph 基金会资助和托管Ceph Foundation. 如果您想支持这一点和我们的其他工作，请考虑加入现在加入.