LoginSignup
15
12

More than 3 years have passed since last update.

OpenShiftAdvent Calendar 2019Day 14
@yurak

OpenShift 4 をMacにインストールする

Last updated at Posted at 2019-09-13

Summary

OpenShift 3.x 系を Mac にインストールするには、Red Hat Container Development Kit (CDK) か Minishift で可能でしたが、OpenShift 4.x 系から方法が変わりました。
Code Ready Containers (CRC) を用いて、OpenShift 4.1 を Mac にインストールします。

システム要件

# Prerequisites
vCPUs 4 virtual CPUs
memory 8 GB
storage space 35 GB

動作環境

MacBook Proの情報です。

$ system_profiler SPHardwareDataType
Model Name: MacBook Pro
Model Identifier: MacBookPro14,3
Processor Name: Intel Core i7
Processor Speed: 2.9 GHz
Number of Processors: 1
Total Number of Cores: 4
Memory: 16 GB

以下は、インストール完了後に取得しています。

$ crc version
version: 1.0.0-beta.3-4.1.11+e97bf65

$ oc version
Client Version: v4.2.0
Server Version: 4.1.11
Kubernetes Version: v1.13.4+df9cebc

Code Ready Containers(CRC) のインストール

ダウンロードの前に、Red Hat Developer アカウントを作成する必要があります。
cloud.redhat.com にあるダウンロード先から .tar.xz ファイルをダウンロードします。

ダウンロードの後に、 tar xvf で解凍し、 PATH を通します。
以下の場合、PATHの通っているディレクトリはcrcファイルを移動しています。

$ tar xvf crc-macos-amd64.tar.xz
x crc-macos-1.0.0-beta.3-amd64/
x crc-macos-1.0.0-beta.3-amd64/LICENSE
x crc-macos-1.0.0-beta.3-amd64/doc.pdf
x crc-macos-1.0.0-beta.3-amd64/crc

$ mv crc-macos-1.0.0-beta.3-amd64/crc /usr/local/bin/.

CRCの環境構成

crc setupで環境設定を事前に行います。
~/.crc ディレクトリが作成されます。

$ crc setup
INFO Caching oc binary
INFO Setting up virtualization with HyperKit
Password:
INFO Installing crc-machine-hyperkit
INFO Setting file permissions for /etc/resolver/testing
INFO Setting file permissions for /etc/hosts
INFO Unpacking bundle from the CRC binary

$ ls ~/.crc
bin
crc.json
crc.log
crc_hyperkit_4.1.11.crcbundle

OpenShift 4.1 クラスタの開始

crc start で開始を行いますと、Image pull secret を聞かれます。

$ crc start
INFO Checking if oc binary is cached
INFO Checking if HyperKit is installed
INFO Checking if crc-driver-hyperkit is installed
INFO Checking file permissions for /etc/resolver/testing
INFO Checking file permissions for /etc/hosts
INFO Checking if CRC bundle is cached in '$HOME/.crc'
? Image pull secret [? for help]

先ほどのcloud.redhat.com にあるダウンロード先 下部にある Copy Pull Secret をクリック/コピーし、待っているプロンプトへ添付します。
スクリーンショット 2019-09-14 0.09.50.png

INFO Loading bundle: crc_hyperkit_4.1.11.crcbundle ... 
INFO Extracting bundle: crc_hyperkit_4.1.11.crcbundle ...
INFO Creating VM ...
INFO Verifying validity of the cluster certificates ...
INFO Restarting the host network
INFO Check internal and public dns query ...
INFO Copying kubeconfig file to instance dir ...
INFO Adding user's pull secret and cluster ID ... 
INFO Starting OpenShift cluster ... [waiting 3m]
INFO To access the cluster using 'oc', run 'eval $(crc oc-env) && oc login -u kubeadmin -p ************************ https://api.crc.testing:6443'
INFO Access the OpenShift web-console here: https://console-openshift-console.apps-crc.testing 
INFO Login to the console with user: kubeadmin, password: ************************
CodeReady Containers instance is running

crc start のコマンド発行から完了まで10分はかからなかったです。

起動確認

oc login を確認します。
クラスタへのアクセスのためのアクションが crc start の標準出力に出ていますのでこれを実行します。

$ 'eval $(crc oc-env) && oc login -u kubeadmin -p ************************ https://api.crc.testing:6443'
The server uses a certificate signed by an unknown authority.
You can bypass the certificate check, but any data you send to the server could be intercepted by others.
Use insecure connections? (y/n): y

Login successful.

