スタートガイド

手順

1. プラットフォーム用の CodeReady コンテナーの最新リリース をダウンロードします。
2. Microsoft Windows で、アーカイブの内容を展開します。

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

   注記

   Microsoft Windows では、CodeReady Containers をローカル C:\ ドライブにインストールする必要があります。ネットワークドライブから CodeReady コンテナーを実行することはできません。

   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. 最新リリースの CodeReady Containers をダウンロードします。

2. 既存の CodeReady Containers インスタンスを削除します。

   $ crc delete

   警告

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

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

   $ crc version

4. 新しい CodeReady Containers リリースを設定します。

   $ crc setup

5. 新しい CodeReady Containers インスタンスを開始します。

   $ crc start

手順

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

   $ crc config set preset podman

2. CodeReady コンテナーのホストマシンを設定します。

   $ crc setup

手順

1. CodeReady Containers インスタンスを開始します。

   $ crc start

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

   注記

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

手順

1. developer ユーザーとして、実行中の CodeReady Container OpenShift クラスターにログイン します。

   $ odo login -u developer -p developer

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

   $ odo project create sample-app

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

   $ mkdir sample-app
   $ cd sample-app

4. GitHub のサンプルアプリケーションからコンポーネントを作成します。

   $ odo create nodejs --s2i --git https://github.com/openshift/nodejs-ex

   注記

   リモート Git リポジトリーからコンポーネントを作成すると、odo push コマンドを実行するたびにアプリケーションが再ビルドされます。ローカル Git リポジトリーからコンポーネントを作成するには、odo ドキュメント の「 odoを使用した単一コンポーネントアプリケーション の作成」を参照してください。

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

   $ odo url create --port 8080

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

   $ odo push

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

7. URL を一覧表示し、コンポーネントに必要な URL を確認します。

   $ odo url list

8. 生成された 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. CodeReady コンテナーの 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 の既存のエントリーをコメントアウトします。これらのエントリーは、CodeReady コンテナーのローカルインスタンスを実行して作成し、リモートクラスターのエントリーと競合します。

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

   $ sudo systemctl reload NetworkManager

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

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

   リモートの OpenShift 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 に設定し、既存の CodeReady Containers インスタンスを削除します。

手順

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. 最新の CodeReady Containers リリースをダウンロードし、crc 実行可能ファイルを $PATH に配置します。

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

   $ crc delete

   警告

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

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

   $ crc setup

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

   $ crc start

手順

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

   $ crc delete

   警告

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

1. CodeReady Containers インスタンスを停止します。

   $ crc stop

2. CodeReady Containers インスタンスを削除します。

   $ crc delete

   警告

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

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

   $ crc cleanup

   注記

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

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

   $ crc setup

5. CodeReady Containers インスタンスを開始します。

   $ crc start

   注記

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

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