This documentation is for a release that is no longer maintained
See documentation for the latest supported version 3 or the latest supported version 4.1.3. カスタマイズによる AWS へのクラスターのインストール
				OpenShift Container Platform バージョン 4.3 では、インストールプログラムが Amazon Web Services (AWS) にプロビジョニングするインフラストラクチャーにカスタマイズされたクラスターをインストールすることができます。インストールをカスタマイズするには、クラスターをインストールする前に、install-config.yaml ファイルでパラメーターを変更します。
			
1.3.1. 前提条件
- OpenShift Container Platform のインストールおよび更新プロセスについての詳細を確認します。
- AWS アカウントを設定してクラスターをホストします。 重要- AWS プロファイルがご使用のコンピューターに保存されている場合、マルチファクター認証デバイスを使用中に生成した一時的なセッショントークンを使用することはできません。クラスターは継続的に現行の AWS 認証情報を使用して、クラスターの有効期間全体にわたって AWS リソースを作成するため、有効期間の長い認証情報を使用する必要があります。適切なキーを生成するには、AWS ドキュメントの「Managing Access Keys for IAM Users」を参照してください。キーは、インストールプログラムの実行時に指定できます。 
- ファイアウォールを使用する場合、クラスターがアクセスを必要とするサイトを許可するようにファイアウォールを設定する必要があります。
- システムが IAM(アイデンティティーおよびアクセス管理)を管理できない場合、クラスター管理者は IAM 認証情報を手動で作成し、維持できます。手動モードは、クラウド IAM API に到達できない環境でも使用できます。
1.3.2. OpenShift Container Platform のインターネットアクセスおよび Telemetry アクセス
OpenShift Container Platform 4.3 では、クラスターをインストールするためにインターネットアクセスが必要になります。クラスターの健全性および正常に実行された更新についてのメトリクスを提供するためにデフォルトで実行される Telemetry サービスにもインターネットアクセスが必要です。クラスターがインターネットに接続されている場合、Telemetry は自動的に実行され、クラスターは Red Hat OpenShift Cluster Manager (OCM) に登録されます。
Red Hat OpenShift Cluster Manager インベントリーが Telemetry によって自動的に維持されるか、または OCM を手動で使用しているかのいずれによって正常であることを確認した後に、subscription watch を使用して、アカウントまたはマルチクラスターレベルで OpenShift Container Platform サブスクリプションを追跡します。
インターネットへのアクセスは以下を実行するために必要です。
- Red Hat OpenShift Cluster Manager ページにアクセスし、インストールプログラムをダウンロードし、サブスクリプション管理を実行します。クラスターにインターネットアクセスがあり、Telemetry を無効にしない場合、そのサービスは有効なサブスクリプションでクラスターを自動的に使用します。
- クラスターのインストールに必要なパッケージを取得するために Quay.io にアクセスします。
- クラスターの更新を実行するために必要なパッケージを取得します。
クラスターでインターネットに直接アクセスできない場合、プロビジョニングする一部のタイプのインフラストラクチャーでネットワークが制限されたインストールを実行できます。このプロセスで、必要なコンテンツをダウンロードし、これを使用してミラーレジストリーにクラスターのインストールおよびインストールプログラムの生成に必要なパッケージを設定します。インストールタイプによっては、クラスターのインストール環境でインターネットアクセスが不要となる場合があります。クラスターを更新する前に、ミラーレジストリーのコンテンツを更新します。
1.3.3. SSH プライベートキーの生成およびエージェントへの追加
					クラスターでインストールのデバッグまたは障害復旧を実行する必要がある場合、ssh-agent とインストールプログラムの両方に SSH キーを指定する必要があります。
				
実稼働環境では、障害復旧およびデバッグが必要です。
					このキーを使用して、ユーザー core としてマスターノードに対して SSH を実行できます。クラスターをデプロイする際に、キーは core ユーザーの ~/.ssh/authorized_keys 一覧に追加されます。
				
