スタートガイド

手順

1. ご使用のプラットフォーム用の Red Hat OpenShift Local の最新リリースをダウンロードします。
2. Microsoft Windows で、アーカイブの内容をデプロイメントします。

3. MacOS または Microsoft Windows の場合は、ガイド付きインストーラーを実行し、手順に従います。

   注記

   Microsoft Windows では、Red Hat OpenShift Local をローカルの C:\ ドライブにインストールする必要があります。ネットワークドライブから Red Hat OpenShift Local を実行できません。

   Red Hat Enterprise Linux の場合は、アーカイブが ~/Downloads ディレクトリーにあるものとし、以下のステップを実行します。

   1. アーカイブの内容をデプロイメントします。

      $ cd ~/Downloads
      $ tar xvf crc-linux-amd64.tar.xz

   2. ~/bin ディレクトリーが存在しない場合は、作成します。また、crc 実行可能ファイルをコピーします。

      $ mkdir -p ~/bin
      $ cp ~/Downloads/crc-linux-*-amd64/crc ~/bin

   3. ~/bin ディレクトリーを $ PATH に追加します。

      $ export PATH=$PATH:$HOME/bin
      $ echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

手順

1. Red Hat OpenShift Local の最新リリースをダウンロード します。

2. 既存の Red Hat OpenShift Local インスタンスを削除します。

   $ crc delete

   警告

   crc delete コマンドを実行すると、Red Hat OpenShift Local ローカルインスタンスに保存されているデータが失われます。このコマンドを実行する前に、インスタンスに保存されている必要な情報を保存してください。

3. 以前の crc 実行可能ファイルを、最新リリースの実行ファイルに置き換えます。バージョンを確認して、新しい crc 実行可能ファイルが使用中であることを確認します。

   $ crc version

4. 新しい Red Hat OpenShift Local ローカルリリースをセットアップします。

   $ crc setup

5. 新しい Red Hat OpenShift Local インスタンスを開始します。

   $ crc start

手順

1. (オプション) Linux では、OpenShift Container Platform プリセットがデフォルトで選択されています。Podman コンテナーランタイムプリセットを選択するには、以下を実行します。

   $ crc config set preset podman

2. Red Hat OpenShift Local 用にホストマシンをセットアップします。

   $ crc setup

手順

1. Red Hat OpenShift Local インスタンスを開始します。

   $ crc start

2. OpenShift プリセットの場合は、プロンプトが表示されたら、ユーザーにプルシークレットを指定します。

   注記

   クラスターは、要求を提供する前に必要なコンテナーおよび Operator を起動するのに 4 分以上かかります。

手順

1. Red Hat OpenShift Local が管理している実行中の OpenShift Container Platform クラスターに developer ユーザーとしてログインします。

   $ odo login -u developer -p developer

2. アプリケーションのプロジェクトを作成します。

   $ odo project create sample-app

3. コンポーネントのディレクトリーを作成します。

   $ mkdir sample-app
   $ cd sample-app

4. Node.js アプリケーションの例を複製します。

   $ git clone https://github.com/openshift/nodejs-ex
   $ cd nodejs-ex

5. nodejs コンポーネントをアプリケーションに追加します。

   $ odo create nodejs

6. URL を作成し、ローカル設定ファイルにエントリーを追加します。

   $ odo url create --port 8080

7. 変更をプッシュします。

   $ odo push

   これで、コンポーネントはアクセス可能な URL でクラスターにデプロイされます。

8. URL をリスト表示し、コンポーネントに必要な URL を確認します。

   $ odo url list

9. 生成された URL を使用してデプロイされたアプリケーションを表示します。

手順

1. http_proxy および https_proxy 環境変数を使用するか、以下のように crc config set コマンドを使用してプロキシーを定義します。

   $ crc config set http-proxy http://proxy.example.com:<port>
   $ crc config set https-proxy http://proxy.example.com:<port>
   $ crc config set no-proxy <comma-separated-no-proxy-entries>

2. プロキシーがカスタム CA 証明書ファイルを使用する場合は、以下のように設定します。

   $ crc config set proxy-ca-file <path-to-custom-ca-file>

手順

1. クラスターを起動します。

   $ crc start

   この手順の間、クラスターが稼働していることを確認してください。

2. haproxy パッケージおよびその他のユーティリティーをインストールします。

   $ sudo dnf install haproxy /usr/sbin/semanage

3. クラスターとの通信を許可するようにファイアウォールを変更します。

   $ sudo systemctl enable --now firewalld
   $ sudo firewall-cmd --add-service=http --permanent
   $ sudo firewall-cmd --add-service=https --permanent
   $ sudo firewall-cmd --add-service=kube-apiserver --permanent
   $ sudo firewall-cmd --reload

4. SELinux の場合は、HAProxy が TCP ポート 6443 でリッスンして、このポートで kube-apiserver を提供できるようにします。

   $ sudo semanage port -a -t http_port_t -p tcp 6443

5. デフォルトの haproxy 設定のバックアップを作成します。

   $ sudo cp /etc/haproxy/haproxy.cfg{,.bak}

