生产安装

安装生产就绪的 DC/OS

本页概括如何安装 DC/OS 用于生产。使用这种方法，您可以打包 DC/OS 分发并手动连接到每个节点，以运行 DC/OS 安装命令。若要与现有系统集成，或者您没有群集的 SSH 访问权限，则推荐使用这种安装方法。

DC/OS 安装进程需要 bootstrap 节点、管理节点、公共代理节点和专用代理节点。可以查看 节点 文档以了解更多信息。

生产安装流程

安装 DC/OS 群集需要以下步骤：

1. 配置 bootstrap 节点
2. 在管理节点上安装 DC/OS
3. 在代理节点上安装 DC/OS

• bootstrap 节点必须是可从群集节点访问的网络。
• bootstrap 节点必须从群集节点打开 HTTP(S) 端口。

1. 在 bootstrap 节点上创建名为 genconf 的目录，并导航到该目录。

   mkdir -p genconf

存储许可证文件 Enterprise

1. 创建 许可证文件（包含您的授权支持联系人发送的电子邮件中提供的许可文本）并另存为 genconf/license.txt。

创建 IP 检测脚本

在这一步创建 IP 检测脚本。这一脚本报告群集中每个节点的 IP 地址。DC/OS 群集中的每个节点都有一个唯一的 IP 地址，用于在群集中的节点之间进行通信。每次在节点上启动 DC/OS 时，IP 检测脚本都会将节点的唯一 IPv4 地址打印到 STDOUT。

注意：在节点上安装 DC/OS 后，节点的 IP 地址不能更改。例如，当重新启动节点或更新 DHCP 租约时，IP 地址不应更改。如果节点的 IP 地址发生更改，该节点必须卸载。

注意：脚本必须返回 config.yaml 中所指定的相同 IP 地址。例如，如果将 config.yaml 中的专用管理节点 IP 指定为 10.2.30.4，您的脚本在管理节点上运行时应返回相同的值。

1. 为您的环境创建 IP 检测脚本，并另存为 genconf/ip-detect。此脚本需要 UTF-8 编码并具备有效的 shebang) 行。可以使用以下示例。
   • #### 使用 AWS 元数据服务器 此方法使用 AWS 元数据服务获取 IP 地址：

     #!/bin/sh
     # Example ip-detect script using an external authority
     # Uses the AWS Metadata Service to get the node's internal
     # ipv4 address
     curl -fsSL http://169.254.169.254/latest/meta-data/local-ipv4

   • #### 使用 GCE 元数据服务器 此方法使用 GCE 元数据服务器获取 IP 地址：

     #!/bin/sh
     # Example ip-detect script using an external authority
     # Uses the GCE metadata server to get the node's internal
     # ipv4 address
     curl -fsSl -H "Metadata-Flavor: Google" http://169.254.169.254/computeMetadata/v1/instance/network-interfaces/0/ip

   • #### 使用现有接口的 IP 地址 此方法发现节点特定接口的 IP 地址。 如果有带有不同内部 IP 地址的多代硬件，可以在主机之间更改接口名称。IP 检测脚本必须考虑接口名称更改。如果将多个 IP 地址连接到同一个接口，或建立复杂的 Linux 网络等，则也会混淆示例脚本。

     #!/usr/bin/env bash
     set -o nounset -o errexit
     export PATH=/usr/sbin:/usr/bin:$PATH
     echo $(ip addr show eth0 | grep -Eo '[0-9]{1,3}.[0-9]{1,3}.[0-9]{1,3}.[0-9]{1,3}' | head -1)

   • #### 使用 Mesos 管理节点的网络路由 此方法使用 Mesos 管理节点的路由查找源 IP 地址，然后与该节点通信。 在本示例中，我们假设 Mesos 管理节点具有 IP 地址 172.28.128.3。可以在此脚本使用任何语言。Shebang 行必须指向所用语言的相应环境，且输出必须是正确的 IP 地址。 Enterprise

#!/usr/bin/env bash
set -o nounset -o errexit
MASTER_IP=172.28.128.3
echo $(/usr/sbin/ip route show to match 172.28.128.3 | grep -Eo '[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}' | tail -1)

Open Source

