使用负载平衡器配置 Capsule

Red Hat Satellite 6.11

在 Capsule 服务器间分布负载

Red Hat Satellite Documentation Team

摘要

本指南介绍了如何将 Red Hat Satellite 配置为使用负载平衡器在 Capsule 服务器之间分发负载。

第 1 章 负载均衡解决方案架构

您可以将 Satellite 服务器配置为使用负载平衡器在多个 Capsule 服务器之间分发客户端请求和网络负载。这会提高 Capsule 服务器上的整体性能。

本指南概述了如何为负载平衡准备 Satellite 服务器和 Capsule 服务器的指南，并提供了有关如何配置负载平衡器并在负载平衡设置中注册客户端的指南。

负载均衡设置由以下组件组成：

  • Satellite Server
  • 两个或多个 Capsule 服务器
  • 一个负载均衡器
  • 多个客户端

图 1.1. Satellite 负载均衡解决方案架构

负载均衡解决方案架构

在负载平衡设置中，在计划或计划维护时，几乎所有 Capsule 功能都会继续按预期工作。负载均衡器可用于以下服务和功能：

  • 使用 subscription-manager注册
  • 使用 yum 软件仓库进行内容管理
  • 可选： Puppet
注意

在负载均衡设置中，负载均衡器只针对上述服务和功能分发负载。如果其他服务（如 provisioning 或 virt-who）在单独的 Capsule 上运行，您必须直接通过 Capsule 访问这些服务，而不是通过负载均衡器访问。

管理 Puppet 限制

Puppet 证书颁发机构(CA)管理不支持负载均衡设置中的证书签名请求。Puppet CA 在文件系统中存储证书信息，如序列号计数器和 CRL。尝试使用相同数据的多个写入器进程可能会破坏它。

要管理此 Puppet 限制，请完成以下步骤：

  1. 在一个 Capsule 服务器上配置 Puppet 证书签名请求，通常是配置胶囊式服务器以进行负载平衡的第一个系统。
  2. 配置客户端，将 CA 请求发送到负载均衡器上的端口 8141。
  3. 配置负载均衡器，将来自端口 8141 的 CA 请求重定向到您将 Capsule 服务器配置为签署 Puppet 证书的系统上的端口 8140。

第 2 章 负载均衡注意事项

在多个 Capsule 服务器间分布负载可防止任何一个 Capsule 成为单点故障。配置 Capsule 以使用负载均衡器可为计划和计划外的中断提供弹性。这提高了可用性和响应性。

在配置负载均衡时请考虑以下准则：

  • 如果使用 Puppet，则 Puppet 证书签名请求会被分配给您配置的第一个 Capsule。如果第一个 Capsule 停机，客户端将无法获取 Puppet 内容。
  • 这个解决方案不使用 Pacemaker 或其他类似的 HA 工具在所有 Capsule 中维护一个状态。要排除问题，请重复每个 Capsule 上的问题，绕过负载平衡器。

负载均衡需要额外的维护

配置 Capsule 以使用负载平衡器会导致更复杂的环境，并需要额外的维护。

负载均衡需要以下额外步骤：

  • 您必须确保所有 Capsule 都具有相同的内容视图，并将所有 Capsule 同步到相同的内容视图版本
  • 您必须按顺序升级每个 Capsule
  • 您必须定期备份配置的每个 Capsule

在负载均衡配置中升级 Capsule 服务器

要将 Capsule 服务器从 6.10 升级到 6.11，请完成升级和更新 Red Hat Satellite 中的 升级 Capsule 服务器 流程。在负载平衡配置中，Capsule 服务器不需要额外的步骤。

第 3 章 为负载均衡配置 Capsule 服务器的先决条件

要为负载平衡配置 Capsule 服务器，请完成以下步骤，请参阅安装 Capsule 服务器。Satellite 不支持配置现有的 Capsule 服务器进行负载平衡。

  1. 将 Capsule 服务器注册到 Satellite 服务器
  2. 附加 Satellite 基础架构订阅
  3. 配置软件仓库
  4. 使用 chronyd 同步系统时钟
  5. 安装 Capsule 服务器软件包

第 4 章 为负载均衡配置 Capsule 服务器

本章概述了如何配置胶囊式服务器以进行负载平衡。根据您的 Satellite 服务器配置，继续以下部分之一：

  1. 第 4.1 节 “在没有 Puppet 的情况下为负载均衡配置带有默认 SSL 证书的 Capsule 服务器”
  2. 第 4.2 节 “使用 Puppet 为负载均衡配置具有默认 SSL 证书的 Capsule 服务器”
  3. 第 4.3 节 “在没有 Puppet 的情况下为负载均衡配置带有自定义 SSL 证书的 Capsule 服务器”
  4. 第 4.4 节 “使用 Puppet 为负载均衡配置带有自定义 SSL 证书的 Capsule 服务器”

对您为每个 Capsule 服务器创建的 Katello 证书使用不同的文件名。例如，使用 Capsule 服务器 FQDN 为证书归档文件命名。