AWS キーペアなどのプラットフォームに固有の方法で設定したキーではなく、ローカルキーを使用する必要があります。
手順
- パスワードなしの認証に設定されている SSH キーがコンピューター上にない場合は、これを作成します。たとえば、Linux オペレーティングシステムを使用するコンピューターで以下のコマンドを実行します。 - ssh-keygen -t rsa -b 4096 -N '' \ -f <path>/<file_name>- $ ssh-keygen -t rsa -b 4096 -N '' \ -f <path>/<file_name>- 1 - Copy to Clipboard Copied! - Toggle word wrap Toggle overflow - 1
- ~/.ssh/id_rsaなどの、SSH キーのパスおよびファイル名を指定します。既存の SSH キーは上書きされるため、指定しないでください。
 - このコマンドを実行すると、指定した場所にパスワードを必要としない SSH キーが生成されます。 
- ssh-agentプロセスをバックグラウンドタスクとして開始します。- eval "$(ssh-agent -s)" - $ eval "$(ssh-agent -s)" Agent pid 31874- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- SSH プライベートキーを - ssh-agentに追加します。- ssh-add <path>/<file_name> - $ ssh-add <path>/<file_name>- 1 - Identity added: /home/<you>/<path>/<file_name> (<computer_name>)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow - 1
- ~/.ssh/id_rsaなどの、SSH プライベートキーのパスおよびファイル名を指定します。
 
次のステップ
- OpenShift Container Platform をインストールする際に、SSH パブリックキーをインストールプログラムに指定します。
1.3.4. インストールプログラムの取得
OpenShift Container Platform をインストールする前に、インストールファイルをローカルコンピューターにダウンロードします。
前提条件
- Linux または macOS を使用するコンピューターからクラスターをインストールする必要があります。
- インストールプログラムをダウンロードするには、500 MB のローカルディスク領域が必要です。
手順
- Red Hat OpenShift Cluster Manager サイトの「Infrastructure Provider」ページにアクセスします。Red Hat アカウントがある場合は、認証情報を使ってログインします。アカウントがない場合はこれを作成します。
- 選択するインストールタイプのページに移動し、オペレーティングシステムのインストールプログラムをダウンロードし、ファイルをインストール設定ファイルを保存するディレクトリーに配置します。 重要- インストールプログラムは、クラスターのインストールに使用するコンピューターにいくつかのファイルを作成します。クラスターインストールの完了後は、インストールプログラムおよびインストールプログラムが作成するファイルの両方を保持する必要があります。 重要- インストールプログラムで作成されたファイルを削除しても、クラスターがインストール時に失敗した場合でもクラスターは削除されません。特定のクラウドプロバイダー用に記載された OpenShift Container Platform のアンインストール手順を完了して、クラスターを完全に削除する必要があります。 
- インストールプログラムを展開します。たとえば、Linux オペレーティングシステムを使用するコンピューターで以下のコマンドを実行します。 - tar xvf <installation_program>.tar.gz - $ tar xvf <installation_program>.tar.gz- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 
							Red Hat OpenShift Cluster Manager サイトの「Pull Secret」ページから、インストールプルシークレットを .txtファイルとしてダウンロードします。このプルシークレットを使用し、OpenShift Container Platform コンポーネントのコンテナーイメージを提供する Quay.io など、組み込まれた各種の認証局によって提供されるサービスで認証できます。