#!/usr/bin/env bash
set -o nounset -o errexit -o pipefail
export PATH=/sbin:/usr/sbin:/bin:/usr/bin:$PATH
MASTER_IP=$(dig +short master.mesos || true)
MASTER_IP=${MASTER_IP:-172.28.128.3}
INTERFACE_IP=$(ip r g ${MASTER_IP} | \
awk -v master_ip=${MASTER_IP} '
BEGIN { ec = 1 }
 {
  if($1 == master_ip) {
        print $7
        ec = 0
 } else if($1 == "local") {
        print $6
        ec = 0
 }
      if (ec == 0) exit;
    }
      END { exit ec }
    ')
    echo $INTERFACE_IP

创建故障域检测脚本 Enterprise

DC/OS 群集默认启用 故障域意识，所以必须更改 config.yaml 才能使用此功能。但必须包含名为 fault-domain-detect 故障域检测脚本到您的 ./genconf 目录。要选择禁用故障域感知，请将 fault_domain_enabled 文件中的 config.yaml 参数设置为 false。

1. 创建名为 fault-domain-detect 的故障域检测脚本，在每个节点上运行，以检测节点的故障域。安装过程中此脚本的输出被传递到 Mesos。 脚本输出的推荐格式为：

   {
       "fault_domain": {
           "region": {
               "name": "<region-name>"
           },
           "zone": {
               "name": "<zone-name>"
           }
       }
   }

   我们提供 AWS 和 Azure 节点的故障域检测脚本。对于具有 aws 节点和 azure 节点的群集，可将两者组合为一个脚本。可以使用这些模型为本地群集创建故障域检测脚本。 重要信息：如果在环境中使用代理，此脚本将不起作用。如果使用代理，则必须进行修改。

2. 添加新创建的 fault-domain-detect 脚本到 bootstrap 节点的 /genconf 目录。

创建配置文件

在这一步，可以创建针对您的环境自定义的 YAML 配置文件。DC/OS 在安装期间使用此配置文件生成群集安装文件。

设置超级用户密码 Enterprise

在以下说明中，我们假定您正在使用 ZooKeeper 进行共享存储。

1. 在 bootstrap 节点运行此命令，创建用于超级用户身份认证的散列密码，其中 <superuser_password> 是超级用户密码。
2. 保存散列密码密钥，用于superuser_password_hash 文件中的 config.yaml 参数 。

   sudo bash dcos_generate_config.ee.sh —hash-password <superuser_password>

   以下是散列密码输出的示例。

   Extracting an image from this script and loading it into a docker daemon, can take a few minutes.
   dcos-genconf.9eda4ae45de5488c0c-c40556fa73a00235f1.tar
   Running mesosphere/dcos-genconf docker with BUILD_DIR set to /home/centos/genconf
   00:42:10 dcos_installer.action_lib.prettyprint:: ====> HASHING PASSWORD TO SHA512
   00:42:11 root:: Hashed password for 'password' key:
   $6$rounds=656000$v55tdnlMGNoSEgYH$1JAznj58MR.Bft2wd05KviSUUfZe45nsYsjlEl84w34pp48A9U2GoKzlycm3g6MBmg4cQW9k7iY4tpZdkWy9t1

创建配置

1. 创建配置文件并另存为 genconf/config.yaml。可以使用此模板开始创建。

该开源模板指定三个 Mesos 管理节点、三个用于 Exhibitor 存储的 ZooKeeper 实例、静态管理节点发现列表、Exhibitor 的内部存储后端、一个自定义代理，以及云专用的 DNS 解析器。 Open Source

如果服务器在您的 /etc/resolv.conf 中安装时带有域名，请添加 dns_search 参数。有关参数描述和配置示例，请参阅 文档。

注意：如果 AWS DNS IP 在您的国家/地区不可用，则可以使用本地 DNS 服务器替换 AWS DNS IP 服务器 8.8.8.8 和 8.8.4.4。

注意：如果您指定 master_discovery: static，则还必须创建脚本，以将内部 IP 映射到 bootstrap 节点上的公共 IP（例如，genconf/ip-detect-public）。此脚本然后在 ip_detect_public_filename: "relative-path-from-dcos-generate-config.sh" 中引用。

注意：在 AWS 或任何其他无法控制节点的 IP 地址的环境中，都需要设置master_discovery 才能使用 master_http_load_balancer，并且需要设置负载均衡器。

bootstrap_url: http://<bootstrap_ip>:80
cluster_name: <cluster-name>
superuser_username:
superuser_password_hash:
exhibitor_storage_backend: static
master_discovery: static
ip_detect_public_filename: <relative-path-to-ip-script>
master_list:
<master-private-ip-1>
<master-private-ip-2>
<master-private-ip-3>
resolvers:
169.254.169.253
Choose your security mode: permissive or strict
security: <security-mode>
superuser_password_hash: <hashed-password> # Generated above
superuser_username: <username> # This can be whatever you like
A custom proxy is optional. For details, see the configuration documentation.
use_proxy: 'true'
http_proxy: http://<user>:<pass>@<proxy_host>:<http_proxy_port&gt;
https_proxy: https://<user>:<pass>@<proxy_host>:<https_proxy_port&gt;
no_proxy:
'foo.bar.com'
'.baz.com'
fault_domain_enabled: false
If IPv6 is disabled in your kernel, you must disable it in the config.yaml
enable_ipv6: 'false'

    bootstrap_url: http://<bootstrap_ip>:80
  cluster_name: <cluster-name>
  exhibitor_storage_backend: static
  master_discovery: static
  ip_detect_public_filename:<relative-path-to-ip-script>
  master_list:
<master-private-ip-1>
<master-private-ip-2>
<master-private-ip-3>
resolvers:
169.254.169.253
use_proxy: 'true'
http_proxy: http://<user>:<pass>@<proxy_host>:<http_proxy_port&gt;
https_proxy: https://<user>:<pass>@<proxy_host>:<https_proxy_port&gt;
no_proxy:
'foo.bar.com'
'.baz.com'

    sudo bash dcos_generate_config.ee.sh

    ├── dcos-genconf.c9722490f11019b692-cb6b6ea66f696912b0.tar
├── dcos_generate_config.ee.sh
├── genconf
│ ├── config.yaml
│ ├── ip-detect
│ ├── license.txt

    sudo bash dcos_generate_config.sh

        ├── dcos-genconf.<HASH>.tar
  ├── dcos_generate_config.sh
  ├── genconf
  │ ├── config.yaml
  │ ├── ip-detect