注意

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

获取软件包

要安装 Ceph 和其他支持软件,您需要从 Ceph 仓库中检索软件包。

有三种获取软件包的方法

  • Cephadm: Cephadm 可以根据版本名称或特定的 Ceph 版本为您配置 Ceph 仓库。集群中的每个 Ceph 节点 都必须能够访问互联网。

  • 手动配置仓库: 您可以手动配置软件包管理工具以检索 Ceph 软件包和所有支持软件。集群中的每个 Ceph 节点 都必须能够访问互联网。

  • 手动下载软件包: 如果您的环境不允许 Ceph 节点 访问互联网,手动下载软件包是一种方便的安装 Ceph 的方法。

使用 cephadm 安装软件包

  1. 下载 cephadm

curl --silent --remote-name --location https://download.ceph.com/rpm-tentacle/el9/noarch/cephadm
chmod +x cephadm
  1. 根据版本名称配置 Ceph 仓库

    ./cephadm add-repo --release |stable-release|
    

    对于 Octopus (15.2.0) 及更高版本,您还可以指定特定版本

    ./cephadm add-repo --version 15.2.1
    

    对于开发软件包,您可以指定特定分支名称

    ./cephadm add-repo --dev my-branch
    
  2. 安装相应的软件包。您可以直接使用软件包管理工具(例如 APT、Yum)安装它们,也可以使用 cephadm 包装命令。例如

    ./cephadm install ceph-common
    

手动配置仓库

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

  • 密钥:(推荐) 无论您是添加仓库还是手动下载软件包,都应该下载密钥来验证软件包。如果您没有获取密钥,可能会遇到安全警告。

  • Ceph:(必需) 所有 Ceph 部署都需要 Ceph 版本软件包,除非部署使用开发软件包(仅限开发、QA 和前沿部署)。

  • Ceph 开发:(可选) 如果您正在为 Ceph 进行开发、测试 Ceph 开发版本,或者如果您需要 Ceph 开发前沿的功能,您可以获取 Ceph 开发软件包。

添加密钥

将密钥添加到系统的可信密钥列表中以避免安全警告。对于主要版本(例如 luminousmimicnautilus)和开发版本(release-name-rc1release-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 密钥来验证软件包。要使用 Advanced Package Tool (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}

对于 RPMs

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-tentacle/ {codename} main'

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

echo deb https://download.ceph.com/debian-tentacle/ $(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 和 Ubuntu 版本的完整列表,请参阅 测试 Debian 仓库

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

对于主要版本,您可以将 Ceph 条目添加到 /etc/yum.repos.d 目录。创建一个 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'

您可以直接从以下位置下载 RPMs

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。无需手动添加另一个软件包仓库。您可以通过执行以下操作安装 Ceph

sudo yum -y install ceph

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

Ceph 开发软件包

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

DEB 软件包

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

将软件包仓库添加到系统的 APT 源列表中,但将 {BRANCH} 替换为您要使用的分支(例如 wip-hack、master)。有关我们构建的发行版的完整列表,请参阅 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

注意

如果仓库尚未准备就绪,将返回 HTTP 504

在 url 中使用 latest 意味着它将找出已构建的最后一个提交。或者,可以指定特定的 sha1。对于 Ubuntu Xenial 和 Ceph 的 master 分支,它看起来像

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

警告

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

RPM 软件包

对于当前的开发分支,您可以将 Ceph 条目添加到 /etc/yum.repos.d 目录。 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。对于 CentOS 8 和 Ceph 的 master 分支,它看起来像

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

警告

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

注意

如果仓库尚未准备就绪,将返回 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 需要额外的第三方库。要添加 EPEL 仓库,请执行以下操作

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-tentacle/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm'

例如,对于 CentOS 8 (el8)

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

您可以直接从以下位置下载 RPMs

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

对于较早的 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 基金会 资助和托管的社区资源。如果您希望支持这项工作和我们的其他努力,请考虑 立即加入