×

您可以安装使用默认配置选项的 Microsoft Azure 集群。

部署集群

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

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

先决条件
  • 您已配置了托管集群的云平台帐户。

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

  • 您拥有 Azure 订阅 ID 和租户 ID。

  • 您拥有服务主体的应用程序 ID 和密码。

步骤
  1. 可选:如果您之前在此计算机上运行过安装程序,并且想要使用其他服务主体,请转到 `~/.azure/` 目录并删除 `osServicePrincipal.json` 配置文件。

    删除此文件可防止安装程序自动重用先前安装中的订阅和身份验证值。

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

    $ ./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 版本复制安装文件时,请谨慎操作。

  3. 提供提示中的值

    1. 可选:选择一个 SSH 密钥来访问您的集群机器。

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

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

      如果安装程序无法从之前的安装中找到 `osServicePrincipal.json` 配置文件,系统会提示您输入 Azure 订阅和身份验证值。

    3. 为您的订阅和服务主体指定以下 Azure 参数值

      • **azure 订阅 ID**: 输入要用于集群的订阅 ID。

      • **azure 租户 ID**: 输入租户 ID。

      • Azure 服务主体客户端 ID:输入其应用程序 ID。

      • Azure 服务主体客户端密钥:输入其密码。

    4. 选择要将集群部署到的区域。

    5. 选择要将集群部署到的基础域。基础域对应于您为集群创建的 Azure DNS 区域。

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

      所有通过公共端点可用的 Azure 资源都受资源名称限制,您不能创建使用某些术语的资源。有关 Azure 限制的术语列表,请参阅 Azure 文档中的解决保留的资源名称错误

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

如果之前未检测到,安装程序将创建一个osServicePrincipal.json配置文件并将此文件存储在您计算机上的~/.azure/目录中。这确保安装程序在目标平台上创建 OpenShift Container Platform 集群时可以加载配置文件。

验证

集群部署成功后

  • 终端将显示访问集群的说明,包括指向 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
其他资源
  • 有关访问和了解 OpenShift Container Platform Web 控制台的更多信息,请参阅访问 Web 控制台

后续步骤