连接 IBM Cloud 主机以进行测试

使用您在 IBM Cloud中创建的虚拟实例测试 IBM Cloud Satellite® 位置。

仅测试: Satellite 是 IBM Cloud 到其他基础架构提供者的扩展。因此，仅支持将 IBM Cloud 基础架构主机添加到 Satellite 以用于测试，演示或概念验证目的。对于 Satellite 位置中的生产工作负载，请使用本地，边缘或其他云提供者主机。您还可以在公共云中创建 Red Hat OpenShift on IBM Cloud 集群，并将其添加到 Satellite 配置集群组，以在 Satellite 和 IBM Cloud 集群中部署同一应用程序。此时，通常不建议在 IBM Cloud 中使用 Satellite 位置和 Satellite 连接器，但特定用例除外。如果您认为解决方案需要此支持，请联系 IBM 帐户团队。

要连接 Red Hat CoreOS (RHCOS) 主机，必须为 Red Hat CoreOS启用您的位置。有关更多信息，请参阅我的位置是否为 Red Hat CoreOS?。请注意，您仍可以将 Red Hat Enterprise Linux 主机连接到为 Red Hat CoreOS启用的位置。

开始之前，请确保在本地数据中心，IBM Cloud或公共云提供者中创建符合最低硬件需求的主机。

将主机连接到位置后，Satellite 将禁用以 root 用户身份使用 SSH 登录主机以实现安全目的的能力。如果尝试以 root 用户身份通过 SSH 连接到成功连接到某个位置的主机，那么可能会看到错误消息。要将 SSH 功能复原到机器中，可以除去主机并重新装入操作系统。

不确定要连接到您所在位置的主机数? 请参阅确定 Satellite 位置。

手动将 IBM Cloud RHEL 主机添加到 Satellite

您可以使用从 IBM Cloud添加的主机来创建 Satellite 位置。

要添加的所有主机都必须满足常规主机需求，例如 RHEL 8 软件包和联网设置。有关更多信息，请参阅主机需求。

开始之前，请创建 Satellite 位置。

执行以下步骤以在 VPC 中创建经典公共虚拟服务器或虚拟服务器实例。确保选择受支持的 RHEL 8 操作系统或受支持的 Red Hat CoreOS (RHCOS) 映像，配置机器至少具有 4 个 CPU 和 16 个 RAM，并添加大小至少为 100 GB 的引导磁盘。
等待供应虚拟服务器实例。
获取注册脚本以将主机连接到 IBM Cloud Satellite 位置。请注意，脚本中的令牌是 API 密钥，应该将其作为敏感信息进行处理和保护。记下附加脚本的位置。另请注意，对于基于 RHEL 的主机，连接脚本是 Shell 脚本。
```
ibmcloud sat host attach --location <location_name_or_ID>
```
检索机器的 IP 地址和标识。
- 经典
```
ibmcloud sl vs list
```
- VPC
```
ibmcloud is instances
```

检索用于登录到虚拟机的凭证。

经典
```
ibmcloud sl vs credentials <vm_ID>
```

VPC

ibmcloud is instance-initialization-values <instance_ID>

将脚本从本地机器复制到虚拟服务器实例。

scp <path_to_attachHost.sh> root@<ip_address>:/tmp/attach.sh

如果使用 SSH 密钥登录，请确保将密钥转换为 .key 格式并使用以下命令。

scp -i <filepath_to_key_file.key> <filepath_to_script> <username>@<IP_address>:/tmp/attach.sh

登录虚拟机。如果出现提示，请输入先前检索到的密码。
```
ssh root@<ip_address>
```
如果使用 SSH 密钥登录，请使用以下命令。
```
ssh -i <filepath_to_key_file.key> <username>@<IP_address>
```
刷新机器上的 Red Hat 软件包。
```
subscription-manager refresh
```

在机器上启用软件包存储库。

RHEL 8 经典版:

subscription-manager repos --enable rhel-8-for-x86_64-appstream-rpms
subscription-manager repos --enable rhel-8-for-x86_64-baseos-rpms

RHEL 8 VPC：

subscription-manager release --set=8
subscription-manager repos --enable rhel-8-for-x86_64-baseos-rpms
subscription-manager repos --enable rhel-8-for-x86_64-appstream-rpms
subscription-manager repos --disable='*eus*'

