IBM Cloud Docs
设置 Satellite 位置控制平面

设置 Satellite 位置控制平面

位置控制平面运行由 Satellite 管理的资源，以帮助管理连接到该位置的主机，集群和其他资源。

设置 Satellite 位置控制平面时，请记住以下主机注意事项。

从控制台设置控制平面

使用 Satellite 控制台为您的位置设置控制平面。

准备工作

要将主机作为工作程序节点连接到控制平面，

  1. 从 Satellite “位置”仪表板 中，选择要完成控制平面设置的位置。

  2. 从 主机 选项卡中，选择要作为工作程序节点分配给控制平面的主机。 所有主机都必须处于 未分配 状态。

  3. 从每个主机的“操作”菜单中，单击 分配主机。

  4. 选择 控制平面 作为集群。

  5. 将 3 组中的主机平均分配给控制平面集群。 对于高可用性，请确保主机对应于基础结构提供程序中物理上独立的区域。 例如，如果基础结构提供程序具有 us-east-1a，us-east-1b 和 us-east-1c，请为 Satellite 区域输入这些名称。 然后，将基础结构提供程序中的 us-east-1a 中的 2 主机分配到 Satellite 控制平面中的 us-east-1a，依此类推。 将主机分配给控制平面时，IBM 会引导机器。 此过程可能需要几分钟才能完成。 在引导过程中，机器的 运行状况 从 Ready 更改为 Provisioning。

  6. 从 主机 选项卡中，验证主机是否已成功分配到 Satellite 位置控制平面。 将 IP 地址添加到主机并且 运行状况 状态更改为 正常时，分配成功。

  7. 验证您的位置状态是否已更改为 正常。 在引导过程完成之前，您可能会看到有关该位置没有足够主机的位置消息。

    将主机成功分配到控制平面后，再需要 20 到 30 分钟，才能为您的位置正确设置 IBM 监视。 此外，将为您的位置创建 DNS 记录，并且将自动注册主机的 IP 地址并将其添加到 DNS 记录中，以允许对您的位置进行负载均衡和运行状况检查。 此过程最多需要 30 分钟才能完成。 在此过程中，您的位置状态将继续显示 需要操作 状态，并且您可能会看到间歇性错误，例如 Satellite is attempting to recover 或 Verify that the Satellite location has a DNS record for load balancing requests to the location control plane。

  8. 验证是否已注册所有主机的 IP 地址并将其添加到位置的 DNS 记录中。 检查证书状态是否为 已创建，以及是否使用子域填充了记录。

    ibmcloud sat location dns ls --location <location_ID_or_name>

    示例输出

    Retrieving location subdomains...
OK
Hostname                                                                                              Records                                                                                               Health Monitor   SSL Cert Status   SSL Cert Secret Name                                          Secret Namespace   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000.us-east.satellite.appdomain.cloud   169.62.196.20,169.62.196.23,169.62.196.30                                                             None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c001.us-east.satellite.appdomain.cloud   169.62.196.30                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c001   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c002.us-east.satellite.appdomain.cloud   169.62.196.20                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c002   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c003.us-east.satellite.appdomain.cloud   169.62.196.23                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c003   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-ce00.us-east.satellite.appdomain.cloud   ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000.us-east.satellite.appdomain.cloud        None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-ce00   default

  9. 要继续将该位置用于生产工作负载，请重复这些步骤以将更多主机以 3 的倍数 (例如 6，9 或 12 个主机) 连接到位置控制平面。 有关更多信息，请参阅 向 Satellite 位置控制平面添加容量。

从 CLI 设置控制平面

使用 Satellite 命令行为您的位置设置控制平面。

准备工作

要创建控制平面，

  1. 标识要用作 Satellite 控制平面的工作程序节点的主机。 所有主机都必须处于 unassigned 状态。

    ibmcloud sat host ls --location <location_name_or_ID>

    示例输出

    Name             ID                     State        Status   Cluster   Worker ID   Worker IP   
