在Mac OS上用Minishift本地安装OpenShift 3.11

短命女 2022-12-21 03:20 113阅读 0赞

### 文章目录 ###

*  在Mac OS上用Minishift本地安装OpenShift 3.11
 *   *  前言
     *  官方文档
     *  安装虚拟化环境
     *  安装Minishift
     *  创建Minishift虚拟机和部署OpenShift集群
     *  访问OpenShift集群
     *   *  创建集群管理员账号
         *  访问OpenShift Web Console
         *  用oc命令行方式访问OpenShift
     *  停止OpenShift集群
     *  Troubleshooting
     *   *  Homebrew相关问题
         *  Checking if requested OpenShift version 'v3.11.0' is valid ... v3.11.0 is not a valid OpenShift versionFAIL
         *  Checking for setuid bit ... FAIL
         *  Error starting the cluster: Error attempting to download and cache 'oc': Cannot get the OpenShift release version v3.11.0: Get "https://api.github.com/repos/openshift/origin/releases/tags/v3.11.0": dial tcp 13.250.168.23:443: connect: connection refused
         *  下载oc和iso很慢
         *  拉取OpenShift镜像很慢
         *  Minishift start失败
         *  重新安装Minishift虚拟机和部署OpenShift集群
         *  Temporary Error: Could not find an IP address
         *  oc login -u system:admin 需要密码
         *  删除Minishift VM后再次启动很慢
         *  Minishift Web Console打不开
     *  参考文档

# 在Mac OS上用Minishift本地安装OpenShift 3.11 #

## 前言 ##

本文描述了在Mac OS上用Minishift本地安装OpenShift单节点集群。

> OpenShift单节点集群只能用于开发测试环境。

部署说明：

*  Mac OS 10.12
 *  Homebrew
 *  Minishift v1.34.3
 *  Minishift VM driver：hyperkit
 *  OpenShift v3.11.0

## 官方文档 ##