在机器上运行注册脚本。
```
nohup bash /tmp/attach.sh &
```
观看注册脚本的进度。
```
journalctl -f -u ibm-host-attach
```
退出 SSH 会话。
```
exit
```
检查主机是否显示在 Satellite 控制台的主机选项卡中。当可以建立与机器的连接时，所有主机都会显示 运行状况 状态 Ready，状态为 Unassigned，因为尚未将这些主机分配给 Satellite 位置控制平面或 Red Hat OpenShift on IBM Cloud 集群。
将主机分配到 Satellite 控制平面或 Red Hat OpenShift on IBM Cloud 集群。

手动将 IBM Cloud RHCOS 主机添加到 Satellite

您可以使用从 IBM Cloud添加的主机创建 Satellite 位置。

要添加的所有主机都必须满足常规主机需求，例如 RHEL 8 软件包和联网设置。有关更多信息，请参阅主机需求。

开始之前，请创建 Satellite 位置。

获取注册脚本以将主机连接到 IBM Cloud Satellite 位置。请注意，脚本中的令牌是 API 密钥，应该将其作为敏感信息进行处理和保护。记下附加脚本的位置。另请注意，对于 RHCOS 主机，连接脚本是 RHCOS 点火文件。
```
ibmcloud sat host attach --location <location_name_or_ID>
```
下载要使用的 Red Hat CoreOS 映像。使用 IBM Cloud Object Storage 来存储定制映像。如果您还没有实例，请创建一个并至少创建一个存储区。
将先前下载的 RHCOS 映像上载到 Object Storage 实例中的存储区。您可以使用 Minio 命令行客户机将映像从本地机器上的目录复制到存储区。首先，创建一组 HMAC 服务凭证，并记录 access_key_id 和 secret_access_key。然后，安装 Minio 客户机并将其配置为使用您的凭证。
授予对 Object Storage 的访问权。
在 VPC 中导入定制 RHCOS 映像。您可以在 VPC 控制台中创建定制映像。
为映像指定名称，选择要在其中创建映像的 资源组，然后选择 Cloud Object Storage
在 Cloud Object Storage 实例部分中，选择实例，位置和上载映像的存储区。
在 操作系统 部分中，选择 Red Hat Enterprise Linux，然后选择 fedora-coreos-stable-amd64。
选择要使用的加密，然后单击创建自定义图像。
使用定制映像，创建 VPC Gen 2 实例，并将它们连接到支持 RHCOS 的位置。请注意，ATTACH-SCRIPT-LOCATION 参数是您先前通过运行 ibmcloud sat host attach 命令检索到的点火文件的位置。确保在指向点火文件的路径之前包含 @ 符号。
```
ibmcloud is instance-create INSTANCE-NAME VPC VPC-ZONE-NAME VPC-PROFILE-NAME VPC-SUBNET --image VPC-RHCOS-IMAGE-ID --user-data @ATTACH-SCRIPT-LOCATION --keys SSH-KEY-ID
```
用于创建 VPC Gen 2 实例并将主机连接到 Red Hat CoreOS 启用位置的示例命令。有关 instance create 命令的更多信息，请参阅 VPC Gen 2 命令行参考。
```
ibmcloud is instance-create instance-1 my-vpc us-south-1 bx2d-4x16 0111-11e11111-1c11-1111-11aa-ba1a1d1cd111 —-keys my-key --image r001-a1f111b1-11bc-1e1e-b11c-1d11c1111111 --user-data @/var/register-host_coreos.ign
```
重复上一步，为要连接的每个主机创建 VPC Gen 2 实例。计划至少连接要在控制平面中使用的 3 主机，并为要使用的任何服务连接其他主机。
检查主机是否显示在 Satellite 控制台的主机选项卡中。当可以建立与机器的连接时，所有主机都会显示 运行状况 状态 Ready，状态为 Unassigned，因为尚未将这些主机分配给 Satellite 位置控制平面或 Red Hat OpenShift on IBM Cloud 集群。
将主机分配到 Satellite 控制平面或 Red Hat OpenShift on IBM Cloud 集群。

我将主机添加到我的位置，下一步是什么?

现在，您已将主机添加到位置，可以将它们分配到位置控制平面或 IBM Cloud 服务。

将主机分配给位置控制平面或分配给 IBM Cloud 服务。
创建 Satellite-enabled IBM Cloud 服务，例如 Red Hat OpenShift 集群。您甚至可以将现有 Red Hat OpenShift 集群注册到您的位置以用作部署目标。
使用 Satellite 配置管理应用程序。
创建 Satellite 集群存储模板。
了解有关 Satellite 链接组件的更多信息，以及如何使用端点来管理位置与 IBM Cloud之间的网络流量。

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