スタートガイド
CodeReady コンテナーの使用および開発のガイド
概要
第1章 Red Hat CodeReady Containers の概要 リンクのコピーリンクがクリップボードにコピーされました!
1.1. CodeReady Containers リンクのコピーリンクがクリップボードにコピーされました!
Red Hat CodeReady Containers は、最小限の OpenShift 4 クラスターをローカルコンピューターに提供します。このクラスターは、開発およびテストの目的で最小限の環境を提供します。CodeReady Containers は主に開発者のデスクトップ上での実行を対象としています。ヘッドレスやマルチ開発者用の設定などの他のユースケースの場合は、完全な OpenShift インストーラー を使用します。
OpenShift の完全な概要については、OpenShift ドキュメント を参照してください。
CodeReady Containers には、OpenShift クラスターを実行する CodeReady Containers 仮想マシンと対話するための crc コマンドラインインターフェース(CLI)が含まれます。
1.2. 実稼働用の OpenShift インストールとの違い リンクのコピーリンクがクリップボードにコピーされました!
Red Hat CodeReady Containers は、以下の主な相違点を備えた通常の OpenShift インストールです。
- CodeReady Containers OpenShift クラスターは一時的なもので、実稼働環境での使用を目的としていません。
- これは、マスターノードとワーカーノードの両方として動作する単一ノードを使用します。
デフォルトで
machine-configおよびmonitoringOperator を無効にします。- これらの Operator が無効になると、Web コンソールの対応する部分が機能しなくなります。
- 同じ理由で、新しいバージョンへのアップグレードパスはありません。
- OpenShift インスタンスは仮想マシンで実行されます。これにより、特に外部のネットワークでその他の違いが生じる可能性があります。
CodeReady Containers には、以下のカスタマイズ不可のクラスター設定も含まれます。以下の設定は変更しないでください。
- * .crc.testing ドメインの使用。
内部クラスター通信に使用されるアドレス範囲。
- クラスターは 172 アドレス範囲を使用します。これにより、プロキシーが同じアドレス空間で実行される場合などに問題が発生する可能性があります。
第2章 インストール リンクのコピーリンクがクリップボードにコピーされました!
2.1. システムの最小要件 リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers には、以下の最小ハードウェアおよびオペレーティングシステムの要件があります。
2.1.1. ハードウェア要件 リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers には以下のシステムリソースが必要です。
- 4 つの仮想 CPU(vCPU)
- 9 GB の空きメモリー
- 35 GB のストレージ領域
OpenShift クラスターでは、CodeReady Containers 仮想マシンでこれらの最小リソースを実行する必要があります。ワークロードによっては、より多くのリソースが必要になる場合があります。CodeReady Containers 仮想マシンにより多くのリソースを割り当てる場合は、「仮想マシン の設定」を参照してください。
2.1.2. オペレーティングシステムの要件 リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers には、サポートされるオペレーティングシステムの以下の最小バージョンが必要です。
2.1.2.1. Microsoft Windows リンクのコピーリンクがクリップボードにコピーされました!
- Microsoft Windows では、CodeReady Containers には Windows 10 Pro fall Creators Update(バージョン 1709)以降が必要です。CodeReady Containers は、Microsoft Windows の以前のバージョンまたは編集では機能しません。Microsoft Windows 10 Home Edition はサポートされていません。
2.1.2.2. macOS リンクのコピーリンクがクリップボードにコピーされました!
- macOS では、CodeReady Containers には macOS 10.12 Sierra 以降が必要です。CodeReady Containers は、以前のバージョンの macOS では機能しません。
2.1.2.3. linux リンクのコピーリンクがクリップボードにコピーされました!
- Linux では、CodeReady Containers は、Red Hat Enterprise Linux/CentOS 7.5 以降(8.x バージョンを含む)および最新の 2 つの安定した Fedora リリースでのみサポートされます。
- Red Hat Enterprise Linux を使用する場合は、CodeReady Containers を実行するマシンを Red Hat カスタマーポータルに登録 する必要があります。
- Ubuntu 18.04 LTS 以降および Debian 10 以降は正式にサポートされておらず、ホストマシンを手動で設定する必要がある場合があります。
- Linux ディストリビューションに必要な パッケージをインストールするには、「必要なソフトウェアパッケージ」を参照し てください。
2.2. Linux に必要なソフトウェアパッケージ リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers では、Linux で libvirt パッケージおよび NetworkManager パッケージを実行する必要があります。以下の表を参照して、Linux ディストリビューションにこれらのパッケージをインストールするのに使用するコマンドを確認してください。
| Linux ディストリビューション | インストールコマンド |
|---|---|
| Fedora |
|
| Red Hat Enterprise Linux/CentOS |
|
| Debian/Ubuntu |
|
2.3. CodeReady Containers のインストール リンクのコピーリンクがクリップボードにコピーされました!
前提条件
- ホストマシンがシステム最小要件を満たしている必要があります。詳細は「 システム要件の最小 」を参照してください。
手順
-
プラットフォームの 最新リリースの CodeReady Containers をダウンロードし、アーカイブの内容を
PATHの場所に展開します。
2.4. CodeReady Containers のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
新しいバージョンの CodeReady Containers バイナリーでは、以前のバージョンと非互換性を防ぐために手動で設定する必要があります。
手順
- CodeReady Containers の最新リリースをダウンロードします。
既存の CodeReady Containers 仮想マシンを削除します。
crc delete
$ crc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 警告crc deleteコマンドを実行すると、CodeReady Containers 仮想マシンに保存されているデータが失われます。このコマンドを実行する前に、仮想マシンに保存されている必要な情報を保存します。以前の
crcバイナリーは、最新リリースのバイナリーに置き換えます。そのバージョンを確認して、新しいcrcバイナリーが使用されていることを確認します。crc version
$ crc versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しい CodeReady Containers リリースを設定します。
crc setup
$ crc setupCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しい CodeReady Containers 仮想マシンを起動します。
crc start
$ crc startCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第3章 CodeReady Containers の使用 リンクのコピーリンクがクリップボードにコピーされました!
3.1. CodeReady Containers の設定 リンクのコピーリンクがクリップボードにコピーされました!
crc setup コマンドは、CodeReady Containers 仮想マシンのホストマシンの環境を設定する操作を実行します。
この手順では、~/.crc ディレクトリーが存在しない場合は作成します。
前提条件
-
ユーザーアカウントには、
sudoコマンドを使用するパーミッションがあります。
-
crcバイナリーをroot(または Administrator)として実行しないでください。ユーザーアカウントでcrcバイナリーを常に実行します。 - 新規バージョンを設定する場合は、新しい CodeReady Containers リリースを設定する前に、仮想マシンに加えられた変更を取得します。
手順
CodeReady Containers のホストマシンを設定します。
crc setup
$ crc setupCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.2. 仮想マシンの起動 リンクのコピーリンクがクリップボードにコピーされました!
crc start コマンドは、CodeReady Containers 仮想マシンおよび OpenShift クラスターを起動します。
前提条件
- ネットワーク関連の問題を回避するには、VPN に接続していないことと、ネットワーク接続が信頼できることを確認してください。
-
crc setupコマンドを使用してホストマシンを設定します。詳細は、「 CodeReady Containers の設定」を 参照してください。 有効な OpenShift ユーザープルシークレットがある。cloud.redhat.com の「 Install on Laptop: Red Hat CodeReady Containers 」ページの Pull Secret セクションからプルシークレットをコピーまたはダウンロードします。
注記ユーザープルシークレットにアクセスするには、Red Hat アカウントが必要です。
手順
CodeReady Containers 仮想マシンを起動します。
crc start
$ crc startCopy to Clipboard Copied! Toggle word wrap Toggle overflow - プロンプトが表示されたら、ユーザープルシークレットを指定します。
- クラスターは要求に対応する前に、必要なコンテナーおよび Operator を起動するのに最低 4 分かかります。
-
crc の起動中にエラーが表示される場合は、Troubleshooting CodeReady Containers のセクションにある可能性のある解決策を確認してください。
3.3. OpenShift クラスターへのアクセス リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Web コンソールまたはクライアントバイナリー(oc)を使用して CodeReady Container 仮想マシンで実行されている OpenShift クラスターにアクセスします。
3.3.1. OpenShift Web コンソールへのアクセス リンクのコピーリンクがクリップボードにコピーされました!
前提条件
- 実行中の CodeReady Containers 仮想マシン。詳細は、「 仮想マシンの起動」を 参照してください。
手順
OpenShift Web コンソールにアクセスするには、以下の手順に従います。
-
crc コンソールを実行します。これにより、Web ブラウザーが開き、Web コンソールに転送されます。 - OpenShift Web コンソールで htpasswd_provider オプションを選択します。
crc startコマンドの出力で出力されるパスワードを使用して、developerユーザーとしてログインします。注記-
crc console --credentialsを実行して、developerおよびkubeadminユーザーのパスワードを表示することもできます。 -
kubeadminまたはdeveloperユーザーのいずれかを使用して、クラスターに最初にアクセスできます。プロジェクトまたは OpenShift アプリケーションを作成し、アプリケーションのデプロイメントに開発者ユーザーを使用します。新規ユーザーの作成、ロールの設定などの管理タスクにはkubeadminユーザーのみを使用します。
-
CodeReady Containers OpenShift クラスターにアクセスできない場合は、「CodeReady Containers のトラブルシューティング 」を参照してください。
その他のリソース
- OpenShift ドキュメント では、プロジェクトとアプリケーションの作成について説明します。
3.3.2. ocを使用した OpenShift クラスターへのアクセス リンクのコピーリンクがクリップボードにコピーされました!
前提条件
- 実行中の CodeReady Containers 仮想マシン。詳細は、「 仮想マシンの起動」を 参照してください。
手順
oc コマンドを使用して OpenShift クラスターにアクセスするには、以下の手順に従います。
crc oc-envコマンドを実行して、キャッシュされたocバイナリーをPATHに追加するのに必要なコマンドを出力します。crc oc-env
$ crc oc-envCopy to Clipboard Copied! Toggle word wrap Toggle overflow - print コマンドを実行します。
developerユーザーとしてログインします。oc login -u developer https://api.crc.testing:6443
$ oc login -u developer https://api.crc.testing:6443Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記crc startコマンドは、developerユーザーのパスワードを出力します。crc console --credentialsコマンドを実行して表示することもできます。ocを使用して OpenShift クラスターと対話できるようになりました。たとえば、OpenShift クラスター Operator が利用できることを確認するには、以下を実行します。oc get co
$ oc get coCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記-
CodeReady Containers はデフォルトで
machine-configおよびmonitoringOperator を無効にします。
-
CodeReady Containers はデフォルトで
CodeReady Containers OpenShift クラスターにアクセスできない場合は、「CodeReady Containers のトラブルシューティング 」を参照してください。
その他のリソース
- OpenShift ドキュメント では、プロジェクトとアプリケーションの作成について説明します。
3.4. odoを使用したサンプルアプリケーションのデプロイ リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Do(odo)を使用して、コマンドラインから OpenShift プロジェクトおよびアプリケーションを作成できます。この手順では、CodeReady Containers 仮想マシンで実行している OpenShift クラスターにサンプルアプリケーションをデプロイします。
前提条件
-
odoがインストールされている。詳細は、odoドキュメント の「。odoのインストール 」を参照してください - CodeReady Containers 仮想マシンが実行している。詳細は、「 仮想マシンの起動」を 参照してください。
手順
odo を使用してアプリケーションのサンプルをデプロイするには、以下の手順に従います。
実行中の CodeReady Containers OpenShift クラスターに
developerユーザーとしてログインします。odo login -u developer -p developer
$ odo login -u developer -p developerCopy to Clipboard Copied! Toggle word wrap Toggle overflow アプリケーションのプロジェクトを作成します。
odo project create sample-app
$ odo project create sample-appCopy to Clipboard Copied! Toggle word wrap Toggle overflow コンポーネントのディレクトリーを作成します。
mkdir sample-app cd sample-app
$ mkdir sample-app $ cd sample-appCopy to Clipboard Copied! Toggle word wrap Toggle overflow GitHub 上のサンプルアプリケーションからコンポーネントを作成します。
odo create nodejs --git https://github.com/openshift/nodejs-ex
$ odo create nodejs --git https://github.com/openshift/nodejs-exCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記リモート Git リポジトリーからコンポーネントを作成すると、
odo pushコマンドを実行するたびにアプリケーションが再ビルドされます。ローカル Git リポジトリーからコンポーネントを作成するには、odoドキュメントの「 Creating a single-component application with。odo」を参照してくださいURL を作成し、ローカル設定ファイルにエントリーを追加します。
odo url create --port 8080
$ odo url create --port 8080Copy to Clipboard Copied! Toggle word wrap Toggle overflow 変更をプッシュします。
odo push
$ odo pushCopy to Clipboard Copied! Toggle word wrap Toggle overflow これで、コンポーネントはアクセスできる URL を使用してクラスターにデプロイされます。
URL を一覧表示し、コンポーネントに必要な URL を確認します。
odo url list
$ odo url listCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 生成された URL を使用してデプロイされたアプリケーションを表示します。
その他のリソース
-
odo の使用についての詳細は、
odoのドキュメントを参照してください。
3.5. 仮想マシンの停止 リンクのコピーリンクがクリップボードにコピーされました!
crc stop コマンドは、実行中の CodeReady Containers 仮想マシンおよび OpenShift クラスターを停止します。停止プロセスには、クラスターがシャットダウンする間数分かかります。
手順
CodeReady Containers 仮想マシンおよび OpenShift クラスターを停止します。
crc stop
$ crc stopCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6. 仮想マシンの削除 リンクのコピーリンクがクリップボードにコピーされました!
crc delete コマンドは、既存の CodeReady Containers の仮想マシンを削除します。
手順
CodeReady Containers 仮想マシンを削除します。
crc delete
$ crc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 警告crc deleteコマンドを実行すると、CodeReady Containers 仮想マシンに保存されているデータが失われます。このコマンドを実行する前に、仮想マシンに保存されている必要な情報を保存します。
第4章 CodeReady Containers の設定 リンクのコピーリンクがクリップボードにコピーされました!
4.1. CodeReady Containers 設定 リンクのコピーリンクがクリップボードにコピーされました!
crc config コマンドを使用して、crc バイナリーと CodeReady Containers 仮想マシンの両方を設定します。crc config コマンドには、設定で動作するサブコマンドが必要です。利用可能なサブコマンドは、get、set、 unset、および view です。get、set、および unset サブコマンドは、名前付きの設定可能なプロパティーで動作します。crc config --help コマンドを実行して、利用可能なプロパティーを一覧表示します。
crc config コマンドを使用して、crc start コマンドおよび crc setup コマンドの起動チェックの動作を設定することもできます。デフォルトでは、スタートアップチェックでエラーが報告され、条件が満たされていない場合は実行を停止します。skip-check または て、チェックを省略するか、エラーではなく警告を報告します。
warn-check で始まるプロパティーの値を true に設定し
4.2. CodeReady Containers 設定の表示 リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers バイナリーは、設定可能なプロパティーと現在の CodeReady Containers 設定を表示するコマンドを提供します。
手順
利用可能な設定可能なプロパティーを表示するには、以下を実行します。
crc config --help
$ crc config --helpCopy to Clipboard Copied! Toggle word wrap Toggle overflow 設定可能なプロパティーの値を表示するには、以下を実行します。
crc config get <property>
$ crc config get <property>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 現在の設定をすべて表示するには、以下を実行します。
crc config view
$ crc config viewCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記設定がデフォルト値で構成される場合は、
crc config viewコマンドは情報を返しません。
4.3. 仮想マシンの設定 リンクのコピーリンクがクリップボードにコピーされました!
cpus および memory プロパティーを使用して、CodeReady Containers 仮想マシンで利用可能な仮想 CPU のデフォルト数とメモリー量を設定します。
既存の CodeReady Containers 仮想マシンの設定は変更できません。設定変更を有効にするには、既存の仮想マシンを削除して、新規仮想マシンを作成する必要があります。
新規仮想マシンを作成するには、最初に既存の CodeReady Containers 仮想マシンを削除してから、設定変更のある新規仮想マシンを起動します。
crc delete crc start
$ crc delete
$ crc start
crc delete コマンドを実行すると、CodeReady Containers 仮想マシンに保存されているデータが失われます。このコマンドを実行する前に、仮想マシンに保存されている必要な情報を保存します。
手順
仮想マシンで利用可能な vCPU の数を増やすには、以下を実行します。
crc config set cpus <number>
$ crc config set cpus <number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow cpusプロパティーのデフォルト値は4です。割り当てる vCPU 数は、デフォルト以上である必要があります。仮想マシンで利用可能なメモリーを増やすには、以下を実行します。
crc config set memory <number-in-mib>
$ crc config set memory <number-in-mib>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記利用可能なメモリーの値は、メガバイト(MiB)で設定されます。メモリーの 1 ギビバイト(GiB)は 1024 MiB に等しくなります。
メモリープロパティーのデフォルト値
は9216です。割り当てるメモリーのサイズは、デフォルト以上である必要があります。
第5章 ネットワーク リンクのコピーリンクがクリップボードにコピーされました!
5.1. DNS 設定の詳細 リンクのコピーリンクがクリップボードにコピーされました!
5.1.1. 一般的な DNS 設定 リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers によって管理される OpenShift クラスターは、2 つの DNS ドメイン名( crc.testing および apps-crc.testing )を使用します。crc.testing ドメインは、コア OpenShift サービス用です。apps-crc.testing ドメインは、クラスターにデプロイされた OpenShift アプリケーションへのアクセスです。
たとえば、OpenShift API サーバーは console -openshift-console.apps- として公開されます。これらの DNS ドメインは、CodeReady Containers 仮想マシン内で実行される crc.testing を使用して OpenShift コンソールにアクセスする際に api.crc.testingdnsmasq DNS コンテナーにより提供されます。
crc 設定 を実行すると、これらのドメインを解決できるように、システム DNS 設定を調整します。crc の起動 時に DNS が適切に設定されていることを確認するために追加チェックが行われます。
5.1.2. linux リンクのコピーリンクがクリップボードにコピーされました!
Linux では、CodeReady Containers には以下の DNS 設定が必要です。
- CodeReady Containers は、NetworkManager がネットワークを管理することを想定します。
-
NetworkManager は、
/etc/NetworkManager/conf.d/crc-nm-dnsmasq.conf 設定ファイルをを使用します。介して dnsmasq この
dnsmasqインスタンスの設定ファイルは/etc/NetworkManager/dnsmasq.d/crc.confです。server=/crc.testing/192.168.130.11 server=/apps-crc.testing/192.168.130.11
server=/crc.testing/192.168.130.11 server=/apps-crc.testing/192.168.130.11Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
NetworkManager
dnsmasqインスタンスは、crc.testing ドメインおよびapps-ドメインの要求を 192.168.130.11crc.testingDNSサーバーに転送します。
-
NetworkManager
5.1.3. macOS リンクのコピーリンクがクリップボードにコピーされました!
macOS では、CodeReady Containers には以下の DNS 設定が必要です。
-
CodeReady Containers は、
/etc/resolver/testingファイルを作成し、testingドメインに対するすべての DNS 要求を CodeReady Containers 仮想マシンに転送するよう macOS に指示します。 -
CodeReady Containers は、
api.crc.testingエントリーを、仮想マシンの IP アドレスを参照する/etc/hostsに追加します。ocバイナリーには、このエントリーが必要です。詳細は、「 OpenShift issue #23266 」を参照してください。
5.2. プロキシーの背後での CodeReady Containers の起動 リンクのコピーリンクがクリップボードにコピーされました!
前提条件
-
ホストマシンで既存の
ocバイナリーを使用するには、.testingドメインをno_proxy環境変数の一部としてエクスポートします。 -
埋め込み
ocバイナリーには手動の設定は必要ありません。組み込まれたocバイナリーの使用についての詳細は、「 Accessing the OpenShift cluster withoc」を参照してください。
手順
CodeReady Containers をプロキシーの背後で起動するには、以下を実行します。
http_proxy およびを定義するか、https_proxy環境変数を使用してプロキシーcrc config setコマンドを以下のように使用します。crc config set http-proxy http://example.proxy.com:<port> crc config set https-proxy http://example.proxy.com:<port> crc config set no-proxy <comma-separated-no-proxy-entries>
$ crc config set http-proxy http://example.proxy.com:<port> $ crc config set https-proxy http://example.proxy.com:<port> $ crc config set no-proxy <comma-separated-no-proxy-entries>Copy to Clipboard Copied! Toggle word wrap Toggle overflow crcバイナリーは、環境変数または CodeReady Containers 設定で設定されたプロキシーを一度使用できるようになります。
- CodeReady Containers の設定で設定されたプロキシー関連の値は、環境変数で設定された値よりも優先されます。
- socks プロキシーは OpenShift Container Platform ではサポートされていません。
第6章 管理タスク リンクのコピーリンクがクリップボードにコピーされました!
6.1. モニタリング、アラート、および Telemetry の起動 リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers を通常のノートパソコンで実行するには、一部のリソース重みサービスがデフォルトで無効にされます。これらのいずれかが Prometheus と、関連するモニタリング、アラート、および Telemetry 機能です。Telemetry 機能は、Red Hat OpenShift Cluster Manager でクラスターを一覧表示します。
前提条件
-
実行中の CodeReady Containers 仮想マシンおよび作業用の
ocコマンド。詳細は、「 Accessing the OpenShift cluster withoc」を参照してください。 -
ocでkubeadminユーザーとしてログインする必要があります。 -
追加のメモリーを CodeReady Containers 仮想マシンに割り当てる必要があります。12 GiB のメモリー(値
12288)を推奨します。詳細は、「 仮想マシンの設定」を 参照してください。
手順
管理外の Operator を一覧表示し、
cluster-monitoring-operatorの数値インデックスを書き留めます。Linux または macOS の場合:
oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | nl -v 0$ oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | nl -v 0Copy to Clipboard Copied! Toggle word wrap Toggle overflow PowerShell を使用する Microsoft Windows では、以下を行います。
PS> oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | % {$nl++;"`t$($nl-1) `t $_"};$nl=0PS> oc get clusterversion version -ojsonpath='{range .spec.overrides[*]}{.name}{"\n"}{end}' | % {$nl++;"`t$($nl-1) `t $_"};$nl=0Copy to Clipboard Copied! Toggle word wrap Toggle overflow
cluster-monitoring-operator の識別された数値インデックスを使用して、モニタリング、アラート、および Telemetry サービスを開始します。oc patch clusterversion/version --type='json' -p '[{"op":"remove", "path":"/spec/overrides/<unmanaged-operator-index>"}]' -oyaml$ oc patch clusterversion/version --type='json' -p '[{"op":"remove", "path":"/spec/overrides/<unmanaged-operator-index>"}]' -oyamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第7章 Red Hat CodeReady Containers のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
Red Hat CodeReady Containers の目的は、開発およびテスト目的で OpenShift 環境を提供することです。特定の OpenShift アプリケーションのインストール時または使用中に発生した問題は、CodeReady Containers の範囲外です。このような問題を関連するプロジェクトに報告します。たとえば、OpenShift は GitHub で問題を追跡します。
7.1. OpenShift クラスターへのシェルアクセスの取得 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift クラスターへの直接アクセスは、通常の使用には必要ありません。これは強く推奨されません。トラブルシューティングまたはデバッグの目的でクラスターにアクセスするには、以下の手順に従います。
前提条件
-
クラスターへの
ocアクセスを有効にし、kubeadminユーザーとしてログインします。詳細な手順は、「 Accessing the OpenShift cluster withoc」を参照してください。
手順
oc get nodesを実行します。出力は以下のようになります。oc get nodes NAME STATUS ROLES AGE VERSION crc-shdl4-master-0 Ready master,worker 7d7h v1.14.6+7e13ab9a7
$ oc get nodes NAME STATUS ROLES AGE VERSION crc-shdl4-master-0 Ready master,worker 7d7h v1.14.6+7e13ab9a7Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
oc debug nodes/<node>を実行します。ここで、<node>は直前の手順で出力されたノードの名前です。
7.2. 期限切れ証明書のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers 1.10.0 リリースの時点で、証明書の更新プロセスは意図されたとおりに機能しません。以下の手順に従って、証明書の有効期限による潜在的なエラーが発生しないようにします。
リリースされる各 crc バイナリーのシステムバンドルは、リリース後 30 日後に有効期限が切れます。この有効期限は、OpenShift クラスターに埋め込まれた証明書によるものです。その結果、古い crc バイナリーまたはシステムバンドルを使用すると、証明書の有効期限が切れる可能性があります。
CodeReady Containers 1.2.0 以降では、組み込み証明書は crc によって自動的に更新できます。crc start コマンドは、必要に応じて証明書の更新プロセスをトリガーします。証明書の更新は、クラスターの起動時間に最大 5 分追加できます。
手順
自動的に更新できない期限切れの証明書エラーを解決するには、以下を実行します。
-
最新の CodeReady Containers リリースをダウンロード し、
crcバイナリーを$PATHに配置します。 crc delete コマンドを使用して、証明書エラーのあるクラスターを削除します。crc delete
$ crc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 警告crc deleteコマンドを実行すると、CodeReady Containers 仮想マシンに保存されているデータが失われます。このコマンドを実行する前に、仮想マシンに保存されている必要な情報を保存します。新しいリリースを設定します。
crc setup
$ crc setupCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しい仮想マシンを起動します。
crc start
$ crc startCopy to Clipboard Copied! Toggle word wrap Toggle overflow
7.3. バンドルバージョンの不一致に関するトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
作成された CodeReady Containers 仮想マシンには、バンドル情報およびインスタンスデータが含まれます。新しい CodeReady Containers リリースの設定時にバンドル情報およびインスタンスデータは更新されません。以前のインスタンスデータのカスタマイズにより、この情報は更新されません。これにより、crc start コマンドを実行するとエラーが発生します。
crc start ... FATA Bundle 'crc_hyperkit_4.2.8.crcbundle' was requested, but the existing VM is using 'crc_hyperkit_4.2.2.crcbundle'
$ crc start
...
FATA Bundle 'crc_hyperkit_4.2.8.crcbundle' was requested, but the existing VM is using
'crc_hyperkit_4.2.2.crcbundle'
手順
インスタンスの起動を試みる前に、
crc deleteコマンドを実行します。crc delete
$ crc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 警告crc deleteコマンドを実行すると、CodeReady Containers 仮想マシンに保存されているデータが失われます。このコマンドを実行する前に、仮想マシンに保存されている必要な情報を保存します。
7.4. 不明な問題のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
CodeReady Containers をクリーンな状態で再起動して、ほとんどの問題を解決します。これには、仮想マシンを停止し、そのコマンドの削除、crc setup コマンドによる変更の取り消し、それらの変更の再適用、仮想マシンの再起動が含まれます。
前提条件
-
crc setupコマンドを使用してホストマシンを設定します。詳細は、「 CodeReady Containers の設定」を 参照してください。 -
crc start コマンドを使用して CodeReady Containers を起動している。詳細は、「 仮想マシンの起動」を 参照してください。 - 最新の CodeReady Containers リリースを使用している。CodeReady Containers 1.2.0 よりも前のバージョンを使用すると、x509 証明書の期限切れに関連するエラーが発生する可能性があります。詳細は、「 証明書のトラブルシューティング 」を参照してください。
手順
CodeReady Containers のトラブルシューティングを行うには、以下の手順を実行します。
CodeReady Containers 仮想マシンを停止します。
crc stop
$ crc stopCopy to Clipboard Copied! Toggle word wrap Toggle overflow CodeReady Containers 仮想マシンを削除します。
crc delete
$ crc deleteCopy to Clipboard Copied! Toggle word wrap Toggle overflow 警告crc deleteコマンドを実行すると、CodeReady Containers 仮想マシンに保存されているデータが失われます。このコマンドを実行する前に、仮想マシンに保存されている必要な情報を保存します。crc setupコマンドで残りの変更をクリーンアップします。crc cleanup
$ crc cleanupCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記crc cleanupコマンドは、既存の CodeReady Containers 仮想マシンを削除し、crc setupコマンドで作成された DNS エントリーへの変更を元に戻します。macOS では、crc cleanupコマンドは、システムトレイも削除します。ホストマシンを設定して、変更を適用します。
crc setup
$ crc setupCopy to Clipboard Copied! Toggle word wrap Toggle overflow CodeReady Containers 仮想マシンを起動します。
crc start
$ crc startCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記クラスターは要求に対応する前に、必要なコンテナーおよび Operator を起動するのに最低 4 分かかります。
この手順で問題が解決されない場合は、以下の手順を実施します。
- 発生した問題について、オープンな問題を検索 します。
-
既存の問題が解決されない場合は、問題を作成 し、
~/.crc/crc.logファイルを作成した問題に割り当て ます。~/.crc/crc.logファイルには詳細なデバッグおよびトラブルシューティング情報が記載されており、発生している問題を診断するのに役立ちます。