4.1. 在没有 Puppet 的情况下为负载均衡配置带有默认 SSL 证书的 Capsule 服务器

下面的部分论述了如何配置使用默认 SSL 证书进行负载平衡的 Capsule 服务器，而无需 Puppet。

在您要配置用于负载平衡的每个 Capsule 服务器上完成这个步骤。

流程

  1. 在 Satellite 服务器上，为 Capsule 服务器生成 Katello 证书，例如： 

    # capsule-certs-generate \
--foreman-proxy-fqdn capsule.example.com \
--certs-tar "/root/capsule.example.com-certs.tar" \
--foreman-proxy-cname loadbalancer.example.com

    为安装 Capsule 服务器证书保留示例 satellite - installer 命令的副本，该命令由其输出。

  2. 将证书存档文件从 Satellite 服务器复制到 Capsule 服务器。 

    # scp /root/capsule.example.com-certs.tar \
root@capsule.example.com:/root/capsule.example.com-certs.tar

  3. 在 satellite-installer 命令中获取的 satellite-installer 命令中附加以下选项，该命令从 the thecerts-generate 命令的输出中获取。 

    --certs-cname "loadbalancer.example.com" \
--enable-foreman-proxy-plugin-remote-execution-ssh

  4. 在 Capsule 服务器上，输入 satellite-installer 命令，例如： 

    # satellite-installer --scenario capsule \
--foreman-proxy-register-in-foreman "true" \
--foreman-proxy-foreman-base-url "https://satellite.example.com" \
--foreman-proxy-trusted-hosts "satellite.example.com" \
--foreman-proxy-trusted-hosts "capsule.example.com" \
--foreman-proxy-oauth-consumer-key "oauth key" \
--foreman-proxy-oauth-consumer-secret "oauth secret" \
--certs-tar-file "capsule.example.com-certs.tar" \
--certs-cname "loadbalancer.example.com" \
--enable-foreman-proxy-plugin-remote-execution-ssh

4.2. 使用 Puppet 为负载均衡配置具有默认 SSL 证书的 Capsule 服务器

下面的部分论述了如何配置使用默认 SSL 证书通过 Puppet 进行负载均衡的 Capsule 服务器。

如果在 Satellite 配置中使用 Puppet，您必须完成以下步骤：

  1. 配置 Capsule 服务器以生成和签名 Puppet 证书
  2. 为负载均衡配置剩余 Capsule 服务器

配置 Capsule 服务器以生成和签名 Puppet 证书

仅对您要配置 Capsule 服务器的系统完成此流程，以为您配置用于负载平衡的所有其他 Capsule 服务器生成和签署 Puppet 证书。在此流程示例中，此 Capsule 服务器的 FQDN 是 evince -ca.example.com。

  1. 在 Satellite 服务器上，为配置 Capsule 服务器以生成和签署 Puppet 证书的系统生成 Katello 证书： 

    # capsule-certs-generate \
--foreman-proxy-fqdn capsule-ca.example.com \
--certs-tar "/root/capsule-ca.example.com-certs.tar" \
--foreman-proxy-cname loadbalancer.example.com

    为安装 Capsule 服务器证书保留示例 satellite - installer 命令的副本，该命令由其输出。

  2. 将证书存档文件从 Satellite 服务器复制到 Capsule 服务器： 

    # scp /root/capsule-ca.example.com-certs.tar \
root@capsule-ca.example.com:capsule-ca.example.com-certs.tar

  3. 在 satellite-installer 命令中获取的 satellite - installer 命令中附加以下选项： 

    --certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "true" \
--puppet-server-ca "true" \
--enable-foreman-proxy-plugin-remote-execution-ssh

  4. 在 Capsule 服务器上，输入 satellite-installer 命令，例如： 

    # satellite-installer --scenario capsule \
--foreman-proxy-register-in-foreman "true" \
--foreman-proxy-foreman-base-url "https://satellite.example.com" \
--foreman-proxy-trusted-hosts "satellite.example.com" \
--foreman-proxy-trusted-hosts "capsule-ca.example.com" \
--foreman-proxy-oauth-consumer-key "oauth key" \
--foreman-proxy-oauth-consumer-secret "oauth secret" \
--certs-tar-file "capsule-ca.example.com-certs.tar" \
--puppet-server-foreman-url "https://satellite.example.com" \
--certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "true" \
--puppet-server-ca "true" \
--enable-foreman-proxy-plugin-remote-execution-script \
--foreman-proxy-content-puppet true \
--enable-puppet \
--puppet-server true \
--puppet-server-foreman-ssl-ca /etc/pki/katello/puppet/puppet_client_ca.crt \
--puppet-server-foreman-ssl-cert /etc/pki/katello/puppet/puppet_client.crt \
--puppet-server-foreman-ssl-key /etc/pki/katello/puppet/puppet_client.key

  5. 在 Capsule 服务器上，停止 Puppet 服务器： 

    # puppet resource service puppetserver ensure=stopped

  6. 为您配置的所有其他 Capsule 服务器生成 Puppet 证书，但您配置 Puppet 证书的第一个系统除外： 

    # puppetserver ca generate --certname capsule.example.com \