1.3.5. インストール設定ファイルの作成
Amazon Web Services (AWS) での OpenShift Container Platform のインストールをカスタマイズできます。
前提条件
- OpenShift Container Platform インストールプログラム、およびクラスターのプルシークレットを取得します。
手順
- install-config.yamlファイルを作成します。- 以下のコマンドを実行します。 - ./openshift-install create install-config --dir=<installation_directory> - $ ./openshift-install create install-config --dir=<installation_directory>- 1 - Copy to Clipboard Copied! - Toggle word wrap Toggle overflow - 1
- <installation_directory>の場合、インストールプログラムが作成するファイルを保存するためにディレクトリー名を指定します。
 重要- 空のディレクトリーを指定します。ブートストラップ X.509 証明書などの一部のインストールアセットの有効期限は短く設定されているため、インストールディレクトリーを再利用することができません。別のクラスターインストールの個別のファイルを再利用する必要がある場合は、それらをディレクトリーにコピーすることができます。ただし、インストールアセットのファイル名はリリース間で変更される可能性があります。インストールファイルを以前のバージョンの OpenShift Container Platform からコピーする場合は注意してコピーを行ってください。 
- プロンプト時に、クラウドの設定の詳細情報を指定します。 - オプション: クラスターマシンにアクセスするために使用する SSH キーを選択します。 注記- インストールのデバッグまたは障害復旧を実行する必要のある実稼働用の OpenShift Container Platform クラスターでは、 - ssh-agentプロセスが使用する SSH キーを指定します。
- ターゲットに設定するプラットフォームとして AWS を選択します。
- Amazon Web Services (AWS) プロファイルをコンピューターに保存していない場合、インストールプログラムを実行するように設定したユーザーの AWS アクセスキー ID およびシークレットアクセスキーを入力します。
- クラスターのデプロイ先とする AWS リージョンを選択します。
- クラスターに設定した Route53 サービスのベースドメインを選択します。
- クラスターの記述名を入力します。
- Red Hat OpenShift Cluster Manager サイトの「Pull Secret」ページから取得したプルシークレットを貼り付けます。
 
 
- 
							install-config.yamlファイルを変更します。利用可能なパラメーターの詳細については、「インストール設定パラメーター」セクションを参照してください。
- install-config.yamlファイルをバックアップし、これを複数のクラスターをインストールするために使用できるようにします。重要- install-config.yamlファイルはインストールプロセス時に使用されます。このファイルを再利用する必要がある場合は、この段階でこれをバックアップしてください。
1.3.5.1. インストール設定パラメーター
						OpenShift Container Platform クラスターをデプロイする前に、クラスターをホストするクラウドプラットフォームでアカウントを記述し、クラスターのプラットフォームをオプションでカスタマイズするためにパラメーターの値を指定します。install-config.yaml インストール設定ファイルを作成する際に、コマンドラインで必要なパラメーターの値を指定します。クラスターをカスタマイズする場合、install-config.yaml ファイルを変更して、プラットフォームについての詳細情報を指定できます。
					
							インストール後は、install-config.yaml ファイルでこれらのパラメーターを変更することはできません。
						
| パラメーター | 説明 | 値 | 
|---|---|---|
| 
										 | 
										クラウドプロバイダーのベースドメイン。この値は、OpenShift Container Platform クラスターコンポーネントへのルートを作成するために使用されます。クラスターの完全な DNS 名は、 | 
										 | 
| 
										 | 
										コントロールプレーンマシンをホストするためのクラウドプロバイダー。このパラメーターの値は  | 
										 | 
| 
										 | 
										ワーカーマシンをホストするためのクラウドプロバイダー。このパラメーターの値は  | 
										 | 
| 
										 | クラスターの名前。 | 
										 | 
| 
										 | クラスターをデプロイするリージョン。 | 
										AWS の  | 
| 
										 | Red Hat OpenShift Cluster Manager サイトの「Pull Secret」ページから取得したプルシークレット。このプルシークレットを使用し、OpenShift Container Platform コンポーネントのコンテナーイメージを提供する、Quay.io などの組み込まれた各種の認証局によって提供されるサービスで認証できます。 |  | 
| パラメーター | 説明 | 値 | 
|---|---|---|
| 
										 | クラスターマシンにアクセスするために使用する SSH キー。 注記 
											インストールのデバッグまたは障害復旧を実行する必要のある実稼働用の OpenShift Container Platform クラスターでは、 | 
										 | 
