OpenShift 文档正在迁移，很快将只在 docs.redhat.com（所有 Red Hat 产品文档的所在地）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

在 AWS 上安装集群

在 OpenShift Container Platform 4.17 版本中，您可以安装使用默认配置选项的 Amazon Web Services (AWS) 集群。

先决条件

部署集群

您可以在兼容的云平台上安装 OpenShift Container Platform。

您只能在初始安装期间运行安装程序的 create cluster 命令一次。
先决条件

  • 您已配置具有托管集群的云平台帐户。

  • 您拥有 OpenShift Container Platform 安装程序和集群的拉取密钥。

  • 您已验证主机上的云提供商帐户是否具有部署集群的正确权限。权限不正确的帐户会导致安装过程失败，并显示一条显示缺少权限的错误消息。

步骤

  1. 更改到包含安装程序的目录并初始化集群部署

    $ ./openshift-install create cluster --dir <installation_directory> \ (1)
    --log-level=info (2)
    1 对于 <installation_directory>，请指定存储安装程序创建的文件的目录名称。
    2 要查看不同的安装详细信息，请指定 warn、debug 或 error 代替 info。

    指定目录时

    • 验证该目录是否具有 execute 权限。此权限是必需的，可以在安装目录下运行 Terraform 二进制文件。

    • 使用空目录。某些安装资产（例如引导 X.509 证书）的过期时间间隔较短，因此您不得重用安装目录。如果您想重用来自另一个集群安装的单个文件，您可以将它们复制到您的目录中。但是，安装资产的文件名可能会在不同版本之间发生更改。从较早的 OpenShift Container Platform 版本复制安装文件时，请谨慎操作。

  2. 在提示符处提供值

    1. 可选：选择要用于访问集群机器的 SSH 密钥。

      对于要执行安装调试或灾难恢复的生产 OpenShift Container Platform 集群，请指定您的 ssh-agent 进程使用的 SSH 密钥。

    2. 选择 **aws** 作为目标平台。

    3. 如果您在计算机上没有存储 Amazon Web Services (AWS) 配置文件，请输入您已配置为运行安装程序的用户 的 AWS 访问密钥 ID 和秘密访问密钥。

      AWS 访问密钥 ID 和秘密访问密钥存储在安装主机当前用户的 home 目录中的 ~/.aws/credentials 中。如果导出的配置文件的凭据未出现在文件中，安装程序会提示您输入凭据。您提供给安装程序的任何凭据都将存储在文件中。

    4. 选择用于部署集群的 AWS 区域。

    5. 选择为您的集群配置的 Route 53 服务的基本域名。

    6. 输入集群的描述性名称。

    7. 粘贴来自 Red Hat OpenShift 集群管理器的拉取密钥。

  3. 可选：从用于安装集群的 IAM 帐户中移除或禁用AdministratorAccess策略。

    AdministratorAccess策略提供的提升权限仅在安装期间需要。
验证

集群部署成功完成后

  • 终端将显示访问集群的说明，包括指向 Web 控制台的链接以及kubeadmin用户的凭据。

  • 凭据信息也会输出到<安装目录>/.openshift_install.log。

不要删除安装程序或安装程序创建的文件。两者都是删除集群所必需的。
示例输出
...
INFO Install complete!
INFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'
INFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com
INFO Login to the console with user: "kubeadmin", and password: "password"
INFO Time elapsed: 36m22s

  • 安装程序生成的 Ignition 配置文件包含在 24 小时后过期的证书，届时会自动续订。如果在续订证书之前关闭集群，并在 24 小时后重新启动集群，则集群会自动恢复已过期的证书。例外情况是，您必须手动批准挂起的node-bootstrapper证书签名请求 (CSR) 以恢复 kubelet 证书。有关更多信息，请参阅从过期的控制平面证书中恢复的文档。

  • 建议您在生成 Ignition 配置文件后 12 小时内使用它们，因为在集群安装后 16 到 22 小时，24 小时证书会轮换。在 12 小时内使用 Ignition 配置文件，可以避免在安装期间证书更新运行时安装失败。
其他资源

使用 CLI 登录集群

您可以通过导出集群kubeconfig文件以默认系统用户身份登录到您的集群。kubeconfig文件包含集群信息，CLI 使用这些信息将客户端连接到正确的集群和 API 服务器。该文件特定于一个集群，并在 OpenShift Container Platform 安装期间创建。

先决条件

  • 您已部署了 OpenShift Container Platform 集群。

  • 您已安装了oc CLI。

步骤

  1. 导出kubeadmin凭据

    $ export KUBECONFIG=<installation_directory>/auth/kubeconfig (1)
    1 对于<安装目录>，请指定存储安装文件的目录的路径。

  2. 验证您可以使用导出的配置成功运行oc命令

    $ oc whoami
    示例输出
    system:admin

使用 Web 控制台登录集群

在 OpenShift Container Platform 安装后，kubeadmin用户默认存在。您可以使用 OpenShift Container Platform Web 控制台以kubeadmin用户身份登录到您的集群。

先决条件

  • 您可以访问安装主机。

  • 您已完成集群安装，并且所有集群运算符都可用。

步骤

  1. 从安装主机上的kubeadmin-password文件中获取kubeadmin用户的密码

    $ cat <installation_directory>/auth/kubeadmin-password

    或者，您可以从安装主机上的<安装目录>/.openshift_install.log日志文件中获取kubeadmin密码。

  2. 列出 OpenShift Container Platform Web 控制台路由

    $ oc get routes -n openshift-console | grep 'console-openshift'

    或者，您可以从安装主机上的<安装目录>/.openshift_install.log日志文件中获取 OpenShift Container Platform 路由。
    示例输出
    console     console-openshift-console.apps.<cluster_name>.<base_domain>            console     https   reencrypt/Redirect   None

  3. 在 Web 浏览器中导航到前面命令输出中详细说明的路由，并以kubeadmin用户身份登录。

其他资源

  • 有关访问和了解 OpenShift Container Platform Web 控制台的更多详细信息，请参阅访问 Web 控制台。

后续步骤