machine-name-1   aaaaa1a11aaaaaa111aa   unassigned   -        -         -           -   
machine-name-2   bbbbbbb22bb2bbb222b2   unassigned   -        -         -           -   
machine-name-3   ccccc3c33ccccc3333cc   unassigned   -        -         -           -

  2. 可选: 如果要使用主机标签将主机分配给控制平面，请检索主机的详细信息。 您可以使用的可用标签在 CLI 输出的 Labels 部分中列出。

    ibmcloud sat host get --location <location_name_or_ID> --host <host_ID>

    示例输出

    Retrieving host details...

Name:     mymachine1   
ID:       brjrgp920bg4u254brr0   
State:    unassigned  
Status:   -   

Labels      
cpu      4   
memory   32774980  
use      satloc

Assignment        
Cluster:       -  
Worker Pool:   -  
Zone:          -  
Worker ID:     -
Worker IP:     -   
Date:          -   
OK

  3. 将主机分配给 Satellite 位置控制平面。 将主机分配给控制平面时，IBM 会引导机器。 这个过程需要几分钟才能完成。 您可以选择使用主机标识来分配主机，也可以定义必须将主机分配到该位置的标签。

    使用主机标识分配主机的示例。

    ibmcloud sat host assign --location <location_name_or_ID>  --cluster <location_ID> --host <host_ID>  --zone <zone>

    使用 use:satloc 标签分配主机的示例。

    ibmcloud sat host assign --location <location_name_or_ID> --cluster <location_ID> --host-label "use:satloc" --zone <zone>
    --location <location_name_or_ID>
    输入 Satellite 位置的名称或标识。 要检索位置名称或 ID，请运行 ibmcloud sat location ls。
    --cluster <location_ID>
    输入要在其中分配主机以运行 Satellite 位置控制平面的 Satellite 位置的标识。 要查看您的位置标识，请运行 ibmcloud sat location ls。
    --host <host_ID>
    输入要分配给 Satellite 位置控制平面的主机标识。 要查看主机 ID，请运行 ibmcloud sat host ls --location <location_name>。 您可以使用 --host-label 选项来标识要分配给控制平面的主机。
    --host-label <label>
    输入要用于标识要分配的主机的标签。 标签必须是键/值对，并且必须存在于主机上。 使用 label 选项运行此命令时，会将处于 unassigned 状态且与标签匹配的第一个主机分配给您的控制平面。
    --zone <zone>
    输入要将主机分配到的区域，这可以对应于基础结构提供程序中的物理上独立的区域。 要查看位置的区域名称，请运行 ibmcloud sat location get --location <location_name_or_ID> 并查找 主机区域 字段。

  4. 对要连接到 Satellite 位置控制平面的其他主机重复上一步。 为实现高可用性，请确保在对应于基础结构提供程序中物理上独立的专区的专区之间平均分配主机。 例如，如果基础结构提供程序具有 us-east-1a，us-east-1b 和 us-east-1c，那么可以为 Satellite 区域输入这些名称。 然后，将基础结构提供程序中的 us-east-1a 中的 2 个主机分配到 Satellite 控制平面中的 us-east-1a，us-east-1b 中的 2 个主机以及 us-east-1c 中的 2 个主机，以便在控制平面中总共有 6 个主机。

  5. 验证是否已成功将主机分配到您的位置。 当所有主机都显示 已分配 状态和 就绪 状态，并且向主机分配了 IP 地址时，分配成功。 如果机器的 状态 显示 -，说明引导过程尚未完成，并且无法检索运行状态。 等待几分钟，然后再试一次。

    ibmcloud sat host ls --location <location_name>

    示例输出

    Retrieving hosts...
