部署本地目录

在本地目录数据中心安装和运行 DC/OS 服务

重要信息:如果您正在使用 DC/OS™ Enterprise,使用 package-registry 无缝管理气隙环境中的包。本地 Catalog 支持已弃用。

您可以通过使用本地 Catalog 在数据中心安装和运行 DC/OS 服务,无需互联网访问。您可以部署包含所有已认证包的本地 Catalog(基础),或包含所选包的本地 Catalog(高级)。

前提条件:

  • 已安装 DC/OS CLI

  • 登录到 DC/OS CLI。在 DC/OS Enterprise 上,您必须以具有 dcos:superuser 权限的用户登录。

注意:由于 Catalog tarball 大小超过 2 GB,将其下载到您的本地驱动器,并将其上传到每个管理节点可能需要一些时间。

认证 Catalog 包

本节介绍如何部署包含已认证 Catalog 包的本地 Catalog。

  1. 从终端提示符中,使用以下命令将本地 Catalog 及其服务定义下载到您的本地驱动器。

    curl -v https://s3.amazonaws.com/downloads.mesosphere.io/universe/public/local-universe.tar.gz -o local-universe.tar.gz
    curl -v https://raw.githubusercontent.com/mesosphere/universe/version-3.x/docker/local-universe/dcos-local-universe-http.service -o dcos-local-universe-http.service
    curl -v https://raw.githubusercontent.com/mesosphere/universe/version-3.x/docker/local-universe/dcos-local-universe-registry.service -o dcos-local-universe-registry.service
    
  2. 使用 安全副本 (scp) 将 Catalog 和注册表文件传输到管理节点,在发出以下命令之前将 <master-IP> 替换为管理节点的公共 IP 地址。(您可以在 DC/OS UI 的左上角找到管理节点的公用 IP 地址。)

    scp local-universe.tar.gz core@<master-IP>:~
    scp dcos-local-universe-http.service core@<master-IP>:~
    scp dcos-local-universe-registry.service core@<master-IP>:~
    
  3. 使用以下命令 SSH 至管理节点。将 <master-IP> 替换为先前命令中使用的 IP 地址。

    ssh -A core@<master-IP>
    
  4. 确认文件已成功复制。

    ls
    

您应该看到以下列出的文件。

```text
dcos-local-universe-http.service  
dcos-local-universe-registry.service  
local-universe.tar.gz
```
  1. 将注册表文件移动到 /etc/systemd/system/ 目录。

    sudo mv dcos-local-universe-registry.service /etc/systemd/system/
    sudo mv dcos-local-universe-http.service /etc/systemd/system/
    
  2. 确认文件已成功复制到 /etc/systemd/system/

    ls -la /etc/systemd/system/dcos-local-universe-*
    
  3. 将 Catalog 加载到本地 Docker® 实例中。这可能需要一些时间才能完成。

    sudo docker load < local-universe.tar.gz
    
  4. 重新启动 systemd 守护程序。

    sudo systemctl daemon-reload
    
  5. 启用并启动 dcos-local-universe-httpdcos-local-universe-registry 服务。

    sudo systemctl enable dcos-local-universe-http
    sudo systemctl enable dcos-local-universe-registry
    sudo systemctl start dcos-local-universe-http
    sudo systemctl start dcos-local-universe-registry
    
  6. 使用以下命令确认服务现已启动和运行。

    sudo systemctl status dcos-local-universe-http
    sudo systemctl status dcos-local-universe-registry
    

##配置多个管理节点

如果您只有一个管理节点,跳转到下面 将本地 Catalog 链接到管理节点。如果您有多个管理节点,请继续执行以下程序。

  1. 使用以下命令发现所有管理节点的私有 IP 地址。识别现在从列表中通过 SSH 所进入的管理节点的私有 IP 地址。它将与在您的提示中 core@ip- 之后显示的路径匹配,其中连字符变为句号。

    host master.mesos
    
  2. 使用 安全副本 将 Catalog 和注册表文件传输到其他管理节点之一。将 <master-IP> 替换为另一个管理节点的 IP 地址。

    scp local-universe.tar.gz core@<master-IP>:~
    scp /etc/systemd/system/dcos-local-universe-registry.service core@<master-IP>:~
    scp /etc/systemd/system/dcos-local-universe-http.service core@<master-IP>:~
    
  3. SSH 至收到这些复制文件的管理节点中

    ssh -A core@<master_IP>
    
  4. 确认文件已成功复制。

    ls
    

您应该看到以下列出的文件。

