<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p>まず、Red Hat CodeReady Containers の話をする前にそもそも OpenShift とは、一言でいうとエンタープライズ Kubernetes プラットフォームです。Kubernetes と比較して CI/CD など運用面での便利な機能が付いているのが特徴です。詳しい特徴については下記の URL をご覧ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__e032786d93a01" src="https://embed.zenn.studio/card#zenn-embedded__e032786d93a01" data-content="https%3A%2F%2Fwww.redhat.com%2Fja%2Ftechnologies%2Fcloud-computing%2Fopenshift" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.redhat.com/ja/technologies/cloud-computing/openshift" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.redhat.com/ja/technologies/cloud-computing/openshift</a></p>
<p>その OpenShift ですが、とりあえずローカルで触ってみたいと考え見つけたのが、今回紹介する Red Hat CodeReady Containers（以下 CRC）です。</p>
<h1 id="%E7%92%B0%E5%A2%83">
<a class="header-anchor-link" href="#%E7%92%B0%E5%A2%83" aria-hidden="true"></a> 環境</h1>
<p>今回導入した環境は以下になります。</p>
<table>
<thead>
<tr>
<th style="text-align:center">key</th>
<th style="text-align:center">value</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:center">OS</td>
<td style="text-align:center">macOS Moneterey 12.2.1</td>
</tr>
<tr>
<td style="text-align:center">Shell</td>
<td style="text-align:center">zsh</td>
</tr>
</tbody>
</table>
<p>また <a href="https://crc.dev/crc/" target="_blank" rel="nofollow noopener noreferrer">ドキュメント</a> には、動作環境の Minimum system requirements として下記を備えておく必要があると記載されています。</p>
<ul>
<li>4 vCPU</li>
<li>9 GB メモリ</li>
<li>35 GB ディスク容量</li>
</ul>
<h1 id="%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89">
<a class="header-anchor-link" href="#%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89" aria-hidden="true"></a> ダウンロード</h1>
<p>事前に Red Hat アカウントを作成した上で、ダウンロードしていきます。<a href="https://console.redhat.com/openshift/create/local" target="_blank" rel="nofollow noopener noreferrer">ダウンロードサイト</a> にアクセスするとログインが求められるので Red Hat アカウントを持っていない場合は作成して、今回は macOS 用（お使いのマシンにあったもの）をダウンロードします。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/4f0b302801eb-20220303.png" alt loading="lazy" class="md-img"></p>
<p>ダウンロードにはしばらく時間がかかります。<br>
待っている間に Secret 情報をコピー or ダウンロードし、ローカルに保存しておきます。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/2230d598713b-20220303.png" alt loading="lazy" class="md-img"></p>
<p>ダウンロードが終了したらインストーラを開くので、指示に従って進めていきます。それが終わると以下のようなメッセージが表示されるので、続きは CUI でセットアップしていきます。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/2153f2c48ffa-20220303.png" alt loading="lazy" class="md-img"></p>
<h1 id="%E5%88%9D%E6%9C%9F%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97">
<a class="header-anchor-link" href="#%E5%88%9D%E6%9C%9F%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97" aria-hidden="true"></a> 初期セットアップ</h1>
<p>まず CRC コマンドを使えるか確認します。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ crc version
CodeReady Containers version: <span class="token number">1.40</span>.0+5966df09
OpenShift version: <span class="token number">4.9</span>.18 <span class="token punctuation">(</span>bundle installed at /Applications/CodeReady Containers.app/Contents/Resources/crc_hyperkit_4.9.18.crcbundle<span class="token punctuation">)</span>
</code></pre></div><p>OpenShift 4.9.18 に対応した CRC がインストールされているのが分かります。</p>
<p>余談ですが、いつの間にか mac の画面トップのメニューバーにも OpenShift のアイコンが追加されていました。</p>
<h3 id="%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97">
<a class="header-anchor-link" href="#%E3%82%BB%E3%83%83%E3%83%88%E3%82%A2%E3%83%83%E3%83%97" aria-hidden="true"></a> セットアップ</h3>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ crc setup
INFO Checking <span class="token keyword">if</span> running as non-root
<span class="token punctuation">..</span>

（省略）

<span class="token punctuation">..</span>
Your system is correctly setup <span class="token keyword">for</span> using CodeReady Containers, you can now run <span class="token string">'crc start'</span> to start the OpenShift cluster
</code></pre></div><h3 id="openshift-%E3%82%AF%E3%83%A9%E3%82%B9%E3%82%BF%E3%82%92%E8%B5%B7%E5%8B%95">
<a class="header-anchor-link" href="#openshift-%E3%82%AF%E3%83%A9%E3%82%B9%E3%82%BF%E3%82%92%E8%B5%B7%E5%8B%95" aria-hidden="true"></a> OpenShift クラスタを起動</h3>
<p><code>PATH</code> には、Secret 情報を保存したファイルを指定します。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell"><span class="token comment"># CRC を起動</span>
$ crc start --pull-secret-file<span class="token operator">=</span><span class="token operator">&lt;</span><span class="token environment constant">PATH</span><span class="token operator">&gt;</span>
INFO Checking <span class="token keyword">if</span> running as non-root
<span class="token punctuation">..</span>