6. クラスターで使用するように haproxy を設定します。

   $ export CRC_IP=$(crc ip)
   $ sudo tee /etc/haproxy/haproxy.cfg &>/dev/null <<EOF
   global
       log /dev/log local0
   
   defaults
       balance roundrobin
       log global
       maxconn 100
       mode tcp
       timeout connect 5s
       timeout client 500s
       timeout server 500s
   
   listen apps
       bind 0.0.0.0:80
       server crcvm $CRC_IP:80 check
   
   listen apps_ssl
       bind 0.0.0.0:443
       server crcvm $CRC_IP:443 check
   
   listen api
       bind 0.0.0.0:6443
       server crcvm $CRC_IP:6443 check
   EOF

7. haproxy サービスを起動します。

   $ sudo systemctl start haproxy

手順

1. dnsmasq パッケージをインストールします。

   $ sudo dnf install dnsmasq

2. NetworkManager での DNS 解決に対する dnsmasq の使用を有効にします。

   $ sudo tee /etc/NetworkManager/conf.d/use-dnsmasq.conf &>/dev/null <<EOF
   [main]
   dns=dnsmasq
   EOF

3. Red Hat OpenShift Local の DNS エントリーを dnsmasq 設定に追加します。

   $ sudo tee /etc/NetworkManager/dnsmasq.d/external-crc.conf &>/dev/null <<EOF
   address=/apps-crc.testing/SERVER_IP_ADDRESS
   address=/api.crc.testing/SERVER_IP_ADDRESS
   EOF

   注記

   /etc/NetworkManager/dnsmasq.d/crc.conf の既存のエントリーをコメントアウトします。これらのエントリーは、Red Hat OpenShift Local インスタンスを実行して作成し、リモートクラスターのエントリーと競合します。

4. NetworkManager サービスを再読み込みします。

   $ sudo systemctl reload NetworkManager

5. oc を使用して developer ユーザーとしてリモートクラスターにログインします。

   $ oc login -u developer -p developer https://api.crc.testing:6443

   リモートの OpenShift Container Platform Web コンソールは https://console-openshift-console.apps-crc.testing から入手できます。

手順

1. enable-cluster-monitoring 設定可能プロパティーを true に設定します。

   $ crc config set enable-cluster-monitoring true

2. インスタンスを起動します。

   $ crc start

   警告

   クラスターモニタリングを無効にできません。モニタリングを削除するには、enable-cluster-monitoring 設定可能プロパティーを false に設定し、既存の Red Hat OpenShift Local インスタンスを削除します。

手順

1. アンマネージドの Operator をリストし、目的の Operator の数値インデックスをメモします。

   • Linux または MacOS の場合:

     $ oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | nl -v 0

   • PowerShell を使用する Microsoft Windows の場合:

     PS> oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | % {$nl++;"`t$($nl-1) `t $_"};$nl=0

2. 特定された数値インデックスを使用して、目的の Operator を開始します。

   $ oc patch clusterversion/version --type='json' -p '[{"op":"remove", "path":"/spec/overrides/<unmanaged-operator-index>"}]'
   clusterversion.config.openshift.io/version patched

手順

1. oc get nodes コマンドを実行して、目的のノードを特定します。出力は以下のようになります。

   $ oc get nodes
   NAME                 STATUS   ROLES           AGE    VERSION
   crc-shdl4-master-0   Ready    master,worker   7d7h   v1.14.6+7e13ab9a7

2. oc debug nodes/<node> を実行します。ここでの <node> は直前の手順で出力されるノードの名前です。

1. 最新の Red Hat OpenShift Local リリースをダウンロードし、$PATH に crc 実行可能ファイルを設定します。

2. crc delete コマンドを使用して、証明書エラーでクラスターを削除します。

   $ crc delete

   警告

   crc delete コマンドを実行すると、Red Hat OpenShift Local ローカルインスタンスに保存されているデータが失われます。このコマンドを実行する前に、インスタンスに保存されている必要な情報を保存してください。

3. 新しいリリースを設定します。

   $ crc setup

4. 新しいインスタンスを開始します。

   $ crc start

手順

1. インスタンスを起動する前に crc delete コマンドを実行します。

   $ crc delete

   警告

   crc delete コマンドを実行すると、Red Hat OpenShift Local ローカルインスタンスに保存されているデータが失われます。このコマンドを実行する前に、インスタンスに保存されている必要な情報を保存してください。

1. Red Hat OpenShift Local インスタンスを停止します。

   $ crc stop

2. Red Hat OpenShift Local インスタンスを削除します。

   $ crc delete

   警告

   crc delete コマンドを実行すると、Red Hat OpenShift Local ローカルインスタンスに保存されているデータが失われます。このコマンドを実行する前に、インスタンスに保存されている必要な情報を保存してください。

3. crc setup コマンドで残りの変更をクリーンアップします。

   $ crc cleanup

   注記

   crc cleanup コマンドは、既存の Red Hat OpenShift Local コンテナーインスタンスを削除し、crc setup コマンドで作成した DNS エントリーへの変更に戻ります。MacOS では、crc cleanup コマンドがシステムトレイも削除します。

4. 変更を適用するためにホストマシンを設定します。

   $ crc setup

5. Red Hat OpenShift Local インスタンスを開始します。

   $ crc start

   注記

   クラスターは、要求を提供する前に必要なコンテナーおよび Operator を起動するのに 4 分以上かかります。

1. 発生した問題については、未解決の問題を検索 します。
2. 発生した問題に対処する既存の問題がない場合は、問題を作成し、~/.crc/crc.log ファイルを作成された問題に割り当てます。~/.crc/crc.log ファイルには詳細なデバッグとトラブルシューティング情報があり、発生した問題を診断するのに役立ちます。