はじめに
OpenShift上でOperatorを使って、さまざまなアプリケーションを動かしてみたいと思い、まずは検証環境としてWindows PC上に**OpenShift Local（CRC）**を構築することにしました。
今回は、その第一歩としてAnsible Automation Platform（AAP）OperatorをOpenShiftへ導入してみます。
今後は、以下の流れでOpenShift上に構築した環境を使って、AAPやAutomation Orchestratorなどを実際に動かしていく予定です。
- OpenShift Localの導入～AAP Operator導入 ★今回はコチラ！
- AAPのセットアップ～プレイブックを実行してみる
- Automation Orchestratorを動かしてみる
- Automation OrchestratorにAAPを取り込み、OS操作する
- Automation OrchestratorにAIを取り込み、OS操作する
OpenShiftにはさまざまな構築方法がありますが、本格的なクラスタを構築しようとすると、複数台の仮想マシンやネットワーク、DNSなどの準備が必要になります。
一方、OpenShift Localを利用すると、1台のPC上にシングルノードのOpenShift環境を比較的簡単に構築できます。
今回は、Windows PCへのOpenShift Localの導入から、OpenShiftクラスタの起動、AAP Operatorのインストールまでを試してみます。
途中、AAP Operatorのインストールがリソース不足と思われる状態で失敗したため、OpenShift Localへ割り当てるCPU・メモリ・ディスク容量を変更した手順についても紹介します。
この記事では以下を実施します。
Windows PCへのOpenShift Localのインストール
OpenShift Localのセットアップ
OpenShiftクラスタの起動
AAP Operatorのインストール
AAP Operatorのインストール失敗
OpenShift LocalのCPU・メモリ・ディスク容量の拡張
AAP Operatorが正常に起動したことの確認
ローカルPC上でOpenShiftを試してみたい方や、Operatorを使ったアプリケーション導入を試してみたい方の参考になればと思います。
Operatorは、Kubernetes/OpenShift上で動作するアプリケーションのインストールや設定、ライフサイクル管理を自動化する仕組みです。
AAP Operatorを利用することで、Ansible Automation PlatformをOpenShift上へOperator経由で導入・管理できます。
検証環境
今回使用した環境は以下です。
| 項目 | 内容 |
|---|---|
| ホストOS | Windows 11 |
| 仮想化 | Hyper-V |
| ホストメモリ | 32GB |
| CRC | 2.63.0 |
| OpenShift | 4.22.7 |
| MicroShift | 4.22.0 |
| OpenShift Local初期CPU | 4 CPU |
| OpenShift Local初期メモリ | 10,752MB |
| OpenShift Local初期ディスク | 31GB |
AAP Operator導入時にリソース不足が発生したため、最終的にはOpenShift Localへ以下を割り当てています。
| リソース | 変更後 |
|---|---|
| CPU | 16 |
| メモリ | 20,480MB（20GB） |
| ディスク | 128GB |
OpenShift Localの導入
OpenShift Localをダウンロードする
以下のRed HatサイトからOpenShift Localをダウンロードします。
「OpenShift Localをダウンロード」をクリックしてインストーラを取得します。
また、後ほどOpenShiftクラスタを起動するときに必要になるため、同じ画面からPull Secretも取得しておきます。
OpenShift Localをインストールする
ダウンロードしたMSIファイルを実行します。
インストーラの案内に従って進めます。
インストール後にWindowsを再起動します。
OpenShift Localのセットアップ
バージョンを確認する
コマンドプロンプトを開いて、以下を実行します。
C:\Users\<USER>>crc version
CRC version: 2.63.0+3a67a3
OpenShift version: 4.22.7
MicroShift version: 4.22.0
CRCとOpenShiftのバージョンが表示されれば、インストールできています。
crc setupを実行する
続いてOpenShift Localを利用するための初期セットアップを行います。
C:\Users\<USER>>crc setup
実行すると、Hyper-Vや必要なWindowsサービス、CRC用VMイメージなどの確認・準備が行われます。
今回の環境では以下のようになりました。
INFO Using bundle path C:\Users\<USER>\.crc\cache\crc_hyperv_4.22.7_amd64.crcbundle
INFO Checking minimum RAM requirements
INFO Checking if running in a shell with administrator rights
INFO Checking Windows release
INFO Checking Windows edition
INFO Checking if Hyper-V is installed and operational
INFO Checking if Hyper-V service is enabled
INFO Checking if crc-users group exists
INFO Checking if current user is in crc-users and Hyper-V admins group
INFO Checking if vsock is correctly configured
INFO Getting bundle for the CRC executable
INFO Downloading bundle: C:\Users\<USER>\.crc\cache\crc_hyperv_4.22.7_amd64.crcbundle...
5.81 GiB / 5.81 GiB [...] 100.00%
INFO Uncompressing C:\Users\<USER>\.crc\cache\crc_hyperv_4.22.7_amd64.crcbundle
INFO Checking if the win32 background launcher is installed
INFO Checking if the daemon task is installed
INFO Installing the daemon task
INFO Running the daemon task
INFO Checking SSH port availability
Your system is correctly setup for using CRC.
Use 'crc start' to start the instance
以下が表示されればセットアップ完了です。
Your system is correctly setup for using CRC.
OpenShiftクラスタを起動する
以下を実行します。
crc start
初回起動時は、Red HatのPull Secretの入力を求められます。
CRC requires a pull secret to download content from Red Hat.
? Please enter the pull secret
OpenShift Localをダウンロードした際に取得したPull Secretを貼り付けます。
しばらくするとCRC VMとOpenShiftクラスタが起動します。
INFO Creating CRC VM for OpenShift 4.22.7...
INFO Generating new SSH key pair...
INFO Generating new password for the kubeadmin user
INFO Starting CRC VM for openshift 4.22.7...
INFO CRC VM is running
...
INFO All operators are available. Ensuring stability...
INFO Operators are stable (3/3)...
Started the OpenShift cluster.
最後にWebコンソールのURLなどが表示されます。
The server is accessible via web console at:
https://console-openshift-console.apps-crc.testing
Log in as administrator:
Username: kubeadmin
Password: <MASKED>
Log in as user:
Username: developer
Password: <MASKED>
ブラウザから以下へアクセスします。
https://console-openshift-console.apps-crc.testing
これでローカルPC上のOpenShiftクラスタを操作できるようになりました。
AAP Operatorをインストールする
AAP Operatorのインストールについては、Red Hat公式ドキュメントを参考にしました。
まずは、前章で作成したOpenShift Webコンソールへアクセスします。
https://console-openshift-console.apps-crc.testing
ログインします。
OpenShift Webコンソールから、
エコシステム → ソフトウェアカタログ
を開き、「Ansible」で検索します。
表示されたAnsible Automation Platformを選択します。
「インストール」をクリックします。
設定内容を確認し、もう一度「インストール」をクリックします。
これでOperatorのインストールが開始されます。
AAP Operatorのインストールに失敗
順調に進むと思っていたのですが、ここでAAP Operatorのインストールに失敗しました。
原因を確認するため、OpenShift Localへ割り当てているリソースを確認してみます。
OpenShift Localのリソースを確認する
まずOpenShiftへログインします。
oc login -u kubeadmin -p <KUBEADMIN_PASSWORD> https://api.crc.testing:6443
Login successful.
You have access to 66 projects, the list has been suppressed.
Using project "default".
ログインユーザーを確認します。
oc whoami
kubeadmin
続いてOpenShift Localの状態を確認します。
crc status
今回の環境では以下の状態でした。
CRC VM: Running
OpenShift: Running (v4.22.7)
RAM Usage: 8.085GB of 10.95GB
Disk Usage: 27.21GB of 32.68GB (Inside the CRC VM)
Cache Usage: 30.75GB
Cache Directory: C:\Users\<USER>\.crc\cache
特にディスクは、
27.21GB of 32.68GB
と、かなり使用されている状態でした。
設定値も確認します。
crc config get cpus
crc config get memory
crc config get disk-size
結果は以下です。
Configuration property 'cpus' is not set. Default value '4' is used
Configuration property 'memory' is not set. Default value '10752' is used
Configuration property 'disk-size' is not set. Default value '31' is used
つまりデフォルトでは、
- CPU：4
- メモリ：約10.5GB
- ディスク：31GB
が割り当てられていました。
ホストPCには32GBのメモリを搭載しているため、検証用途としてはまだOpenShift Localへ追加リソースを割り当てられそうです。
また、ディスクについても空き容量がかなり少なくなっていました。
OpenShift Localへ割り当てるリソースを増やす
AAPのOpenShift環境に関する要件については、Red Hatのドキュメントも確認しました。
まずOpenShift Localを停止します。
crc stop
今回は以下のようにリソースを変更しました。
crc config set cpus 16
crc config set memory 20480
crc config set disk-size 128
変更後は以下となります。
| リソース | 変更前 | 変更後 |
|---|---|---|
| CPU | 4 | 16 |
| メモリ | 10,752MB | 20,480MB |
| ディスク | 31GB | 128GB |
今回のPCはメモリ32GBのため、ホストOS側の利用分を残してOpenShift Localには20GBを割り当てました。
今回CPU・メモリ・ディスクをまとめて増やしたため、AAP Operatorのインストール失敗原因を特定の1リソースだけに断定することはできません。
ただし変更前はディスク使用量が約27GB / 32.68GBまで増えており、ディスク容量に余裕が少ない状態でした。
この点は、今回のトラブルシューティングで特に重要でした。
OpenShift Localを再起動する
設定変更後、再度OpenShift Localを起動します。
crc start
INFO Using bundle path C:\Users\<USER>\.crc\cache\crc_hyperv_4.22.7_amd64.crcbundle
INFO Checking minimum RAM requirements
INFO Checking if Hyper-V is installed and operational
INFO Loading bundle: crc_hyperv_4.22.7_amd64...
INFO Starting CRC VM for openshift 4.22.7...
INFO CRC VM is running
...
INFO All operators are available. Ensuring stability...
INFO Operators are stable (3/3)...
Started the OpenShift cluster.
OpenShiftクラスタが正常に起動しました。
AAP Operatorの起動を確認する
OpenShift Webコンソールへ戻ってOperatorの状態を確認します。
今度はAAP OperatorのステータスがSucceededになりました。
さらにトポロジー画面を確認すると、AAP Operator関連のPodが起動していることも確認できました。
これでAAP Operatorのインストールは完了です。
今回の構成
今回作成した環境を簡単に整理すると、以下のような構成です。
Windows 11
│
└─ Hyper-V
│
└─ OpenShift Local（CRC）
│
└─ OpenShift 4.22.7
│
└─ AAP Operator
1台のWindows PCだけで、
OpenShiftの構築 → Operatorのインストール
まで試すことができました。
本番OpenShift環境とは構成や可用性などが大きく異なりますが、OperatorやOpenShiftの操作を学習するための検証環境としては便利だと感じました。
おわりに
今回は、Windows PC上にOpenShift Localを構築し、Ansible Automation Platform（AAP）OperatorをOpenShiftへ導入するところまで試してみました。
途中、AAP Operatorのインストールに失敗しましたが、OpenShift Localに割り当てているCPU・メモリ・ディスク容量を見直し、リソースを増やすことで最終的にOperatorが正常に起動するところまで確認できました。
今回の検証を通して、1台のWindows PCでもOpenShift Localを利用することで、OpenShiftの構築からOperatorを利用したアプリケーションの導入まで試せることが分かりました。
次回は、今回導入したAAP Operatorを使って、AAPのセットアップから実際にプレイブックを実行するところまで進めてみたいと思います。
この後も、Automation Orchestratorとの連携やAIの活用など、OpenShift上でいろいろ動かしながら試していく予定です。
OpenShiftやOperator、AAPを実際に触りながら学んでみたい方の参考になれば幸いです。