（省略）

<span class="token punctuation">..</span>
Started the OpenShift cluster.

The server is accessible via web console at:
  https://console-openshift-console.apps-crc.testing

Log <span class="token keyword">in</span> as administrator:
  Username: kubeadmin
  Password: r23rB-ZT5TB-SHKDF-rnhJd

Log <span class="token keyword">in</span> as user:
  Username: developer
  Password: developer

Use the <span class="token string">'oc'</span> <span class="token builtin class-name">command</span> line interface:
  $ <span class="token builtin class-name">eval</span> <span class="token variable"><span class="token variable">$(</span>crc oc-env<span class="token variable">)</span></span>
  $ oc login <span class="token parameter variable">-u</span> developer https://api.crc.testing:6443
</code></pre></div><p>CRC の起動が成功すると上記のように Web コンソールの URL や認証情報、OC コマンドの使い方が表示されます。</p>
<p>以上で macOS 上に CRC の導入方法の説明は終了です。これでローカルに気軽に OpenShift クラスタを作ることができるようになりました。</p>
<h1 id="%E3%82%88%E3%81%8F%E4%BD%BF%E3%81%86-crc-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%80%81tips">
<a class="header-anchor-link" href="#%E3%82%88%E3%81%8F%E4%BD%BF%E3%81%86-crc-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%80%81tips" aria-hidden="true"></a> よく使う CRC コマンド、Tips</h1>
<p>一通り CRC を触ってみたので、何回も使ったコマンドや知っておくと便利なことなどを残しておきます。</p>
<h2 id="%E3%82%AF%E3%83%A9%E3%82%B9%E3%82%BF%E3%81%AE%E8%B5%B7%E5%8B%95%E3%82%92%E7%A2%BA%E8%AA%8D">
<a class="header-anchor-link" href="#%E3%82%AF%E3%83%A9%E3%82%B9%E3%82%BF%E3%81%AE%E8%B5%B7%E5%8B%95%E3%82%92%E7%A2%BA%E8%AA%8D" aria-hidden="true"></a> クラスタの起動を確認</h2>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ crc status
CRC VM:          Running
OpenShift:       Running <span class="token punctuation">(</span>v4.9.18<span class="token punctuation">)</span>
Disk Usage:      <span class="token number">13</span>.6GB of <span class="token number">32</span>.74GB <span class="token punctuation">(</span>Inside the CRC VM<span class="token punctuation">)</span>
Cache Usage:     <span class="token number">25</span>.77GB
Cache Directory: /Users/<span class="token operator">&lt;</span>USER_NAME<span class="token operator">&gt;</span>/.crc/cache
</code></pre></div><h2 id="openshift-web-%E3%82%B3%E3%83%B3%E3%82%BD%E3%83%BC%E3%83%AB%E5%91%A8%E3%82%8A">
<a class="header-anchor-link" href="#openshift-web-%E3%82%B3%E3%83%B3%E3%82%BD%E3%83%BC%E3%83%AB%E5%91%A8%E3%82%8A" aria-hidden="true"></a> OpenShift Web コンソール周り</h2>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell"><span class="token comment"># Web コンソールを開く</span>
$ crc console
<span class="token comment"># OR</span>
$ crc dashboard

<span class="token comment"># Web コンソールの　URL のみを表示</span>
$ crc console <span class="token parameter variable">--url</span>
https://console-openshift-console.apps-crc.testing
</code></pre></div><h2 id="%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3">
<a class="header-anchor-link" href="#%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3" aria-hidden="true"></a> ログイン</h2>
<p><code>oc login</code> コマンドを使用して CRC で立ち上げたクラスタにログインできます。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell"><span class="token comment"># Developer ユーザとしてログイン</span>
$ oc login <span class="token parameter variable">-u</span> developer <span class="token parameter variable">-p</span> developer https://api.crc.testing:6443

<span class="token comment"># Admin ユーザとしてログイン</span>
$ oc login <span class="token parameter variable">-u</span> kubeadmin <span class="token parameter variable">-p</span> <span class="token operator">&lt;</span>PASSWORD<span class="token operator">&gt;</span> https://api.crc.testing:6443
</code></pre></div><p>kubeadmin のパスワードを忘れた場合は、下記のコマンドで確認できます。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ crc console <span class="token parameter variable">--credentials</span>
To login as a regular user, run <span class="token string">'oc login -u developer -p developer https://api.crc.testing:6443'</span><span class="token builtin class-name">.</span>
To login as an admin, run <span class="token string">'oc login -u kubeadmin -p abcd1234e5-ABC321-DEF654-a1b2c3 https://api.crc.testing:6443'</span>
</code></pre></div><h2 id="crc-%E3%81%AE%E5%81%9C%E6%AD%A2%E3%80%81%E5%89%8A%E9%99%A4">
<a class="header-anchor-link" href="#crc-%E3%81%AE%E5%81%9C%E6%AD%A2%E3%80%81%E5%89%8A%E9%99%A4" aria-hidden="true"></a> CRC の停止、削除</h2>
<p>かなりメモリを食うので使用しない場合は基本落としておいたほうが良いです。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell"><span class="token comment"># クラスタの停止</span>
$ crc stop
INFO Stopping kubelet and all containers<span class="token punctuation">..</span>
INFO Stopping the OpenShift cluster, this may take a few minutes<span class="token punctuation">..</span>
Stopped the OpenShift cluster