You have access to the following projects and can switch between them with 'oc project <projectname>':

  * default
    kube-public
    kube-system
    openshift
    openshift-apiserver
    openshift-apiserver-operator
    openshift-authentication
    openshift-authentication-operator
    openshift-cloud-credential-operator
    openshift-cluster-machine-approver
    openshift-cluster-node-tuning-operator
    openshift-cluster-samples-operator
    openshift-cluster-storage-operator
    openshift-cluster-version
    openshift-config
    openshift-config-managed
    openshift-console
    openshift-console-operator
    openshift-controller-manager
    openshift-controller-manager-operator
    openshift-dns
    openshift-dns-operator
    openshift-etcd
    openshift-image-registry
    openshift-infra
    openshift-ingress
    openshift-ingress-operator
    openshift-kube-apiserver
    openshift-kube-apiserver-operator
    openshift-kube-controller-manager
    openshift-kube-controller-manager-operator
    openshift-kube-scheduler
    openshift-kube-scheduler-operator
    openshift-machine-api
    openshift-machine-config-operator
    openshift-marketplace
    openshift-monitoring
    openshift-multus
    openshift-network-operator
    openshift-node
    openshift-operator-lifecycle-manager
    openshift-operators
    openshift-sdn
    openshift-service-ca
    openshift-service-ca-operator
    openshift-service-catalog-apiserver-operator
    openshift-service-catalog-controller-manager-operator

Using project "default".

次に、Webコンソールへアクセスしてみます。
Webコンソールへのアクセスのためのアクションが crc start の標準出力に出ていますのでこれを実行します。
https://console-openshift-console.apps-crc.testing
user: kubeadmin, password: ************************

スクリーンショット 2019-09-14 0.32.47.png

画面が出力されれば確認完了です。

Next

他にもサービスが提供されているようなので、試していきたいですね。

$ oc get route --all-namespaces=true
NAMESPACE                  NAME                HOST/PORT                                                 PATH   SERVICES            PORT    TERMINATION            WILDCARD
openshift-authentication   oauth-openshift     oauth-openshift.apps-crc.testing                                 oauth-openshift     6443    passthrough/Redirect   None
openshift-console          console             console-openshift-console.apps-crc.testing                       console             https   reencrypt/Redirect     None
openshift-console          downloads           downloads-openshift-console.apps-crc.testing                     downloads           http    edge                   None
openshift-image-registry   default-route       default-route-openshift-image-registry.apps-crc.testing          image-registry      <all>   reencrypt              None
openshift-monitoring       alertmanager-main   alertmanager-main-openshift-monitoring.apps-crc.testing          alertmanager-main   web     reencrypt/Redirect     None
openshift-monitoring       grafana             grafana-openshift-monitoring.apps-crc.testing                    grafana             https   reencrypt/Redirect     None
openshift-monitoring       prometheus-k8s      prometheus-k8s-openshift-monitoring.apps-crc.testing             prometheus-k8s      web     reencrypt/Redirect     None

Tips

crc start 時に /etc/hosts に追記しています。

192.168.64.13 api.crc.testing oauth-openshift.apps-crc.testing

CRC で作成される node は RHEL7.7 のようです。

$ oc get nodes
NAME                 STATUS   ROLES           AGE   VERSION
crc-56mmj-master-0   Ready    master,worker   21d   v1.13.4+d81afa6ba
$ oc debug nodes/crc-56mmj-master-0

# cat /etc/redhat-release
Red Hat Enterprise Linux Server release 7.7 (Maipo)

Troubleshooting

あるとき証明書期限切れのエラーが出るようになりました。
ERRO Error occurred: Certs have expired, they were valid till: 23 Sep 19 12:25 +0000

Guideをよくよく読むと、30日で切れるようです。

You are using the latest CodeReady Containers release The generated certificates for the embedded system image bundle expire after 30 days. Using an older system image bundle may result in errors related to expired x509 certificates.

commit log に対応方法が記載されています。
要するに最新の crc に置き換えれば良いので、Code Ready Containers(CRC) のインストールをもう一度行います。

$ crc version
$ crc version
version: 1.0.0-beta.5+f2aa58c
OpenShift version: 4.1.14 (embedded in binary)

バージョンがあがり、上記エラーは解消されました。

参考

https://developers.redhat.com/blog/2019/09/05/red-hat-openshift-4-on-your-laptop-introducing-red-hat-codeready-containers/
https://www.jeffgeerling.com/blog/2019/trying-out-crc-code-ready-containers-run-openshift-4x-locally

Youtubeに動画があります。
https://youtu.be/qogFjV2fJNs

15
12
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
15
12