--subject-alt-names loadbalancer.example.com --ca-client

    此命令在将 Capsule 服务器配置为为 Puppet 证书签名的系统中创建以下文件：

    • /etc/puppetlabs/puppet/ssl/certs/ca.pem
    • /etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem
    • /etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem
    • /etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem

  7. 恢复 Puppet 服务器： 

    # puppet resource service puppetserver ensure=running

为负载均衡配置剩余 Capsule 服务器

在每个胶囊式服务器上完成此流程，不包括您配置 Capsule 服务器以签署 Puppet 证书的系统。

  1. 在 Satellite 服务器上，为 Capsule 服务器生成 Katello 证书： 

    # capsule-certs-generate \
--foreman-proxy-fqdn capsule.example.com \
--certs-tar "/root/capsule.example.com-certs.tar" \
--foreman-proxy-cname loadbalancer.example.com

    为安装 Capsule 服务器证书保留示例 satellite - installer 命令的副本，该命令由其输出。

  2. 将证书存档文件从 Satellite 服务器复制到 Capsule 服务器： 

    # scp /root/capsule.example.com-certs.tar \
root@capsule.example.com:/root/capsule.example.com-certs.tar

  3. 在 Capsule 服务器上安装 puppetserver 软件包： 

    # satellite-maintain packages install puppetserver

  4. 在 Capsule 服务器上，为 puppet 证书创建目录： 

    # mkdir -p /etc/puppetlabs/puppet/ssl/certs/ \
/etc/puppetlabs/puppet/ssl/private_keys/ \
/etc/puppetlabs/puppet/ssl/public_keys/

  5. 在 Capsule 服务器上，从您配置 Capsule 服务器的系统中复制此 Capsule 服务器的 Puppet 证书，以签署 Puppet 证书： 

    # scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/certs/ca.pem \
/etc/puppetlabs/puppet/ssl/certs/ca.pem
# scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem \
/etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem
# scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem \
/etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem
# scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem \
/etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem

  6. 在 Capsule 服务器上，将目录所有权改为 user puppet、group puppet 并设置 SELinux 上下文： 

    # chown -R puppet:puppet /etc/puppetlabs/puppet/ssl/
# restorecon -Rv /etc/puppetlabs/puppet/ssl/

  7. 在 satellite-installer 命令中获取的 satellite - installer 命令中附加以下选项： 

    --certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "false" \
--puppet-server-ca "false" \
--enable-foreman-proxy-plugin-remote-execution-ssh

  8. 在 Capsule 服务器上，输入 satellite-installer 命令，例如： 

    # satellite-installer --scenario capsule \
--foreman-proxy-register-in-foreman "true" \
--foreman-proxy-foreman-base-url "https://satellite.example.com" \
--foreman-proxy-trusted-hosts "satellite.example.com" \
--foreman-proxy-trusted-hosts "capsule.example.com" \
--foreman-proxy-oauth-consumer-key "oauth key" \
--foreman-proxy-oauth-consumer-secret "oauth secret" \
--certs-tar-file "capsule.example.com-certs.tar" \
--puppet-server-foreman-url "https://satellite.example.com" \
--certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "false" \
--puppet-server-ca "false" \
--enable-foreman-proxy-plugin-remote-execution-ssh

4.3. 在没有 Puppet 的情况下为负载均衡配置带有自定义 SSL 证书的 Capsule 服务器

下面的部分论述了如何配置使用自定义 SSL 证书进行负载平衡的 Capsule 服务器，而无需 Puppet。

4.3.1. 为 Capsule 服务器创建自定义 SSL 证书

此流程概述了如何为证书签名请求创建配置文件，并将负载均衡器和 Capsule 服务器用作主题备用名称(SAN)。在您要配置用于负载平衡的每个 Capsule 服务器上完成这个步骤。

流程

  1. 在 Capsule 服务器上，创建一个目录来包含所有源证书文件，只能通过 root 用户访问： 

    # mkdir /root/capsule_cert
# cd /root/capsule_cert

  2. 创建为证书签名请求(CSR)签名的私钥。

    请注意，私钥必须是未加密的。如果您使用密码保护的私钥，请删除私钥密码。

    如果您已拥有此 Capsule 服务器的私钥，请跳过这一步。 

    # openssl genrsa -out /root/capsule_cert/capsule_cert_key.pem 4096

  3. 使用以下内容创建证书请求配置文件： 

    [ req ]
default_bits       = 4096
distinguished_name = req_distinguished_name
req_extensions     = req_ext
prompt = no