<span class="token comment"># クラスタの削除</span>
$ crc delete
o you want to delete the OpenShift cluster? <span class="token punctuation">[</span>y/N<span class="token punctuation">]</span>: y
Deleted the OpenShift cluster
</code></pre></div><h2 id="crc-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E8%A3%9C%E5%AE%8C">
<a class="header-anchor-link" href="#crc-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E8%A3%9C%E5%AE%8C" aria-hidden="true"></a> CRC コマンドの補完</h2>
<p>CRC には、シェルの補完機能もあります。<code>crc completion</code> コマンドを使ってお使いのシェルに合った設定ができます。以下 macOS, zsh の場合です。異なる環境の場合は、<code>crc completion -h</code> で確認してみてください。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ crc completion <span class="token function">zsh</span> <span class="token operator">&gt;</span> /usr/local/share/zsh/site-functions/_crc

<span class="token comment"># シェルを再読み込み</span>
$ <span class="token builtin class-name">exec</span> <span class="token environment constant">$SHELL</span> <span class="token parameter variable">-l</span>

$ crc <span class="token comment"># ここでタブキーを押下</span>
bundle      -- Manage CRC bundles
cleanup     -- Undo config changes
completion  -- generate the autocompletion script <span class="token keyword">for</span> the specified shell
config      -- Modify crc configuration
console     -- Open the OpenShift Web Console <span class="token keyword">in</span> the default browser
delete      -- Delete the OpenShift cluster
<span class="token builtin class-name">help</span>        -- Help about any <span class="token builtin class-name">command</span>
<span class="token function">ip</span>          -- Get IP address of the running OpenShift cluster
oc-env      -- Add the <span class="token string">'oc'</span> executable to <span class="token environment constant">PATH</span>
podman-env  -- Setup <span class="token function">podman</span> environment
setup       -- Set up prerequisites <span class="token keyword">for</span> the OpenShift cluster
start       -- Start the OpenShift cluster
status      -- Display status of the OpenShift cluster
stop        -- Stop the OpenShift cluster
version     -- Print version information
</code></pre></div><h1 id="%E3%81%BE%E3%81%A8%E3%82%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h1>
<p>今回は、OpenShift をローカルで使用できるツール Red Hat CodeReady Containers についてまとめてみました。Red Hat 製品を購入する前に自身のマシンで気軽に試すことができます。興味のある方は検証などの際に是非活用してみてください。</p>
<h1 id="%E5%8F%82%E8%80%83%E3%81%AB%E3%81%95%E3%81%9B%E3%81%A6%E3%81%84%E3%81%9F%E3%81%A0%E3%81%84%E3%81%9F%E3%82%B5%E3%82%A4%E3%83%88">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E3%81%AB%E3%81%95%E3%81%9B%E3%81%A6%E3%81%84%E3%81%9F%E3%81%A0%E3%81%84%E3%81%9F%E3%82%B5%E3%82%A4%E3%83%88" aria-hidden="true"></a> 参考にさせていただいたサイト</h1>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__c9310e61392e9" src="https://embed.zenn.studio/card#zenn-embedded__c9310e61392e9" data-content="https%3A%2F%2Fqiita.com%2FMahoTakara%2Fitems%2F83ea38e32987457ebbf4" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://qiita.com/MahoTakara/items/83ea38e32987457ebbf4" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://qiita.com/MahoTakara/items/83ea38e32987457ebbf4</a><br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__d8c62be38a92b" src="https://embed.zenn.studio/card#zenn-embedded__d8c62be38a92b" data-content="https%3A%2F%2Fkorattablog.com%2F2020%2F05%2F18%2Fmac-os-code-ready-container-crc-install%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://korattablog.com/2020/05/18/mac-os-code-ready-container-crc-install/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://korattablog.com/2020/05/18/mac-os-code-ready-container-crc-install/</a><br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__e1c8e5e07f915" src="https://embed.zenn.studio/card#zenn-embedded__e1c8e5e07f915" data-content="https%3A%2F%2Fnishipy.com%2Farchives%2F1392" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://nishipy.com/archives/1392" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://nishipy.com/archives/1392</a><br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__5d69a0c8cee4e" src="https://embed.zenn.studio/card#zenn-embedded__5d69a0c8cee4e" data-content="https%3A%2F%2Frheb.hatenablog.com%2Fentry%2F2021%2F03%2F30%2Fcrc_tips" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://rheb.hatenablog.com/entry/2021/03/30/crc_tips" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://rheb.hatenablog.com/entry/2021/03/30/crc_tips</a></p>


Red Hat CodeReady Containers で OpenShift をローカルで使用する

参考にさせていただいたサイト

zenn-contents

Discussion