```text
dcos-local-universe-http.service  dcos-local-universe-registry.service  local-universe.tar.gz
```
  1. 将注册表文件移动到 /etc/systemd/system/ 目录。

    sudo mv dcos-local-universe-registry.service /etc/systemd/system/
    sudo mv dcos-local-universe-http.service /etc/systemd/system/
    
  2. 确认文件已成功复制到 /etc/systemd/system/

    ls -la /etc/systemd/system/dcos-local-universe-*
    
  3. 将 Catalog 加载到本地 Docker 实例中。这可能需要一些时间才能完成。

    sudo docker load < local-universe.tar.gz
    
  4. 重新启动 Docker 守护程序。

    sudo systemctl daemon-reload
    
  5. 启动 dcos-local-universe-httpdcos-local-universe-registry 服务。

    sudo systemctl start dcos-local-universe-http
    sudo systemctl start dcos-local-universe-registry
    
  6. 确认服务现已启动和运行。

    sudo systemctl status dcos-local-universe-http
    sudo systemctl status dcos-local-universe-registry
    

重复本部分操作,直到对所有管理节点完成这一程序。然后继续执行下面的将本地 Catalog 链接到管理节点部分。

将本地 Catalog 链接到管理节点

  1. 通过键入 exit 或打开新终端提示关闭 SSH 会话。如果有多个管理节点,您可能必须退出多个 SSH 会话。

  2. (可选)使用以下命令删除群集对默认 Catalog 的引用。如果要将默认 Catalog 保留在适当位置,只需将本地 Catalog 添加为附加存储库,跳至下一步。您还可以从 DC/OS Web 界面中的 设置 > 包存储库 中删除对默认 Catalog 存储库的引用。

    dcos package repo remove Catalog
    
  1. 使用以下命令添加对您已添加到每个管理节点的本地 Catalog 的引用。

    dcos package repo add local-Catalog http://master.mesos:8082/repo
    
  2. SSH 至您的代理节点之一。

    dcos node ssh --master-proxy --mesos-id=<mesos-id>
    
  3. 使用以下命令下载 DC/OS 证书副本到本地,并将其设置为可信任。

    sudo mkdir -p /etc/docker/certs.d/master.mesos:5000
    sudo curl -o /etc/docker/certs.d/master.mesos:5000/ca.crt http://master.mesos:8082/certs/domain.crt
    sudo systemctl restart docker
    
  4. 配置 Apache® Mesos® 提取程序以信任下载的 Docker 证书。

  • 复制证书:
    sudo cp /etc/docker/certs.d/master.mesos:5000/ca.crt /var/lib/dcos/pki/tls/certs/docker-registry-ca.crt
    
  • 生成哈希值:
    cd /var/lib/dcos/pki/tls/certs/
    openssl x509 -hash -noout -in docker-registry-ca.crt
    
  • 创建软链接。您需要在公共代理创建 /pki/tls/certs 目录。
    sudo ln -s /var/lib/dcos/pki/tls/certs/docker-registry-ca.crt /var/lib/dcos/pki/tls/certs/<hash_number>.0
    
  1. 通过键入 exit 或打开新终端提示关闭 SSH 会话。在每个代理节点上重复这些步骤。
  2. 要验证操作成功,登录 DC/OS Web 界面,单击 Catalog 选项卡。您会看到已认证包列表。安装其中一个包。

常见问题

  • 我无法安装 CLI 子命令

包托管于 master.mesos:8082。如果您无法从您的 DC/OS CLI 安装解析或连接到 master.mesos:8082,您无法安装 CLI 子命令。如果您可以在管理节点上连接到端口 8082,将其中一个管理节点 IP 添加到 /etc/hosts

  • 镜像破损

所有 Catalog 组件都托管在您的群集中,包括镜像。组件由 master.mesos:8082提供。如果您已经连接到该 IP,您可以将其添加到 /etc/hosts 并让镜像工作。

  • 我没有看到我在找的包

默认情况下,仅捆绑已认证的包。如果您想获得其他包,请参阅下一节中的说明。

选定的包

先决条件: Git。在 UNIX®/Linux® 上,查看这些 安装说明

要部署包含您自己的包集合的本地 Catalog,必须构建自定义本地 Catalog Docker 镜像。

  1. 克隆 Catalog 存储库:

    git clone https://github.com/mesosphere/universe.git --branch version-3.x
    
  2. 构建 universe-base 镜像:

    cd universe/docker/local-universe/
    sudo make base
    
  3. 构建 mesosphere/universe Docker 镜像并将其压缩至 local-universe.tar.gz 文件。使用 DCOS_PACKAGE_INCLUDE 变量指定逗号分隔的包名和版本列表。要最大程度地减少容器尺寸和下载时间,您可以仅选择所需的内容。如果您不使用 DCOS_PACKAGE_INCLUDE 变量,所有已认证 Catalog 包都会 。要查看哪些包已获得认证,单击 DC/OS Web 界面中的 目录 选项卡。

    sudo make DCOS_VERSION=1.13 DCOS_PACKAGE_INCLUDE="cassandra:1.0.25-3.0.10,marathon:1.4.2" local-universe
    
  4. 执行 已认证 Catalog 包 中描述的所有步骤。