[ req_distinguished_name ]
countryName=2 Letter Country Code
stateOrProvinceName=State or Province Full Name
localityName=Locality Name
0.organizationName=Organization Name
organizationalUnitName=Capsule Organization Unit Name
commonName=capsule.example.com  1
emailAddress=Email Address

[ req_ext ]
#authorityKeyIdentifier=keyid,issuer
#basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names

[alt_names]                  2
DNS.1 = loadbalancer.example.com
DNS.2 = capsule.example.com
    1
    证书的通用名称必须与 Capsule 服务器的 FQDN 匹配。在为负载平衡配置的每个 Capsule 服务器上运行命令时，请确保更改此设置。您还可以设置通配符值 sVirt。如果设置通配符值，您必须在使用 katello-certs-check 命令时添加 -t capsule 选项。
    2
    在 [alt_names] 下，将负载均衡器的 FQDN 作为 DNS.1 和 Capsule 服务器的 FQDN 作为 DNS.2。

  4. 为 SAN 证书创建证书签名请求(CSR)。 

    # openssl req -new \
-key /root/capsule_cert/capsule_cert_key.pem \ 1
-config SAN_config.cfg \                   2
-out /root/capsule_cert/capsule_cert_csr.pem   3
    1
    Capsule 服务器的私钥，用于签署证书
    2
    证书请求配置文件
    3
    证书签名请求文件

  5. 将证书请求发送到证书颁发机构：

    当您提交请求时，指定证书的 Lifespan。发送证书请求的方法会有所不同，因此请参阅证书颁发机构以获取首选方法。根据请求，您可以在单独的文件中接收证书颁发机构捆绑包和签名证书。

  6. 将您从证书颁发机构接收的证书颁发机构捆绑包和 Capsule 服务器证书文件复制到 Satellite 服务器。

  7. 在 Satellite 服务器上，验证 Capsule 服务器证书输入文件： 

    # katello-certs-check \
-c /root/capsule_cert/capsule_cert.pem \      1
-k /root/capsule_cert/capsule_cert_key.pem \  2
-b /root/capsule_cert/ca_cert_bundle.pem      3
    1
    由您的证书颁发机构提供的 Capsule 服务器证书文件
    2
    用于为证书签名的 Capsule 服务器的私钥
    3
    证书颁发机构捆绑包，由您的证书颁发机构提供

    如果将 commonName= 设置为通配符值，您必须将 -t\":\" 选项添加到 katello-certs-check 命令中。

    保留由 katello -certs-check 命令创建证书归档文件（用于为此 Capsule 服务器创建证书归档文件）输出的示例，example-certs-generate 命令的副本。

4.3.2. 在没有 Puppet 的情况下为负载均衡配置带有自定义 SSL 证书的 Capsule 服务器

在您要配置用于负载平衡的每个 Capsule 服务器上完成这个步骤。

流程

  1. 将以下选项附加到从 katello -certs-check 命令的输出中获取的 evince-certs-generate 命令中： 

    --foreman-proxy-cname loadbalancer.example.com

  2. 在 Satellite 服务器上，输入 evince-certs-generate 命令来生成 Capsule 证书。例如： 

    # capsule-certs-generate \
--foreman-proxy-fqdn capsule.example.com \
--certs-tar /root/capsule_cert/capsule.tar \
--server-cert /root/capsule_cert/capsule.pem \
--server-key /root/capsule_cert/capsule.pem \
--server-ca-cert /root/capsule_cert/ca_cert_bundle.pem \
--foreman-proxy-cname loadbalancer.example.com

    为安装 Capsule 服务器证书的输出保留 satellite-installer 命令示例副本。

  3. 将证书存档文件从 Satellite 服务器复制到 Capsule 服务器： 

    # scp /root/capsule.example.com-certs.tar \
root@capsule.example.com:capsule.example.com-certs.tar

  4. 在 satellite-installer 命令中获取的 satellite-installer 命令中附加以下选项，该命令从 the thecerts-generate 命令的输出中获取。 

    --certs-cname "loadbalancer.example.com" \
--enable-foreman-proxy-plugin-remote-execution-ssh

  5. 在 Capsule 服务器上，输入 satellite-installer 命令，例如： 

    # satellite-installer --scenario capsule \
--foreman-proxy-register-in-foreman "true" \
--foreman-proxy-foreman-base-url "https://satellite.example.com" \
--foreman-proxy-trusted-hosts "satellite.example.com" \
--foreman-proxy-trusted-hosts "capsule.example.com" \
--foreman-proxy-oauth-consumer-key "oauth key" \
--foreman-proxy-oauth-consumer-secret "oauth secret" \
--certs-tar-file "capsule.example.com-certs.tar" \
--certs-cname "loadbalancer.example.com" \
--enable-foreman-proxy-plugin-remote-execution-ssh

4.4. 使用 Puppet 为负载均衡配置带有自定义 SSL 证书的 Capsule 服务器

下面的部分论述了如何配置使用自定义 SSL 证书通过 Puppet 进行负载平衡的 Capsule 服务器。