| 
										 | FIPS モードを有効または無効にするかどうか。デフォルトでは、FIPS モードは有効にされません。FIPS モードが有効にされている場合、OpenShift Container Platform が実行される Red Hat Enterprise Linux CoreOS (RHCOS) マシンがデフォルトの Kubernetes 暗号スイートをバイパスし、代わりに RHCOS で提供される暗号モジュールを使用します。 | 
										 | 
| 
										 | クラスターのユーザーに表示されるエンドポイントを公開する方法。 | 
										 | 
| 
										 | 
										コンピュートマシンで同時マルチスレッドまたは  重要 同時スレッドを無効にする場合は、容量計画においてマシンパフォーマンスの大幅な低下が考慮に入れられていることを確認します。 | 
										 | 
| 
										 | プロビジョニングするコンピュートマシン(ワーカーマシンとしても知られる)の数。 | 
										 | 
| 
										 | 
										コントロールプレーンマシンで同時マルチスレッドまたは  重要 同時スレッドを無効にする場合は、容量計画においてマシンパフォーマンスの大幅な低下が考慮に入れられていることを確認します。 | 
										 | 
| 
										 | プロビジョニングするコントロールプレーンマシンの数。 | 
										 | 
| パラメーター | 説明 | 値 | 
|---|---|---|
| 
										 | ルートボリュームに予約される 1 秒あたりの入出力操作 (IOPS)。 | 
										整数 (例:  | 
| 
										 | ルートボリュームのサイズ (GiB)。 | 
										整数 (例:  | 
| 
										 | ルートボリュームのインスタンスタイプ。 | 
										有効な AWS EBS インスタンスタイプ (例:  | 
| 
										 | コンピュートマシンの EC2 インスタンスタイプ。 | 
										有効な AWS インスタンスタイプ (例:  | 
| 
										 | インストールプログラムがコンピュート MachinePool のマシンを作成するアベイラビリティーゾーン。独自の VPC を指定する場合は、そのアベイラビリティーゾーンにサブネットを指定する必要があります。 | 
										 | 
| 
										 | インストールプログラムがコンピュートリソースを作成する AWS リージョン。 | 
										有効な AWS リージョン (例:  | 
| 
										 | コントロールプレーンマシンの EC2 インスタンスタイプ。 | 
										有効な AWS インスタンスタイプ (例:  | 
| 
										 | インストールプログラムがコントロールプレーン MachinePool のマシンを作成するアベイラビリティーゾーン。 | 
										 | 
| 
										 | インストールプログラムがコントロールプレーンのリソースを作成する AWS リージョン。 | 
										有効な AWS リージョン (例:  | 
| 
										 | インストールプログラムが、作成するすべてのリソースに対するタグとして追加するキーと値のマップ。 | 
										 | 
| 
										 | 
										インストールプログラムによる VPC の作成を許可する代わりに VPC を指定する場合は、使用するクラスターのサブネットを指定します。サブネットは、指定する同じ  | 有効なサブネット ID です。 | 
1.3.5.2. AWS のカスタマイズされた install-config.yaml ファイルのサンプル
						install-config.yaml ファイルをカスタマイズして、OpenShift Container Platform クラスターのプラットフォームについての詳細を指定するか、または必要なパラメーターの値を変更することができます。
					
							このサンプルの YAML ファイルは参照用にのみ提供されます。インストールプログラムを使用して install-config.yaml ファイルを取得し、これを変更する必要があります。
						
- 1 9 10 11
- 必須。インストールプログラムはこの値の入力を求めるプロンプトを出します。
- 2 6
- これらのパラメーターおよび値を指定しない場合、インストールプログラムはデフォルトの値を指定します。
- 3 7
- controlPlaneセクションは単一マッピングですが、コンピュートセクションはマッピングのシーケンスになります。複数の異なるデータ構造の要件を満たすには、- computeセクションの最初の行はハイフン- -で始め、- controlPlaneセクションの最初の行はハイフンで始めることができません。どちらのセクションも、現時点では単一のマシンプールを定義しますが、OpenShift Container Platform の今後のバージョンでは、インストール時の複数のコンピュートプールの定義をサポートする可能性があります。1 つのコントロールプレーンプールのみが使用されます。
- 4 5
- 同時マルチスレッドまたはhyperthreadingを有効/無効にするかどうか。デフォルトでは、同時スレッドはマシンのコアのパフォーマンスを上げるために有効にされます。パラメーター値をDisabledに設定するとこれを無効にすることができます。一部のクラスターマシンで同時マルチスレッドを無効にする場合は、これをすべてのクラスターマシンで無効にする必要があります。重要同時スレッドを無効にする場合は、容量計画においてマシンパフォーマンスの大幅な低下が考慮に入れられていることを確認します。同時マルチスレッドを無効にする場合は、マシンに対して m4.2xlargeまたはm5.2xlargeなどの大規模なインスタンスタイプを使用します。
- 8
- 大規模なクラスターの場合などに etcd の高速のストレージを設定するには、ストレージタイプをio1として設定し、iopsを2000に設定します。
- 12
- FIPS モードを有効または無効にするかどうか。デフォルトでは、FIPS モードは有効にされません。FIPS モードが有効にされている場合、OpenShift Container Platform が実行される Red Hat Enterprise Linux CoreOS (RHCOS) マシンがデフォルトの Kubernetes 暗号スイートをバイパスし、代わりに RHCOS で提供される暗号モジュールを使用します。
- 13
- クラスター内のマシンにアクセスするために使用するsshKey値をオプションで指定できます。注記インストールのデバッグまたは障害復旧を実行する必要のある実稼働用の OpenShift Container Platform クラスターでは、 ssh-agentプロセスが使用する SSH キーを指定します。
1.3.6. クラスターのデプロイ
互換性のあるクラウドプラットフォームに OpenShift Container Platform をインストールできます。
						インストールプログラムの create cluster コマンドは、初期インストール時に 1 回だけ実行できます。
					
前提条件
- クラスターをホストするクラウドプラットフォームでアカウントを設定します。
- OpenShift Container Platform インストールプログラム、およびクラスターのプルシークレットを取得します。
手順
- インストールプログラムを実行します。 - ./openshift-install create cluster --dir=<installation_directory> \ --log-level=info- $ ./openshift-install create cluster --dir=<installation_directory> \- 1 - --log-level=info- 2 - Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 注記- ホストに設定した AWS アカウントにクラスターをデプロイするための十分なパーミッションがない場合、インストールプログラムは停止し、不足しているパーミッションが表示されます。 - クラスターのデプロイメントが完了すると、Web コンソールへのリンクや - kubeadminユーザーの認証情報を含む、クラスターにアクセスするための指示がターミナルに表示されます。重要- インストールプログラムが生成する Ignition 設定ファイルには、24 時間が経過すると期限切れになる証明書が含まれます。最初の証明書のローテーションが正常に実行されるようにするには、クラスターを動作が低下していない状態で 24 時間実行し続ける必要があります。 重要- インストールプログラム、またはインストールプログラムが作成するファイルを削除することはできません。これらはいずれもクラスターを削除するために必要になります。 
- 
							オプション: クラスターのインストールに使用した IAM アカウントから AdministratorAccessポリシーを削除するか、または無効にします。
1.3.7. バイナリーのダウンロードによる CLI のインストール
					コマンドラインインターフェースを使用して OpenShift Container Platform と対話するために CLI (oc) をインストールすることができます。oc は Linux、Windows、または macOS にインストールできます。
				
						以前のバージョンの oc をインストールしている場合、これを使用して OpenShift Container Platform 4.3 のすべてのコマンドを実行することはできません。新規バージョンの oc をダウンロードし、インストールします。
					
1.3.7.1. Linux への CLI のインストール
						以下の手順を使用して、OpenShift CLI (oc) バイナリーを Linux にインストールできます。
					
手順
- Red Hat OpenShift Cluster Manager サイトの「Infrastructure Provider」ページに移動します。
- インフラストラクチャープロバイダーを選択し、(該当する場合は) インストールタイプを選択します。
- Command-line interface セクションで、ドロップダウンメニューの Linux を選択し、Download command-line tools をクリックします。
- アーカイブを展開します。 - tar xvzf <file> - $ tar xvzf <file>- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- ocバイナリーを、- PATHにあるディレクトリーに配置します。- PATHを確認するには、以下のコマンドを実行します。- echo $PATH - $ echo $PATH- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
						CLI のインストール後は、oc コマンドを使用して利用できます。
					
oc <command>
$ oc <command>1.3.7.2. Windows での CLI のインストール
						以下の手順を使用して、OpenShift CLI (oc) バイナリーを Windows にインストールできます。
					
手順
- Red Hat OpenShift Cluster Manager サイトの「Infrastructure Provider」ページに移動します。
- インフラストラクチャープロバイダーを選択し、(該当する場合は) インストールタイプを選択します。
- Command-line interface セクションで、ドロップダウンメニューの Windows を選択し、Download command-line tools をクリックします。
- ZIP プログラムでアーカイブを解凍します。
- ocバイナリーを、- PATHにあるディレクトリーに移動します。- PATHを確認するには、コマンドプロンプトを開いて以下のコマンドを実行します。- path - C:\> path- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
						CLI のインストール後は、oc コマンドを使用して利用できます。
					
oc <command>
C:\> oc <command>1.3.7.3. macOS への CLI のインストール
						以下の手順を使用して、OpenShift CLI (oc) バイナリーを macOS にインストールできます。
					
手順
- Red Hat OpenShift Cluster Manager サイトの「Infrastructure Provider」ページに移動します。
- インフラストラクチャープロバイダーを選択し、(該当する場合は) インストールタイプを選択します。
- Command-line interface セクションで、ドロップダウンメニューの MacOS を選択し、Download command-line tools をクリックします。
- アーカイブを展開し、解凍します。
- ocバイナリーをパスにあるディレクトリーに移動します。- PATHを確認するには、ターミナルを開き、以下のコマンドを実行します。- echo $PATH - $ echo $PATH- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
						CLI のインストール後は、oc コマンドを使用して利用できます。
					
oc <command>
$ oc <command>1.3.8. クラスターへのログイン
					クラスター kubeconfig ファイルをエクスポートし、デフォルトシステムユーザーとしてクラスターにログインできます。kubeconfig ファイルには、クライアントを正しいクラスターおよび API サーバーに接続するために CLI で使用されるクラスターについての情報が含まれます。このファイルはクラスターに固有のファイルであり、OpenShift Container Platform のインストール時に作成されます。
				
前提条件
- OpenShift Container Platform クラスターをデプロイします。
- 
							ocCLI をインストールします。
手順
- kubeadmin認証情報をエクスポートします。- export KUBECONFIG=<installation_directory>/auth/kubeconfig - $ export KUBECONFIG=<installation_directory>/auth/kubeconfig- 1 - Copy to Clipboard Copied! - Toggle word wrap Toggle overflow - 1
- <installation_directory>には、インストールファイルを保存したディレクトリーへのパスを指定します。
 
- エクスポートされた設定を使用して、 - ocコマンドを正常に実行できることを確認します。- oc whoami - $ oc whoami system:admin- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
1.3.9. 次のステップ
- クラスターをカスタマイズします。
- 必要な場合は、リモートの健全性レポートをオプトアウトすることができます。