*  [https://docs.okd.io/3.11/minishift/getting-started/preparing-to-install.html][https_docs.okd.io_3.11_minishift_getting-started_preparing-to-install.html]
 *  [https://www.okd.io/minishift/][https_www.okd.io_minishift]
 *  [https://github.com/minishift/minishift][https_github.com_minishift_minishift]
 *  [https://www.openshift.com/blog/minishift-enterprise-installation][https_www.openshift.com_blog_minishift-enterprise-installation]
 *  [https://github.com/minishift/minishift/releases][https_github.com_minishift_minishift_releases]

## 安装虚拟化环境 ##

> 在Mac OS上Minishift VM 3.11默认使用hyperkit，也可以使用Virtualbox作为Minishift VM driver。

如果已经安装Docker Desktop for Mac则不再需要再安装hyperkit，只需要修改文件权限：

sudo chmod u+s,+x /usr/local/bin/hyperkit

安装hyperkit:

# 安装hyperkit
    brew install hyperkit
    
    # 修改hyperkit文件所有者和权限
    sudo chown root:wheel /usr/local/opt/hyperkit/bin/hyperkit
    sudo chmod u+s,+x /usr/local/opt/hyperkit/bin/hyperkit
    
    # 验证
    hyperkit -h
    hyperkit -v

安装docker-machine-driver-hyperkit：

# 安装docker-machine-driver-hyperkit
    brew install docker-machine-driver-hyperkit
    
    # 修改docker-machine-driver-hyperkit文件所有者和权限
    sudo chown root:wheel /usr/local/opt/docker-machine-driver-hyperkit/bin/docker-machine-driver-hyperkit
    sudo chmod u+s,+x /usr/local/opt/docker-machine-driver-hyperkit/bin/docker-machine-driver-hyperkit

## 安装Minishift ##

# 安装Minishift
    brew cask install minishift

查看Minishift版本：

minishift version

(可选)更新Minishift到最新版本：

# 如果不是最新版本，可更新Minishift到最新版本
    brew cask install --force minishift

## 创建Minishift虚拟机和部署OpenShift集群 ##

配置Minishift参数：

# 查看Minishift配置
    minishift config view
    
    # 配置Minishift参数
    # 跳过OpenShift版本检查
    minishift config set skip-check-openshift-release true

> 如果使用Virtualbox，可以先`minishift config set vm-driver virtualbox`

创建Minishift虚拟机并在Minishift虚拟机上部署OpenShift集群：

minishift start \
    --registry-mirror=https://5twf62k1.mirror.aliyuncs.com \
    --show-libmachine-logs \
    -v 5

说明：

*  `--registry-mirror` 可使用阿里云镜像加速器加快拉取OpenShift镜像速度
 *  `--show-libmachine-logs` 打印`libmachine`日志
 *  `-v 5` 日志级别为5，打印更详细的日志信息

> 可运行`minishift start --help`查看详细参数说明。

查看Minishift状态：

minishift status

## 访问OpenShift集群 ##

### 创建集群管理员账号 ###

创建名为admin的集群管理员账号：

oc login -u system:admin
    oc adm policy add-cluster-role-to-user cluster-admin admin

### 访问OpenShift Web Console ###

运行`minishift console`，将会自动打开浏览器来访问OpenShift Web Console。也可以运行`minishift console --url`来获取OpenShift Web Console地址。

登录信息：

*  集群管理员：`admin / admin`。
 *  开发人员：`developer / developer`。

### 用oc命令行方式访问OpenShift ###

运行`minishift oc-env`来获取将`oc`添加到`PATH`环境变量中的指令。

在`~/.bash_profile` 中添加该指令，并运行`source ~/.bash_profile`让环境变量生效。

如果使用的是zsh，则需要在`~/.zshrc` 中添加该指令，并运行`source ~/.zshrc`让环境变量生效。

> 可运行`echo $SHELL`查看使用的Shell。

打开一个新的terminal，运行`oc version` 来查看oc版本。

用oc来访问Openshift：

# 以集群管理员登录
    oc login -u system:admin
    oc login -u admin -p admin
    
    # 以开发人员登录
    oc login -u developer -p developer

## 停止OpenShift集群 ##

停止OpenShift集群：

minishift stop

再次启动集群：

minishift start

更多Minishift命令参见：

*  [https://docs.okd.io/3.11/minishift/command-ref/minishift.html][https_docs.okd.io_3.11_minishift_command-ref_minishift.html]

## Troubleshooting ##

### Homebrew相关问题 ###

在MacOS上将Homebrew替换为清华大学镜像。

git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
    git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
    git -C "$(brew --repo homebrew/cask-fonts)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask-fonts.git
    git -C "$(brew --repo homebrew/cask-drivers)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask-drivers.git
    git -C "$(brew --repo homebrew/cask-versions)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask-versions.git
    
    
    echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc
    source ~/.zshrc

参见：

*  [https://mirrors.tuna.tsinghua.edu.cn/help/homebrew-bottles/][https_mirrors.tuna.tsinghua.edu.cn_help_homebrew-bottles]
 *  [https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/][https_mirrors.tuna.tsinghua.edu.cn_help_homebrew]

### Checking if requested OpenShift version ‘v3.11.0’ is valid … v3.11.0 is not a valid OpenShift versionFAIL ###

跳过检查OpenShift版本：

minishift config set skip-check-openshift-release true

### Checking for setuid bit … FAIL ###

需要按照文档先设置好虚拟机环境。

参见：

*  [https://docs.okd.io/3.11/minishift/getting-started/setting-up-virtualization-environment.html][https_docs.okd.io_3.11_minishift_getting-started_setting-up-virtualization-environment.html]

# 修改hyperkit的文件所有者和权限
    sudo chown root:wheel /usr/local/opt/hyperkit/bin/hyperkit
    sudo chmod u+s,+x /usr/local/opt/hyperkit/bin/hyperkit
    
    
    # 修改docker-machine-driver-hyperkit文件所有者和权限
    sudo chown root:wheel /usr/local/opt/docker-machine-driver-hyperkit/bin/docker-machine-driver-hyperkit
    sudo chmod u+s,+x /usr/local/opt/docker-machine-driver-hyperkit/bin/docker-machine-driver-hyperkit

> 具体的hyperkit的路径以`minishift start` 日志为准。

### Error starting the cluster: Error attempting to download and cache ‘oc’: Cannot get the OpenShift release version v3.11.0: Get “https://api.github.com/repos/openshift/origin/releases/tags/v3.11.0”: dial tcp 13.250.168.23:443: connect: connection refused ###

确保可以连接外网，且网速较快，最好有正确上网方式。

如果切换了网络，需要重新开一个Terminal，有时候切换网络后原Terminal没有生效。

### 下载oc和iso很慢 ###

可以提前下载好oc （OpenShift Client）和iso（minishift-centos7.iso)上传到minishift的cache目录。

以Mac OS为例：

mkdir -p ~/.minishift/cache/iso/centos/v1.17.0/
    cp minishift-centos7.iso ~/.minishift/cache/iso/centos/v1.17.0/
    
    mkdir -p ~/.minishift/cache/oc/v3.11.0/darwin/
    cp oc ~/.minishift/cache/oc/v3.11.0/darwin/

**oc:**

下载oc：[https://github.com/openshift/origin/releases/tag/v3.11.0][https_github.com_openshift_origin_releases_tag_v3.11.0]

minishift的cache目录：

# Mac OS
    ~/.minishift/cache/oc/v3.11.0/darwin/
    
    # CentOS
    ~/.minishift/cache/oc/v3.11.0/linux/
    
    # Windows
    ~/.minishift/cache/oc/v3.11.0/windows/

**ISO**

下载iso：[https://github.com/minishift/minishift-centos-iso/releases/download/v1.17.0/minishift-centos7.iso][https_github.com_minishift_minishift-centos-iso_releases_download_v1.17.0_minishift-centos7.iso]

minishift的cache目录：

~/.minishift/cache/iso/centos/v1.17.0/

### 拉取OpenShift镜像很慢 ###

第一次用`minishift start`部署OpenShift集群时，会从Docker Hub拉取以下OpenShift镜像：

docker.io/openshift/origin-cli:v3.11.0
    docker.io/openshift/origin-control-plane:v3.11.0
    docker.io/openshift/origin-deployer:v3.11.0
    docker.io/openshift/origin-docker-registry:v3.11.0
    docker.io/openshift/origin-haproxy-router:v3.11.0
    docker.io/openshift/origin-hyperkube:v3.11.0
    docker.io/openshift/origin-hypershift:v3.11.0
    docker.io/openshift/origin-node:v3.11.0
    docker.io/openshift/origin-pod:v3.11.0
    docker.io/openshift/origin-service-serving-cert-signer:v3.11
    docker.io/openshift/origin-web-console:v3.11.0

这些镜像比较大，因此需要一段时间才可以拉取完成。

可以在另外一个terminal运行`minishift image list --vm`来查看已经拉取了哪些镜像。也可以通过`minishift ssh`进入Minishift虚拟机后，运行`docker images`查看拉取的镜像。

可在`minishift start`中使用`--registry-mirror` 来使用阿里云镜像加速器来加快拉取镜像速度。

### Minishift start失败 ###

如果`minishift start` 失败中断，可以先运行`minishift stop`停止集群，再重新运行`minishift start`。

### 重新安装Minishift虚拟机和部署OpenShift集群 ###

先删除Minishift虚拟机和OpenShift集群，并清除缓存：

minishift delete --force --clear-cache

再重新运行`minishift start`安装和部署。

### Temporary Error: Could not find an IP address ###

从Mac OS 10.12 升级到 10.15 后出现该问题。

参见：

*  [https://github.com/kubernetes/minikube/issues/4206][https_github.com_kubernetes_minikube_issues_4206]

尝试了上面连接提到的方法，重新安装有时候可以，但是有时候又不行；退出代理，不行。

最后采用安装[Virtualbox][]，然后用Virtualbox作为Minishift VM driver。

# 先删除Minishift VM
    minishift delete --force --clear-cache
    rm -r ~/.kube
    
    # 重新创建Minishift VM和部署OpenShift集群
    minishift start \
    --vm-driver=virtualbox \
    --registry-mirror=https://5twf62k1.mirror.aliyuncs.com \
    --show-libmachine-logs \
    -v 5

打开Mac上的系统偏好设置，打开“安全性与隐私”，允许运行`oc`程序。

### oc login -u system:admin 需要密码 ###

参见：

*  [https://github.com/minishift/minishift/issues/2601\#issuecomment-550075637][https_github.com_minishift_minishift_issues_2601_issuecomment-550075637]

# 进入Minishift VM
    minishift ssh
    
    # 在Minishift VM上
    # 默认为docker用户，切换到root用户
    sudo su -
    # 以root用户运行
    export KUBECONFIG=/var/lib/minishift/base/openshift-apiserver/admin.kubeconfig PATH="$PATH:/var/lib/minishift/bin"
    # 创建一个admin用户，角色为集群管理员cluster-admin
    oc adm policy add-cluster-role-to-user cluster-admin admin
    # 退出root
    exit
    # 退出Minishift VM
    exit
    
    # 在宿主机上
    # 也可以不输入admin用户的密码
    oc login -u admin -p admin
    # 查看nodes（集群管理员才有该权限）
    oc get nodes
    # 查看projects（集群管理员才能看到系统projects）
    oc projects

### 删除Minishift VM后再次启动很慢 ###

删除Minishift VM后，再次启动Minishift VM Docker daemon需要再次拉取OpenShift镜像，所以很慢。  
可以导出相应的OpenShift镜像在宿主机的`~/.minishift/cache/images`中，再次启动Minishift VM时会自动导入这些缓存的镜像，以加快速度。

参见：

*  [https://docs.okd.io/3.11/minishift/using/image-caching.html][https_docs.okd.io_3.11_minishift_using_image-caching.html]

# enable image caching
    minishift config set image-caching true
    
    # export images from Minishift VM to host
    minishift image export docker.io/openshift/origin-cli:v3.11.0 \
      docker.io/openshift/origin-control-plane:v3.11.0 \
      docker.io/openshift/origin-deployer:v3.11.0 \
      docker.io/openshift/origin-docker-registry:v3.11.0 \
      docker.io/openshift/origin-haproxy-router:v3.11.0 \
      docker.io/openshift/origin-hyperkube:v3.11.0 \
      docker.io/openshift/origin-hypershift:v3.11.0 \
      docker.io/openshift/origin-node:v3.11.0 \
      docker.io/openshift/origin-pod:v3.11.0 \
      docker.io/openshift/origin-service-serving-cert-signer:v3.11 \
      docker.io/openshift/origin-web-console:v3.11.0 \
      openshift/origin-control-plane:v3.11.0 \
      openshift/origin-docker-registry:v3.11.0 \
      openshift/origin-haproxy-router:v3.11.0

### Minishift Web Console打不开 ###

在资源不够时OpenShift API server会退出，导致Minishift web console打不开，即使运行`minishift status`查看集群状态仍然为Running，但是运行`oc get nodes`已获取不到信息。

解决方法：加大Minishift VM的内存和CPU，默认为2核4GB，再重启Minishift。

minishift config set cpus 4
    minishift config set memory 8GB

如果仍然有问题，只能在有问题时再重启Minishift。因为Minishift是单节点集群，跑的Pod一多，资源就不够了，就会导致API server退出。

## 参考文档 ##

*  [How to setup OpenShift Locally on Mac OS][]
 *  [快速搭建指南 - Minishift][- Minishift]
 *  [搭建OpenShift单机集群 —— Minishift 安装指南][OpenShift_ _ Minishift]
 *  [OpenShift Installation on your Local Windows Machine | Minishift | VirtualBox][OpenShift Installation on your Local Windows Machine _ Minishift _ VirtualBox]

[https_docs.okd.io_3.11_minishift_getting-started_preparing-to-install.html]: https://docs.okd.io/3.11/minishift/getting-started/preparing-to-install.html
[https_www.okd.io_minishift]: https://www.okd.io/minishift/
[https_github.com_minishift_minishift]: https://github.com/minishift/minishift
[https_www.openshift.com_blog_minishift-enterprise-installation]: https://www.openshift.com/blog/minishift-enterprise-installation
[https_github.com_minishift_minishift_releases]: https://github.com/minishift/minishift/releases
[https_docs.okd.io_3.11_minishift_command-ref_minishift.html]: https://docs.okd.io/3.11/minishift/command-ref/minishift.html
[https_mirrors.tuna.tsinghua.edu.cn_help_homebrew-bottles]: https://mirrors.tuna.tsinghua.edu.cn/help/homebrew-bottles/
[https_mirrors.tuna.tsinghua.edu.cn_help_homebrew]: https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/
[https_docs.okd.io_3.11_minishift_getting-started_setting-up-virtualization-environment.html]: https://docs.okd.io/3.11/minishift/getting-started/setting-up-virtualization-environment.html
[https_github.com_openshift_origin_releases_tag_v3.11.0]: https://github.com/openshift/origin/releases/tag/v3.11.0
[https_github.com_minishift_minishift-centos-iso_releases_download_v1.17.0_minishift-centos7.iso]: https://github.com/minishift/minishift-centos-iso/releases/download/v1.17.0/minishift-centos7.iso
[https_github.com_kubernetes_minikube_issues_4206]: https://github.com/kubernetes/minikube/issues/4206
[Virtualbox]: https://www.virtualbox.org/
[https_github.com_minishift_minishift_issues_2601_issuecomment-550075637]: https://github.com/minishift/minishift/issues/2601#issuecomment-550075637
[https_docs.okd.io_3.11_minishift_using_image-caching.html]: https://docs.okd.io/3.11/minishift/using/image-caching.html
[How to setup OpenShift Locally on Mac OS]: https://medium.com/swlh/how-to-setup-openshift-locally-on-mac-os-a3b7eb5a5151#:~:text=%20How%20to%20setup%20OpenShift%20Locally%20on%20Mac,Now%20you%20can%20play%20with%20i...%20More%20
[- Minishift]: https://www.jianshu.com/p/77ef3c107580
[OpenShift_ _ Minishift]: https://my.oschina.net/johntostring/blog/814099
[OpenShift Installation on your Local Windows Machine _ Minishift _ VirtualBox]: https://www.youtube.com/watch?v=SUh2mRqDRi4