4.4.1. 为 Capsule 服务器创建自定义 SSL 证书

此流程概述了如何为证书签名请求创建配置文件，并将负载均衡器和 Capsule 服务器用作主题备用名称(SAN)。在您要配置用于负载平衡的每个 Capsule 服务器上完成这个步骤。

流程

  1. 在 Capsule 服务器上，创建一个目录来包含所有源证书文件，只能通过 root 用户访问： 

    # mkdir /root/capsule_cert
# cd /root/capsule_cert

  2. 创建为证书签名请求(CSR)签名的私钥。

    请注意，私钥必须是未加密的。如果您使用密码保护的私钥，请删除私钥密码。

    如果您已拥有此 Capsule 服务器的私钥，请跳过这一步。 

    # openssl genrsa -out /root/capsule_cert/capsule.pem 4096

  3. 使用以下内容创建证书请求配置文件： 

    [ req ]
default_bits       = 4096
distinguished_name = req_distinguished_name
req_extensions     = req_ext
prompt = no

[ req_distinguished_name ]
countryName=2 Letter Country Code
stateOrProvinceName=State or Province Full Name
localityName=Locality Name
0.organizationName=Organization Name
organizationalUnitName=Capsule Organization Unit Name
commonName=capsule.example.com  1
emailAddress=Email Address

[ req_ext ]
#authorityKeyIdentifier=keyid,issuer
#basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names

[alt_names]                  2
DNS.1 = loadbalancer.example.com
DNS.2 = capsule.example.com
    1
    证书的通用名称必须与 Capsule 服务器的 FQDN 匹配。确保在每个 Capsule 服务器上运行命令时更改此设置。您还可以设置通配符值 sVirt。如果设置通配符值，您必须在使用 katello-certs-check 命令时添加 -t capsule 选项。
    2
    在 [alt_names] 下，将负载均衡器的 FQDN 作为 DNS.1 和 Capsule 服务器的 FQDN 作为 DNS.2。

  4. 为 SAN 证书创建证书签名请求(CSR)： 

    # openssl req -new \
-key /root/capsule_cert/capsule.pem \ 1
-config SAN_config.cfg \          2
-out /root/capsule_cert/capsule.pem   3
    1
    Capsule 服务器的私钥，用于签署证书
    2
    证书请求配置文件
    3
    证书签名请求文件

  5. 将证书请求发送到证书颁发机构：

    当您提交请求时，指定证书的 Lifespan。发送证书请求的方法会有所不同，因此请参阅证书颁发机构以获取首选方法。根据请求，您可以在单独的文件中接收证书颁发机构捆绑包和签名证书。

  6. 将您从证书颁发机构接收的证书颁发机构捆绑包和 Capsule 服务器证书文件复制到 Satellite 服务器，以将 Capsule 服务器私钥复制到 Satellite 服务器以验证它们。

  7. 在 Satellite 服务器上，验证 Capsule 服务器证书输入文件： 

    # katello-certs-check \
-c /root/capsule_cert/capsule.pem \      1
-k /root/capsule_cert/capsule.pem \      2
-b /root/capsule_cert/ca_cert_bundle.pem 3
    1
    由您的证书颁发机构提供的 Capsule 服务器证书文件
    2
    用于为证书签名的 Capsule 服务器的私钥
    3
    证书颁发机构捆绑包，由您的证书颁发机构提供

    如果将 commonName= 设置为通配符值，您必须将 -t\":\" 选项添加到 katello-certs-check 命令中。

    保留由 katello -certs-check 命令创建证书归档文件（用于为此 Capsule 服务器创建证书归档文件）输出的示例，example-certs-generate 命令的副本。

4.4.2. 使用 Puppet 为负载均衡配置带有自定义 SSL 证书的 Capsule 服务器

如果您在 Satellite 配置中使用 Puppet，则必须完成以下步骤：

  1. 配置 Capsule 服务器以生成和签名 Puppet 证书
  2. 为负载均衡配置剩余 Capsule 服务器

配置 Capsule 服务器以生成和签名 Puppet 证书

仅对您要配置 Capsule 服务器的系统完成此步骤，以为您配置用于负载平衡的所有其他 Capsule 服务器生成 Puppet 证书。在此流程示例中，此 Capsule 服务器的 FQDN 是 evince -ca.example.com。

  1. 将以下选项附加到从 katello -certs-check 命令的输出中获取的 evince-certs-generate 命令中： 

    --foreman-proxy-cname loadbalancer.example.com

  2. 在 Satellite 服务器上，输入 evince-certs-generate 命令来生成 Capsule 证书。例如： 

    # capsule-certs-generate \
--foreman-proxy-fqdn capsule-ca.example.com \
--certs-tar /root/capsule_cert/capsule-ca.tar \
--server-cert /root/capsule_cert/capsule-ca.pem \
--server-key /root/capsule_cert/capsule-ca.pem \
--server-ca-cert /root/capsule_cert/ca_cert_bundle.pem \
--foreman-proxy-cname loadbalancer.example.com

    为安装 Capsule 服务器证书的输出保留 satellite-installer 命令示例副本。

  3. 将证书存档文件从 Satellite 服务器复制到 Capsule 服务器。

  4. 在 satellite-installer 命令中获取的 satellite - installer 命令中附加以下选项： 

    --puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "true" \