OK
Name              ID                     State      Status   Cluster          Worker ID                                                 Worker IP   
machine-name-1    aaaaa1a11aaaaaa111aa   assigned   Ready    infrastructure   sat-virtualser-4d7fa07cd3446b1f9d8131420f7011e60d372ca2   169.xx.xxx.xxx   
machine-name-2    bbbbbbb22bb2bbb222b2   assigned   Ready    infrastructure   sat-virtualser-9826f0927254b12b4018a95327bd0b45d0513f59   169.xx.xxx.xxx   
machine-name-3    ccccc3c33ccccc3333cc   assigned   Ready    infrastructure   sat-virtualser-948b454ea091bd9aeb8f0542c2e8c19b82c5bf7a   169.xx.xxx.xxx

  6. 验证您的位置状态是否已更改为 正常。 在引导过程完成之前，您可能会看到有关该位置没有足够主机的位置消息。

    将主机成功分配到控制平面后，再需要 20 到 30 分钟，才能为您的位置正确设置 IBM 监视。 此外，将为您的位置创建 DNS 记录，并且将自动注册主机的 IP 地址并将其添加到 DNS 记录中，以允许对您的位置进行负载均衡和运行状况检查。 此过程最多需要 30 分钟才能完成。 在此过程中，您的位置状态将继续显示 所需的操作，并且您可能会看到间歇性错误，例如 Satellite is attempting to recover 或 Verify that the Satellite location has a DNS record for load balancing requests to the location control plane。

    ibmcloud sat location ls

    示例输出

    OK
Name         ID                     Status      Ready   Created      Hosts (used/total)   Managed From   
mylocation   brhtfum2015a6mgqj16g   normal      yes     4 days ago   3 / 3                Washington DC

  7. 验证是否已注册所有主机的 IP 地址并将其添加到位置的 DNS 记录中。 检查证书状态是否为 已创建，以及是否使用子域填充了记录。

    ibmcloud sat location dns ls --location <location_ID_or_name>

    示例输出

    Retrieving location subdomains...
OK
Hostname                                                                                              Records                                                                                               Health Monitor   SSL Cert Status   SSL Cert Secret Name                                          Secret Namespace   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000.us-east.satellite.appdomain.cloud   169.62.196.20,169.62.196.23,169.62.196.30                                                             None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c001.us-east.satellite.appdomain.cloud   169.62.196.30                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c001   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c002.us-east.satellite.appdomain.cloud   169.62.196.20                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c002   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c003.us-east.satellite.appdomain.cloud   169.62.196.23                                                                                         None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c003   default   
ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-ce00.us-east.satellite.appdomain.cloud   ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-c000.us-east.satellite.appdomain.cloud        None             created           ne1d37313068166254bcb-edfc0a8ba65085c5081eced6816c5b9c-ce00   default

  8. 要继续将该位置用于生产工作负载，请重复这些步骤以将更多主机以 3 的倍数 (例如 6，9 或 12 个主机) 连接到位置控制平面。 有关更多信息，请参阅 向 Satellite 位置控制平面添加容量。

我创建了 Satellite 位置，下一步是什么?

现在，您的 Satellite 位置已设置完毕，您已准备好开始使用 IBM Cloud 服务。

  1. 通过 将更多主机连接到位置 向您的位置添加计算容量，以便您可以运行 Satellite-enabled IBM Cloud 服务。
  2. 创建 Satellite-enabled IBM Cloud 服务，例如 Red Hat OpenShift 集群。 分配先前作为工作程序节点连接的其他主机，以提供集群的计算能力。 您甚至可以 将现有 Red Hat OpenShift 集群注册到您的位置 以用作部署目标。
  3. 使用 Satellite 配置 管理应用程序。
  4. 创建 Satellite 集群存储模板。
  5. 了解有关 Satellite 链接组件 的更多信息，以及如何使用端点来管理位置与 IBM Cloud之间的网络流量。

需要帮助吗？ 查看 获取支持，您可以在其中找到有关云状态，问题和日志记录的信息; 联系支持人员; 以及设置 IBM Cloud 平台相关项的电子邮件通知首选项。