--puppet-server-ca "true" \
--enable-foreman-proxy-plugin-remote-execution-ssh

  5. 在 Capsule 服务器上，输入 satellite-installer 命令，例如： 

    satellite-installer --scenario capsule \
--foreman-proxy-register-in-foreman "true" \
--foreman-proxy-foreman-base-url "https://satellite.example.com" \
--foreman-proxy-trusted-hosts "satellite.example.com" \
--foreman-proxy-trusted-hosts "capsule-ca.example.com" \
--foreman-proxy-oauth-consumer-key "oauth key" \
--foreman-proxy-oauth-consumer-secret "oauth secret" \
--certs-tar-file "certs.tgz" \
--puppet-server-foreman-url "https://satellite.example.com" \
--certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "true" \
--puppet-server-ca "true" \
--enable-foreman-proxy-plugin-remote-execution-script \
--foreman-proxy-content-puppet true \
--enable-puppet \
--puppet-server true \
--puppet-server-foreman-ssl-ca /etc/pki/katello/puppet/puppet_client_ca.crt \
--puppet-server-foreman-ssl-cert /etc/pki/katello/puppet/puppet_client.crt \
--puppet-server-foreman-ssl-key /etc/pki/katello/puppet/puppet_client.key

  6. 在 Capsule 服务器上，为您配置用于负载平衡的所有其他 Capsule 生成 Puppet 证书，但这是配置 Puppet 证书签名请求的第一个系统： 

    # puppet cert generate capsule.example.com \
--dns_alt_names=loadbalancer.example.com

    此命令在 Puppet 证书签名请求上创建以下文件：

    • /etc/puppetlabs/puppet/ssl/certs/ca.pem
    • /etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem
    • /etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem
    • /etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem

为负载均衡配置剩余 Capsule 服务器

为每个 Capsule 服务器完成此流程，但不包括您配置 Capsule 服务器以签署 Puppet 证书的系统。

  1. 将以下选项附加到从 katello -certs-check 命令的输出中获取的 evince-certs-generate 命令中： 

    --foreman-proxy-cname loadbalancer.example.com

  2. 在 Satellite 服务器上，输入 evince-certs-generate 命令来生成 Capsule 证书。例如： 

    # capsule-certs-generate \
--foreman-proxy-fqdn capsule.example.com \
--certs-tar /root/capsule_cert/capsule.tar \
--server-cert /root/capsule_cert/capsule.pem \
--server-key /root/capsule_cert/capsule.pem \
--server-ca-cert /root/capsule_cert/ca_cert_bundle.pem \
--foreman-proxy-cname loadbalancer.example.com

    为安装 Capsule 服务器证书的输出保留 satellite-installer 命令示例副本。

  3. 将证书存档文件从 Satellite 服务器复制到 Capsule 服务器。 

    # scp /root/capsule.example.com-certs.tar \
root@capsule.example.com:capsule.example.com-certs.tar

  4. 在 Capsule 服务器上安装 puppetserver 软件包： 

    # satellite-maintain packages install puppetserver

  5. 在 Capsule 服务器上，为 puppet 证书创建目录： 

    # mkdir -p /etc/puppetlabs/puppet/ssl/certs/ \
/etc/puppetlabs/puppet/ssl/private_keys/ \
/etc/puppetlabs/puppet/ssl/public_keys/

  6. 在 Capsule 服务器上，从您配置 Capsule 服务器的系统中复制此 Capsule 服务器的 Puppet 证书，以签署 Puppet 证书： 

    # scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/certs/ca.pem \
/etc/puppetlabs/puppet/ssl/certs/ca.pem
# scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem \
/etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem
# scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem \
/etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem
# scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem \
/etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem

  7. 在 Capsule 服务器上，将目录所有权改为 user puppet、group puppet 并设置 SELinux 上下文： 

    # chown -R puppet:puppet /etc/puppetlabs/puppet/ssl/
# restorecon -Rv /etc/puppetlabs/puppet/ssl/

  8. 在 satellite-installer 命令中获取的 satellite - installer 命令中附加以下选项： 

    --certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "false" \
--puppet-server-ca "false" \
--enable-foreman-proxy-plugin-remote-execution-ssh

  9. 在 Capsule 服务器上，输入 satellite-installer 命令，例如： 

    # satellite-installer --scenario capsule \
--foreman-proxy-register-in-foreman "true" \
--foreman-proxy-foreman-base-url "https://satellite.example.com" \
--foreman-proxy-trusted-hosts "satellite.example.com" \
--foreman-proxy-trusted-hosts "capsule.example.com" \
--foreman-proxy-oauth-consumer-key "oauth key" \
--foreman-proxy-oauth-consumer-secret "oauth secret" \
--certs-tar-file "capsule.example.com-certs.tar" \
--puppet-server-foreman-url "https://satellite.example.com" \
--certs-cname "loadbalancer.example.com" \
--puppet-dns-alt-names "loadbalancer.example.com" \
--puppet-ca-server "capsule-ca.example.com" \
--foreman-proxy-puppetca "false" \
--puppet-server-ca "false" \
--enable-foreman-proxy-plugin-remote-execution-ssh

第 5 章 安装 Load Balancer

以下示例提供了配置 HAProxy 负载均衡器的一般指导。但是，您可以安装任何支持 TCP 转发的负载平衡软件解决方案。

  1. 在 Red Hat Enterprise Linux 7 主机上安装 HAProxy： 

    # yum install haproxy

  2. 安装包含以下软件包，其中包括 semanage 工具： 

    # yum install policycoreutils-python

  3. 配置 SELinux 以允许 HAProxy 绑定任何端口： 

    # semanage boolean --modify --on haproxy_connect_any

  4. 配置负载均衡器以平衡端口的网络负载，如 表 5.1 “Load Balancer 的端口配置” 所述。例如，要为 HAProxy 配置端口，请编辑 /etc/haproxy/haproxy.cfg 文件，使其与表对应。

    表 5.1. Load Balancer 的端口配置

    服务端口模式平衡模式目的地

    HTTP

    80

    TCP

    roundrobin

    所有 Capsule 服务器上的端口 80

    HTTPS 和 RHSM

    443

    TCP

    source

    所有 Capsule 服务器上的端口 443

    AMQP

    5647

    TCP

    roundrobin

    所有 Capsule 服务器上的端口 5647

    puppet (可选)

    8140

    TCP

    roundrobin

    所有 Capsule 服务器上的端口 8140

    PuppetCA (可选)

    8141

    TCP

    roundrobin

    仅在配置 Capsule 服务器为 Puppet 证书签名的系统中端口 8140

    SmartProxy (OpenScap 的可选)

    9090

    TCP

    roundrobin

    所有 Capsule 服务器上的端口 9090

  5. 配置负载均衡器，以禁用 SSL 卸载，并允许客户端 SSL 证书传递给后端服务器。这是必要的，因为从客户端到 Capsule 服务器的通信取决于客户端 SSL 证书。

  6. 启动并启用 HAProxy 服务： 

    # systemctl start haproxy
# systemctl enable haproxy

第 6 章 注册客户端

您可以将运行 Red Hat Enterprise Linux 6、7 或 8 操作系统的客户端注册到您配置为负载均衡的 Capsule 服务器中。有关注册客户端并将其配置为使用 Puppet 的更多信息，请参阅 管理主机 指南中的注册主机。

要注册客户端，请执行以下步骤之一：

6.1. Red Hat Satellite 主机注册

您可以使用主机注册功能、Satellite API 或hammer CLI 将主机注册到 Satellite。

流程

  1. 在 Satellite Web UI 中，导航到 Hosts > Register Host。
  2. 点 Generate 来创建注册命令。
  3. 点 文件 图标将命令复制到您的剪贴板中。
  4. 登录到您要注册并运行之前生成的命令的主机。

  5. 更新 rhsm.baseurl 和 server.hostname 的订阅管理器配置： 

    # subscription-manager config \
--rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
--server.hostname=loadbalancer.example.com
  6. 检查 /etc/yum.repos.d/redhat.repo 文件，并确保已启用适当的存储库。

CLI 过程

  1. 使用hammer CLI 生成主机注册命令： 

    # hammer host-registration generate-command \
--activation-keys "My_Activation_Key"
  2. 登录到您要注册并运行之前生成的命令的主机。

  3. 更新 rhsm.baseurl 和 server.hostname 的订阅管理器配置： 

    # subscription-manager config \
--rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
--server.hostname=loadbalancer.example.com
  4. 检查 /etc/yum.repos.d/redhat.repo 文件，并确保已启用适当的存储库。

API 流程

  1. 使用 Satellite API 生成主机注册命令： 

    # curl -X POST https://satellite.example.com/api/registration_commands \
--user "My_User_Name" \
-H 'Content-Type: application/json' \
-d '{ "registration_command": { "activation_keys": ["My_Activation_Key_1, My_Activation_Key_2"] }}'

    使用激活码简化指定环境。如需更多信息，请参阅 内容管理指南中的管理 激活码。

    要以命令行参数形式输入密码，请使用 username:password 语法。请记住，这会在 shell 历史记录中保存密码。

    有关注册的更多信息，请参阅 将主机注册到 Red Hat Satellite。

  2. 登录到您要注册并运行之前生成的命令的主机。

  3. 更新 rhsm.baseurl 和 server.hostname 的订阅管理器配置： 

    # subscription-manager config \
--rhsm.baseurl=https://loadbalancer.example.com/pulp/content \
--server.hostname=loadbalancer.example.com
  4. 检查 /etc/yum.repos.d/redhat.repo 文件，并确保已启用适当的存储库。

6.2. （已弃用） 使用 Bootstrap 脚本注册客户端

要注册客户端，请在客户端上输入以下命令。您必须为每个客户端完成注册过程。

前提条件

确保在客户端上安装 bootstrap 脚本，并将脚本的文件权限改为可执行。如需更多信息，请参阅 管理主机 指南中的使用引导 脚本将主机注册到 Red Hat Satellite。

  • 在 Red Hat Enterprise Linux 8 中，输入以下命令： 

    # /usr/libexec/platform-python bootstrap.py \
--login=admin \
--server loadbalancer.example.com \
--organization="My_Organization" \
--location="My_Location" \
--hostgroup="My_Hostgroup" \
--activationkey="My_Activation_Key" \
--enablerepos=satellite-client-6-for-rhel-8-<arch>-rpms \
--puppet-ca-port 8141 \    1
--force                    2
    1
    如果使用 Puppet，请包含 --puppet-ca-port 8141 选项。
    2
    包含 --force 选项，以注册之前注册到独立胶囊的客户端。

  • 在 Red Hat Enterprise Linux 7、6 或 5 中输入以下命令： 

    # python bootstrap.py --login=admin \
--server loadbalancer.example.com \
--organization="My_Organization" \
--location="My_Location" \
--hostgroup="My_Hostgroup" \
--activationkey="My_Activation_Key" \
--enablerepos=rhel-7-server-satellite-client-6-rpms \
--puppet-ca-port 8141 \    1
--force                    2
    1
    如果使用 Puppet，请包含 --puppet-ca-port 8141 选项。
    2
    包含 --force 选项，以注册之前注册到独立胶囊的客户端。

该脚本提示您输入与您使用 --login 选项输入的 Satellite 用户名对应的密码。

6.3. （已弃用） 使用 katello-ca-consumer rpm 手动注册客户端

要手动注册客户端，请在您注册的每个客户端上完成以下步骤。

流程

  1. 如果安装了 katello-ca-consumer 软件包，请删除它： 

    # yum remove 'katello-ca-consumer*'

  2. 从负载均衡器安装 katello-ca-consumer 软件包： 

    # rpm -Uvh http://loadbalancer.example.com/pub/katello-ca-consumer-latest.noarch.rpm

  3. 注册客户端并包含 --serverurl 和 --baseurl 选项： 

    # subscription-manager register \
--activationkey=My_Activation_Key \
--baseurl=https://loadbalancer.example.com/pulp/content/ \
--org=Your_Organization \
--serverurl=https://loadbalancer.example.com/rhsm

第 7 章 将 SCAP 内容提升到客户端

下面的部分论述了如何将安全内容自动化协议(SCAP)内容提升到您配置为负载均衡的 Capsule 服务器的客户端。

先决条件

  • 确保配置 SCAP 内容。如需更多信息，请参阅 管理 Red Hat Satellite 指南中的 配置 SCAP 内容。

流程

  1. 在 Satellite Web UI 中，导航到 Configure > Classes，再点 foreman_scap_client。
  2. 单击 Smart Class 参数 选项卡。
  3. 在 智能类参数 窗口左侧的窗格中，单击 端口。
  4. 在 默认行为 区域中，选中 Override 复选框。
  5. 从 Key Type 列表中，选择 整数。
  6. 在 Default Value 字段中，输入 9090。
  7. 在 智能类参数 窗口左侧的窗格中，单击 server。
  8. 在 默认行为 区域中，选中 Override 复选框。
  9. 从 Key Type 列表中，选择 字符串。
  10. 在 Default Value 字段中，输入负载均衡器的 FQDN。例如，loadbalancer.example.com。
  11. 在 智能类参数 窗口左下角，单击 Submit。
  12. 将包含 foreman_scap_client puppet 类的 puppet 模块添加到内容视图。发布并提升此内容视图到您的客户端环境。

  13. 如果要验证配置，请在客户端上运行 Puppet 代理以提升更改。不要手动在每个客户端上运行 Puppet 代理，因为 Puppet 代理每 30 分钟在客户端上运行。 

    # puppet agent -t --noop

  14. 在客户端上，验证 /etc/foreman_scap_client/config.yaml 文件是否包含以下行： 

    # Foreman proxy to which reports should be uploaded
:server: 'loadbalancer.example.com'
:port: 9090

其它资源

第 8 章 验证负载均衡配置

您可以通过为您配置的每个 Capsule 服务器完成以下步骤来验证负载均衡配置：

  1. 关闭您的 Capsule 服务器的基本操作系统。
  2. 验证内容或订阅管理功能是否在注册到此 Capsule 的客户端中可用。例如，在客户端上输入 subscription-manager refresh 命令。
  3. 为您的 Capsule 服务器重启基础操作系统。

法律通告

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.