スタートガイド
OpenShift Dedicated のスタートガイド
概要
第1章 クラウドのデプロイメントオプションについて リンクのコピーリンクがクリップボードにコピーされました!
独自に所有するか Red Hat が所有するクラウドアカウントを使用して、OpenShift Dedicated を Amazon Web Services (AWS) または Google Cloud にインストールできます。このドキュメントでは、OpenShift Dedicated クラスターのクラウドデプロイメントオプションを説明します。
1.1. OpenShift Dedicated クラウドデプロイメントオプションの概要 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Dedicated は、OpenShift Container Platform クラスターを Amazon Web Services (AWS) または Google Cloud 上のマネージドサービスとして提供します。
Customer Cloud Subscription (CCS) モデルを使用して、所有している既存の AWS または Google Cloud クラウドアカウントにクラスターをデプロイすることができます。
または、Red Hat が所有するクラウドアカウントに OpenShift Dedicated をインストールすることもできます。
1.1.1. Customer Cloud Subscription (CCS) モデルを使用したクラスターのデプロイメント リンクのコピーリンクがクリップボードにコピーされました!
Customer Cloud Subscription (CCS) モデルを使用すると、お客様が所有する既存の Amazon Web Services (AWS) または Google Cloud アカウントに、Red Hat が管理する OpenShift Dedicated クラスターをデプロイできます。Red Hat はこのサービスを提供するためにいくつかの前提条件を満たすことを要求しており、このサービスは Red Hat の Site Reliability Engineers (SRE) によってサポートされています。
CCS モデルでは、お客様はクラウドインフラストラクチャープロバイダーにクラウド費用を直接支払い、クラウドインフラストラクチャーアカウントはお客様が所有する組織の一部であり、Red Hat には特定のアクセス権が付与されます。このモデルでは、お客様は Red Hat に CCS のサブスクリプション料金を支払い、クラウドプロバイダーにクラウド費用を支払います。
CCS モデルを利用することで、Red Hat が提供するサービスに加えて、クラウドプロバイダーが提供するサービスも利用できるようになります。
1.1.2. Red Hat クラウドアカウントへのクラスターのデプロイ リンクのコピーリンクがクリップボードにコピーされました!
CCS モデルの代替案として、Red Hat が所有する AWS または Google Cloud のクラウドアカウントに OpenShift Dedicated クラスターをデプロイすることもできます。このモデルでは、Red Hat がクラウドアカウントを管理し、クラウドインフラストラクチャーのコストは Red Hat が直接支払います。お客様は Red Hat のサブスクリプション費用のみを支払います。
1.2. 関連情報 リンクのコピーリンクがクリップボードにコピーされました!
第2章 OpenShift Dedicated のスタートガイド リンクのコピーリンクがクリップボードにコピーされました!
この入門ドキュメントに従って、OpenShift Dedicated クラスターを作成し、ユーザーアクセス権を付与し、最初のアプリケーションをデプロイし、クラスターのスケーリングと削除の方法を学習してください。
Google Cloud 上にデプロイされた OpenShift Dedicated クラスターの場合、セキュリティーが強化されるため、Red Hat は、Google Cloud Workload Identity Federation (WIF) を認証タイプとして使用し、Google Cloud 上にデプロイされた OpenShift Dedicated クラスターのインストールおよび操作を行うことを推奨します。
Red Hat では、パブリック Ingress ネットワークトラフィックをすべて回避するために、Private Service Connect (PSC) を使用してプライベートクラスターモードで Google Cloud にデプロイされた OpenShift Dedicated クラスターを作成し、クラスターを管理および監視することが推奨されます。詳細は、Private Service Connect の概要 を参照してください。
2.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- OpenShift Dedicated の概要 と、アーキテクチャーの概念 に関するドキュメントを確認している。
- OpenShift Dedicated クラウドデプロイメントオプション を確認している。
2.2. OCM CLI を使用した Workload Identity Federation クラスターの作成 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Cluster Manager CLI (ocm) を使用すると、interactive モードまたは non-interactive モードで、Workload Identity Federation (WIF) を使用する Google Cloud 上の OpenShift Dedicated クラスターを作成できます。
前提条件
- WIF 設定が作成されている。詳細は、「Workload Identity Federation 設定の作成」を参照してください。
-
OpenShift Cluster Manager の Downloads ページから、OpenShift Cluster Manager CLI (
ocm) の最新バージョンがダウンロードされている。
手順
WIF クラスターは、対話型 モードまたは 非対話型 モードのいずれかを使用して作成できます。
interactive モードでは、クラスターの作成中にクラスター属性がプロンプトとして自動的に表示されます。指定された要件に基づいて、表示されるフィールドにプロンプトの値を入力します。
non-interactive モードでは、コマンド内の特定パラメーターの値を指定します。
選択したモードに応じて、次のコマンドのいずれかを実行して、WIF 設定を使用して Google Cloud 上に OpenShift Dedicated クラスターを作成します。
interactive モードでクラスターを作成するには、次のコマンドを実行します。
$ ocm create cluster --interactive各項目の説明:
--interactive-
クラスターが対話モードで作成されることを指定します。このモードでは、クラスター作成時に必要な設定オプションを入力するよう求められます。このパラメーターを指定しない場合、クラスターはデフォルトで
非対話モードで作成されます。
以下のコマンドを実行して、非対話モードでクラスターを作成します。以下の例は、オプションのパラメーターと必須のパラメーターで設定されており、
非対話モードのコマンドとは異なる場合があります。オプションと記載されていないパラメーターは必須です。これらのパラメーターやその他のパラメーターの詳細を確認するには、ターミナルウィンドウでocm create cluster --help flagコマンドを実行してください。$ ocm create cluster <cluster_name> \ --provider=gcp \ --ccs=true \ --wif-config <wif_name> \ --dns-zone-id <dns_zone_id> \ --region <gcp_region> \ --subscription-type=marketplace-gcp \ --marketplace-gcp-terms=true \ --version <version> \ --multi-az=true \ --enable-autoscaling=true \ --min-replicas=3 \ --max-replicas=6 \ --secure-boot-for-shielded-vms=true --channel-group <channel_group_name>各項目の説明:
<cluster_name>-
クラスターの名前を指定します。
<cluster_name>は、クラスターの名前に置き換えます。 --provider=gcp- クラスターのクラウドプロバイダーを指定します。
--ccs=true- このクラスターが Customer Cloud Subscription (CCS) クラスターであることを指定します。
--wif-config <wif_name>-
クラスターに割り当てる WIF 設定の名前を指定します。
<wif_name>は、WIF 設定の名前に置き換えます。 --dns-zone-id <dns_zone_id>-
オプション: クラスターに使用する DNS ゾーン ID を指定します。
<dns_zone_id> を、ご使用の DNS ゾーンの ID に置き換えてください。このパラメーターの詳細は、関連情報 セクションの マネージド DNS ゾーンの作成を 参照してください。 -- リージョン <gcp_region>-
新しいクラスターがデプロイされる Google Cloud リージョンを指定します。
<gcp_region> を目的の Google Cloud リージョンに置き換えてください。 --subscription-type=marketplace-gcp- オプション: クラスターのサブスクリプション課金モデルを指定します。
--marketplace-gcp-terms=true-
OpenShift Dedicated 製品リストに関する Google Cloud Marketplace の利用規約に同意したことを確認します。
subscription-typeパラメーターにmarketplace-gcpという値を指定した場合、このパラメーターは必須です。 --version < バージョン >希望する OpenShift Dedicated のバージョンを指定します。このパラメーターは任意です。ただし、OpenShift Dedicated バージョンが指定されている場合は、そのバージョンが割り当てられた WIF 設定でサポートされている必要があります。割り当てられた WIF 設定でサポートされていないバージョンが指定されている場合、クラスターの作成に失敗します。この場合は、割り当てられている WIF 設定を目的のバージョンに更新するか、目的のバージョンで新しい WIF 設定を作成してください。バージョンを指定しない場合、割り当てられた WIF 設定のデフォルトバージョンでクラスターが作成されます。
WIF 設定でサポートされているバージョンに関する詳細は、Workload Identity Federation 設定の作成を参照してください。
--multi-az=true- クラスターが複数のデータセンターに展開されていることを指定します。このパラメーターは任意です。
--enable-autoscaling=true- コンピュートノードの自動スケーリングを有効にします。このパラメーターは任意です。
--min-replicas=3- コンピュートノードの最小数を指定します。このパラメーターは任意です。
--max-replicas=6- コンピュートノードの最大数を指定します。このパラメーターは任意です。
--secure-boot-for-shielded-vms=true- セキュアブートを有効にすることで、Google Cloud でシールドされた仮想マシンを使用できるようになります。このパラメーターは任意です。
--channel-group <channel_group_name>-
クラスターを割り当てるチャネルグループの名前を指定します。チャネルグループのオプションには
stableとeusが含まれます。<channel_group_name> を目的のチャネルグループ名に置き換えてください。このパラメーターは任意です。
インストール中にクラスターのデプロイメントが失敗すると、インストールプロセス中に作成された特定のリソースが Google Cloud アカウントから自動的に削除されません。Google Cloud アカウントからこれらのリソースを削除するには、障害が発生したクラスターを削除する必要があります。詳細は、Google Cloud 上の OpenShift Dedicated クラスターの削除を参照してください。
検証
クラスターが正常に作成されたことを確認するには、次のコマンドを実行します。
$ ocm get cluster <cluster_name>クラスターが正常に作成された場合、出力にはクラスターの状態が
準備完了と表示されます。
2.3. AWS でのクラスターの作成 リンクのコピーリンクがクリップボードにコピーされました!
Customer Cloud Subscription (CCS) または Red Hat クラウドアカウントの課金モデルを使用して OpenShift Dedicated クラスターをデプロイすることで、財務管理をより強化できます。AWS Identity and Access Management (IAM) ロール、Virtual Private Cloud (VPC) ネットワーク、および PrivateLink を設定することで、セキュリティーを確保しながら、クラスターを既存のインフラストラクチャーに統合できます。
前提条件
あなたは以下のタスクを完了しました。
- OpenShift Dedicated で使用するために、AWS アカウントを設定してください。
- AWS アカウントにサービスがデプロイされていないことを確認してください。
- 指定されたクラスターサイズをサポートするために必要な AWS アカウントのクォータと制限を設定します。
-
AdministratorAccessポリシーがアタッチされたosdCcsAdminAWS Identity and Access Management (IAM) ユーザーを作成します。 - AWS 組織内でサービス制御ポリシー (SCP) を設定します。詳細は、Minimum required service control policy (SCP) を参照してください。
- AWS の Business Support またはそれ以上のサービスを用意することを検討してください。
- クラスター全体にプロキシーを設定する場合は、そのプロキシーがクラスターをインストールした VPC からアクセスできることを確認してください。
- VPC のプライベートサブネットからプロキシーにアクセスできることを確認してください。
手順
- OpenShift Cluster Manager にログインします。
- Overview ページで、Red Hat OpenShift Dedicated カードの Create cluster を選択します。
Billing model セクションで、サブスクリプションのタイプおよびインフラストラクチャーのタイプを設定します。
サブスクリプションのタイプを選択します。OpenShift Dedicated サブスクリプションオプションは、OpenShift Cluster Manager ドキュメントの クラスターのサブスクリプションと登録 を参照してください。
注記利用可能なサブスクリプションタイプは、OpenShift Dedicated のサブスクリプションおよびリソースクォータに応じて異なります。詳細は、営業担当者または Red Hat サポートにお問い合わせください。
- 所有する既存のクラウドプロバイダーアカウントに OpenShift Dedicated をデプロイするには、インフラストラクチャータイプとして Customer Cloud Subscription を 選択するか、Red Hat クラウド プロバイダーアカウントに OpenShift Dedicated をデプロイするには、インフラストラクチャータイプとして Red Hat クラウドアカウントを選択してください。
- Next をクリックします。
Run on Amazon Web Services を選択します。AWS アカウントでクラスターをプロビジョニングする場合は、次のサブステップを実行します。
- 記載されている Prerequisites (前提条件) を確認して完了します。
- チェックボックスを選択して、すべての前提条件を読み、完了したことを確認します。
AWS アカウントの詳細を入力してください。
- AWS アカウント ID を入力します。
AWS IAM ユーザーアカウントの AWS アクセスキー ID および AWS シークレットアクセスキー を入力します。
注記AWS でこれらの認証情報を取り消すと、これらの認証情報を使用して作成されたクラスターへのアクセスが失われます。
オプション: Bypass AWS Service Control Policy (SCP) checks を選択して、SCP チェックを無効にできます。
注記AWS SCP によっては、必要なパーミッションがある場合でもインストールに失敗することがあります。SCP チェックを無効にすると、インストールを続行できます。チェックを回避した場合でも、SCP は実行され続ける。
- Next をクリックしてクラウドプロバイダーアカウントを検証し、Cluster details ページに移動します。
クラスターの詳細 ページで、クラスターの名前を入力し、クラスターの詳細を指定します。
- Cluster name を追加します。
オプション: クラスターを作成すると、
openshiftapps.comにプロビジョニングされたクラスターのサブドメインとしてドメイン接頭辞が生成されます。クラスター名が 15 文字以下の場合、ドメインプレフィックスにはその名前が使用されます。クラスター名が 15 文字を超えると、ドメイン接頭辞が 15 文字の文字列にランダムに生成されます。サブドメインをカスタマイズするには、Create customize domain prefix チェックボックスをオンにし、Domain prefix フィールドにドメイン接頭辞名を入力します。ドメイン接頭辞は 15 文字を超えてはならず、組織内で一意である必要があり、クラスターの作成後に変更できません。
- Version ドロップダウンメニューからクラスターバージョンを選択します。
- Region ドロップダウンメニューからクラウドプロバイダーのリージョンを選択します。
- Single zone または Multi-zone 設定を選択します。
- Enable user workload monitoring を選択したままにして、Red Hat サイト信頼性エンジニアリング (SRE) プラットフォームメトリックから切り離して独自のプロジェクトをモニターします。このオプションはデフォルトで有効になっています。
オプション: Advanced Encryption を展開して、暗号化設定を変更します。
デフォルトの AWS KMS キーを使用するには、デフォルト設定の Use default KMS Keys をそのまま使用します。または、カスタム KMS キーを使用するには、Use Custom KMS keys を選択します。
- Use Custom KMS keys を選択した場合は、Key ARN フィールドに AWS Key Management Service (KMS) カスタムキーの Amazon Resource Name (ARN) ARN を入力します。このキーを使用して、クラスター内のすべてのコントロールプレーン、インフラストラクチャー、ワーカーノードのルートボリューム、および永続ボリュームを暗号化します。
オプション: クラスターで FIPS 検証を必須にする場合は、Enable FIPS cryptography を選択します。
注記FIPS 暗号化を有効にする を選択すると、デフォルトで 追加の etcd 暗号化が 有効になり、この機能を無効にすることはできません。Enable FIPS cryptography を選択しなくても、Enable additional etcd encryption は選択できます。
オプション: etcd キー値の暗号化が必要な場合は、Enable additional etcd encryption を選択します。このオプションを使用すると、etcd キーの値は暗号化されますが、キーは暗号化されません。このオプションは、デフォルトで OpenShift Dedicated クラスターの etcd ボリュームを暗号化するコントロールプレーンのストレージ暗号化に追加されます。
注記etcd 内のキー値に対して etcd 暗号化を有効にすると、ワークロードのパフォーマンスオーバーヘッドが約 20% 増加します。ワークロードの増加は、etcd ボリュームを暗号化するデフォルトの制御プレーンストレージ暗号化に加えて、この第 2 の暗号化レイヤーを導入したことによるものです。お客様のユースケースで特に etcd 暗号化が必要な場合にのみ、暗号化を有効にすることを検討してください。
- Next をクリックします。
- Default machine pool ページで、ドロップダウンメニューから Compute node instance type を選択します。
オプション: 自動スケーリングを有効にするには、Enable autoscaling チェックボックスを選択します。
- 自動スケーリング設定を変更するには、Edit cluster autoscaling settings をクリックします。
- 変更を加えたら、閉じる をクリックしてください。
- 最小および最大のノード数を選択します。利用可能なプラス記号とマイナス記号を使用するか、数値入力フィールドにノード数を入力することで、ノード数を選択します。
ドロップダウンメニューから Compute node count を選択します。
注記クラスターを作成した後、クラスター内のコンピュートノードの数は変更できますが、マシンプール内のコンピュートノードのインスタンスタイプは変更できません。利用可能なノード数および種類は、OpenShift Dedicated のサブスクリプションに応じて異なります。
Instance Metadata Service (IMDS) タイプを設定します。IMDSv1 と IMDSv2 の両方のタイプを使用するか、EC2 インスタンスで IMDSv2 のみを使用するように要求します。実行中のインスタンスからインスタンスメタデータにアクセスするには、以下の 2 つの方法があります。
- Instance Metadata Service バージョン 1 (IMDSv1) - リクエスト/レスポンスメソッド
Instance Metadata Service バージョン 2 (IMDSv2) - セッション指向のメソッド
重要クラスターを作成した後は、インスタンスメタデータサービスの設定を変更することはできません。
注記IMDSv2 はセッション指向のリクエストを使用します。セッション指向のリクエストでは、セッション期間を定義するセッショントークンを作成します。セッション期間は最小 1 秒、最大 6 時間です。指定された期間中は、同じセッショントークンを以降のリクエストにも使用できます。指定された期間が経過した後は、今後のリクエストに使用する新しいセッショントークンを作成する必要があります。
IMDS の詳細は、AWS ドキュメントの Instance metadata and user data を参照してください。
- オプション: Edit node labels を展開してラベルをノードに追加します。Add label をクリックしてさらにノードラベルを追加し、Next を選択します。
Network configuration ページで Public または Private を選択し、クラスターのパブリックまたはプライベート API エンドポイントおよびアプリケーションルートを使用します。
重要プライベート API エンドポイントを使用している場合は、クラウドプロバイダーアカウントのネットワーク設定を更新するまでクラスターにアクセスできません。
オプション: クラスターを既存の AWS Virtual Private Cloud (VPC) にインストールするには、以下を実行します。
注記別のクラスター用にインストーラーによって自動的に作成された VPC に新しい OpenShift Dedicated クラスターをインストールすることはサポートされていません。
- Install into an existing VPC を選択します。
既存の VPC にインストールし、プライベート API エンドポイントを使用することを選択した場合は、Use a PrivateLink を選択します。このオプションを選択した場合に、AWS PrivateLink エンドポイントのみを使用した Red Hat Site Reliability Engineering (SRE) によるクラスターへの接続が可能になります。
注記クラスターを作成した後は、プライベートリンクを使用する オプションを変更することはできません。
- 既存の VPC にインストールし、クラスターの HTTP または HTTPS プロキシーを有効にする場合は、Configure a cluster-wide proxy を参照してください。
既存の AWS VPC にクラスターをインストールすることを選択した場合は、Virtual Private Cloud (VPC) サブネットの設定を 入力し、[次へ] を選択します。Cloud ネットワークアドレス変換 (NAT) と Cloud ルーターを作成しておく必要があります。Cloud NAT と Google VPC は、「関連情報」のセクションを参照してください。
注記クラスターをインストールする各アベイラビリティーゾーンごとに、パブリックサブネットとプライベートサブネットを VPC に設定してください。PrivateLink を使用する場合は、プライベートサブネットのみが必要です。
オプション: [追加のセキュリティーグループ] を展開し、デフォルトのマシンプール内のノードに適用する追加のカスタムセキュリティーグループを選択します。すでにセキュリティーグループを作成し、このクラスター用に選択した VPC にそのグループを関連付けている必要があります。クラスターの作成後に、デフォルトのマシンプールにセキュリティーグループを追加または編集することはできません。
デフォルトでは、指定したセキュリティーグループはすべてのノードタイプに追加されます。ノードタイプごとに異なるセキュリティーグループを適用するには、Apply the same security groups to all node types チェックボックスをオフにします。
詳細は、関連情報 の セキュリティーグループ の要件を参照してください。
デフォルトのアプリケーション Ingress 設定を受け入れます。または、独自のカスタム設定を作成するには、Custom Settings を選択します。
- オプション: ルートセレクターを指定します。
- オプション: 除外する名前空間を指定します。
- namespace の所有権ポリシーを選択します。
ワイルドカードポリシーを選択します。
カスタムアプリケーションの Ingress 設定に関する詳細は、各設定の情報アイコンをクリックしてください。
クラスター全体のプロキシーを設定することを選択した場合は、クラスター全体のプロキシーの ページでプロキシーの設定詳細を入力してください。
次のフィールドの少なくとも 1 つに値を入力します。
- 有効な HTTP proxy URL を指定します。
- 有効な HTTPS proxy URL を指定します。
-
追加のトラストバンドル フィールドに、PEM エンコードされた X.509 証明書バンドルを指定します。このバンドルはクラスターノードの信頼済み証明書ストアに追加されます。TLS 検査プロキシーを使用する場合は、Red Hat Enterprise Linux CoreOS (RHCOS) トラストバンドルに含まれる認証局によって署名されたプロキシー用のアイデンティティー証明書がない限り、追加のトラストバンドルファイルが必要になります。この要件は、プロキシーが透過的であるか、
http-proxy引数およびhttps-proxy引数を使用して明示的な設定を必要とするかに関係なく適用されます。
Next をクリックします。
OpenShift Dedicated でのプロキシーの設定に関する詳細は、クラスター全体のプロキシーの設定 を参照してください。
CIDR 範囲 ダイアログで、カスタムの Classless Inter-Domain Routing (CIDR) 範囲を設定するか、指定のデフォルト値を使用します。
注記VPC にインストールする場合は、Machine CIDR 範囲を VPC サブネットに一致させる必要があります。
重要CIDR の設定は変更できません。続行する前に、ネットワーク管理者と選択内容を確認してください。
Cluster update strategy ページで、更新設定を行います。
クラスターの更新方法を選択します。
- 各更新を個別にスケジュールする場合は、Individual updates を選択します。以下はデフォルトのオプションになります。
Recurring updates を選択して、更新が利用可能な場合に、希望の曜日と開始時刻にクラスターを更新します。
注記OpenShift Dedicated の更新ライフサイクルのドキュメントでライフサイクルの終了日を確認できます。詳細は、OpenShift Dedicated 更新ライフサイクル を参照してください。
- 繰り返し更新を選択した場合は、ドロップダウンメニューから希望の曜日およびアップグレード開始時刻 (UTC) を選択します。
- オプション: クラスターのアップグレード時における ノード drain (Pod の退避) の猶予期間を設定できます。デフォルトでは、1 時間の 猶予期間が設けられています。
Next をクリックします。
注記クラスターのセキュリティーまたは安定性に大きく影響する重大なセキュリティー問題が発生した場合は、Red Hat Site Reliability Engineering (SRE) が、影響を受けない最新の z-stream バージョンへの自動更新をスケジュールすることがあります。お客様への通知を受け取ってから 48 時間以内に、アップデートが適用されます。重大な影響を及ぼすセキュリティー評価の説明は、Red Hat セキュリティー評価について を参照してください。
- 選択の概要を確認し、Create cluster をクリックしてクラスターのインストールを開始します。インストールが完了するまで約 30 - 40 分かかります。
- オプション: [概要] タブで、[削除保護: 無効 ] に移動して [有効にする] を選択することで、削除保護機能を有効にできます。この機能は、クラスターの削除に対する保護を提供します。削除保護を無効にするには、Disable を選択します。デフォルトでは、クラスターは削除保護機能が無効になった状態で作成されます。
検証
- クラスターの Overview ページで、インストールの進捗をモニターできます。同じページでインストールのログを表示できます。そのページの Details セクションの Status が Ready として表示されると、クラスターは準備が完了した状態になります。
2.4. OpenShift Cluster Manager を使用して、Red Hat クラウドアカウントで Google Cloud 上にクラスターを作成する リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Cluster Manager を使用して、Red Hat が所有する標準のクラウドプロバイダーアカウントを使用して Google Cloud に OpenShift Dedicated クラスターを作成できます。
手順
- OpenShift Cluster Manager にログインし、Create cluster をクリックします。
- Cloud タブで、Red Hat OpenShift Dedicated 行の Create cluster をクリックします。
Billing model セクションで、サブスクリプションのタイプおよびインフラストラクチャーのタイプを設定します。
Annual サブスクリプションタイプを選択します。Red Hat クラウドアカウントを使用してクラスターをデプロイする場合は、Annual サブスクリプションタイプのみを使用できます。
OpenShift Dedicated サブスクリプションオプションは、OpenShift Cluster Manager ドキュメントの クラスターのサブスクリプションと登録 を参照してください。
注記Annual サブスクリプションタイプに必要なリソースクォータが利用可能でなければなりません。詳細は、営業担当者または Red Hat サポートにお問い合わせください。
- Red Hat cloud account インフラストラクチャータイプを選択して、Red Hat が所有するクラウドプロバイダーアカウントに OpenShift Dedicated をデプロイします。
- Next をクリックします。
- Run on Google Cloud を選択し、Next をクリックします。
Cluster details ページで、クラスターの名前を指定し、クラスターの詳細を指定します。
- Cluster name を追加します。
オプション: クラスターを作成すると、
openshiftapps.comにプロビジョニングされたクラスターのサブドメインとしてドメイン接頭辞が生成されます。クラスター名が 15 文字以下の場合は、その名前がドメイン接頭辞に使用されます。クラスター名が 15 文字を超える場合、ドメイン接頭辞は 15 文字の文字列としてランダムに生成されます。サブドメインをカスタマイズするには、Create custom domain prefix チェックボックスをオンにし、Domain prefix フィールドにドメイン接頭辞名を入力します。ドメイン接頭辞は 15 文字を超えてはならず、組織内で一意である必要があり、クラスターの作成後に変更できません。
- Version ドロップダウンメニューからクラスターバージョンを選択します。
Channel group ドロップダウンメニューからチャネルグループを選択します。
注記チャネルグループオプションには、Stable (デフォルトオプション) と EUS が含まれます。Stable および EUS チャネルグループオプションの詳細は、更新チャネルとリリースについて を参照してください。
- Region ドロップダウンメニューからクラウドプロバイダーのリージョンを選択します。
- Single zone または Multi-zone 設定を選択します。
- クラスターの Persistent storage 容量を選択します。詳細は、OpenShift Dedicated サービス定義の Storage セクションを参照してください。
- クラスターに必要な Load balancers の数を指定します。詳細は、OpenShift Dedicated サービス定義の Load balancers セクションを参照してください。
オプション: クラスターのインストール時に Shielded VM を使用するには、Enable Secure Boot support for Shielded VMs を選択します。クラスターを作成すると、Enable Secure Boot support for Shielded VMs 設定を変更できなくなります。詳細は、Shielded VMs を参照してください。
重要組織でポリシー制約
constraints/compute.requireShieldedVmが有効になっている場合、クラスターを正常に作成するには、Enable Secure Boot support for Shielded VMs を選択する必要があります。Google Cloud 組織ポリシーの制約に関する詳細は、組織ポリシーの制約 を参照してください。重要ベアメタルインスタンスタイプを使用して作成された Google Cloud 上の OpenShift Dedicated クラスターでは、Enable Secure Boot support for Shielded VMs はサポートされていません。詳細は、Google Cloud ドキュメントの Limitations を参照してください。
- Enable user workload monitoring を選択したままにして、Red Hat サイト信頼性エンジニアリング (SRE) プラットフォームメトリクスから切り離して独自のプロジェクトをモニターします。このオプションはデフォルトで有効になっています。
オプション: Advanced Encryption を展開して、暗号化設定を変更します。
オプション: クラスターで FIPS 検証を必須にする場合は、Enable FIPS cryptography を選択します。
注記Enable FIPS cryptography を選択すると、Enable additional etcd encryption がデフォルトで有効になり、無効にできなくなります。Enable FIPS cryptography を選択しなくても、Enable additional etcd encryption は選択できます。
オプション: etcd キー値の暗号化が必要な場合は、Enable additional etcd encryption を選択します。このオプションを使用すると、etcd キーの値は暗号化されますが、キーは暗号化されません。このオプションは、デフォルトで OpenShift Dedicated クラスターの etcd ボリュームを暗号化するコントロールプレーンのストレージ暗号化に追加されます。
注記etcd のキー値の etcd 暗号化を有効にすると、約 20% のパフォーマンスのオーバーヘッドが発生します。このオーバーヘッドは、etcd ボリュームを暗号化するデフォルトのコントロールプレーンのストレージ暗号化に加えて、この 2 つ目の暗号化レイヤーの導入により生じます。お客様のユースケースで特に etcd 暗号化が必要な場合にのみ、暗号化を有効にすることを検討してください。
- Next をクリックします。
Default machine pool ページで、Compute node instance type および Compute node count を選択します。利用可能なノードの数およびタイプは、OpenShift Dedicated のサブスクリプションによって異なります。複数のアベイラビリティーゾーンを使用している場合、コンピュートノード数はゾーンごとに設定されます。
注記クラスターの作成後に、コンピュートノード数を変更できますが、マシンプールのコンピュートノードインスタンスのタイプを変更することはできません。CCS モデルを使用するクラスターの場合、インストール後に別のインスタンスタイプを使用するマシンプールを追加できます。利用可能なノード数および種類は、OpenShift Dedicated のサブスクリプションに応じて異なります。
- オプション: Edit node labels を展開してラベルをノードに追加します。Add label をクリックしてさらにノードラベルを追加し、Next を選択します。
- Cluster privacy ダイアログボックスで、Public または Private を選択し、クラスターのパブリックまたはプライベート API エンドポイントおよびアプリケーションルートを使用します。
- Next をクリックします。
CIDR ranges ダイアログで、カスタムの Classless Inter-Domain Routing (CIDR) 範囲を設定するか、提供されるデフォルトを使用します。
重要CIDR 設定は後で変更することはできません。続行する前に、ネットワーク管理者と選択内容を確認してください。
クラスターのプライバシーが Private に設定されている場合は、クラウドプロバイダーでプライベート接続を設定するまでクラスターにアクセスできません。
Cluster update strategy ページで、更新設定を行います。
クラスターの更新方法を選択します。
- 各更新を個別にスケジュールする場合は、Individual updates を選択します。以下はデフォルトのオプションになります。
Recurring updates を選択して、更新が利用可能な場合に、希望の曜日と開始時刻にクラスターを更新します。
注記OpenShift Dedicated の更新ライフサイクルのドキュメントでライフサイクルの終了日を確認できます。詳細は、OpenShift Dedicated 更新ライフサイクル を参照してください。
クラスターの更新方法に基づいて管理者の承認を提供します。
- 個別の更新: 承認が必要な更新バージョンを選択した場合は、管理者の確認を提供し、Approve and continue をクリックします。
- 定期的な更新: クラスターの定期的な更新を選択した場合は、管理者の確認を提供し、Approve and continue をクリックします。OpenShift Cluster Manager が、管理者承認なしでマイナーバージョンのスケジュールされた y-stream 更新を開始することはありません。
- 繰り返し更新を選択した場合は、ドロップダウンメニューから希望の曜日およびアップグレード開始時刻 (UTC) を選択します。
- オプション: クラスターのアップグレード時における ノード drain (Pod の退避) の猶予期間を設定できます。デフォルトで 1 時間 の猶予期間が設定されています。
Next をクリックします。
注記クラスターのセキュリティーまたは安定性に大きく影響する重大なセキュリティー問題がある場合、Red Hat サイト信頼性エンジニアリング (SRE) は、影響を受けない最新の z ストリームバージョンへの自動更新をスケジュールする場合があります。更新は、お客様に通知された後、48 時間以内に適用されます。重大な影響を及ぼすセキュリティー評価の説明は、Red Hat セキュリティー評価について を参照してください。
- 選択の概要を確認し、Create cluster をクリックしてクラスターのインストールを開始します。インストールが完了するまで約 30 - 40 分かかります。
- オプション: Overview タブで、Delete Protection: Disabled のすぐ下にある Enable を選択して、削除保護機能を有効にできます。これにより、クラスターが削除されなくなります。削除保護を無効にするには、Disable を選択します。デフォルトでは、クラスターは削除保護機能が無効になった状態で作成されます。
検証
- クラスターの Overview ページで、インストールの進捗をモニターできます。同じページでインストールのログを表示できます。そのページの Details セクションの Status が Ready として表示されると、クラスターは準備が完了した状態になります。
インストール中にクラスターのデプロイメントが失敗すると、インストールプロセス中に作成された特定のリソースが Google Cloud アカウントから自動的に削除されません。Google Cloud アカウントからこれらのリソースを削除するには、障害が発生したクラスターを削除する必要があります。
2.5. アイデンティティープロバイダーの設定 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Dedicated のインストール後に、アイデンティティープロバイダーを使用するようにクラスターを設定する必要があります。その後、メンバーをアイデンティティープロバイダーに追加して、クラスターへのアクセス権限を付与できます。
OpenShift Dedicated クラスターに異なるアイデンティティープロバイダータイプを設定できます。サポート対象のタイプには、GitHub、GitHub Enterprise、GitLab、Google、LDAP、OpenID Connect、htpasswd アイデンティティープロバイダーが含まれます。
htpasswd ID プロバイダーオプションは、単一の静的管理ユーザーの作成を可能にする目的で含まれています。htpasswd は、OpenShift Dedicated の汎用 ID プロバイダーとしてはサポートされていません。
以下の手順では、例として GitHub アイデンティティープロバイダーを設定します。
GitHub 認証を設定することによって、ユーザーは GitHub 認証情報を使用して OpenShift Dedicated にログインできます。GitHub ユーザー ID を持つすべてのユーザーが OpenShift Dedicated クラスターにログインできないようにするには、アクセスを特定の GitHub 組織またはチームのユーザーに制限する必要があります。
前提条件
- OpenShift Cluster Manager にログインしている。
- OpenShift Dedicated クラスターを作成している。
- GitHub ユーザーアカウントがある。
- GitHub アカウントに GitHub 組織を作成している。詳細は、GitHub ドキュメントの Creating a new organization from scratch を参照してください。
- GitHub チームへのユーザーアクセスを制限する場合は、GitHub 組織にチームを作成している。詳細は、GitHub ドキュメントの Creating a team を参照してください。
手順
- OpenShift Cluster Manager に移動し、クラスターを選択します。
- Access control → Identity providers の順に選択します。
- Add identity provider ドロップダウンメニューから GitHub アイデンティティープロバイダータイプを選択します。
- アイデンティティープロバイダーの一意の名前を入力します。この名前は後で変更できません。
GitHub ドキュメント の手順に従って、GitHub 組織に OAuth アプリケーションを登録します。
注記GitHub 組織で OAuth アプリケーションを登録する必要があります。クラスターユーザーまたはチームを含む組織が所有しない OAuth アプリケーションを登録すると、クラスターに対するユーザー認証は成功しません。
GitHub OAuth アプリケーション設定のホームページ URL には、OpenShift Cluster Manager の Add a GitHub identity provider ページに自動生成される OAuth コールバック URL の
https://oauth-openshift.apps<cluster_name>.<cluster_domain>の部分を指定します。以下は、GitHub アイデンティティープロバイダーのホームページ URL の例です。
https://oauth-openshift.apps.openshift-cluster.example.comGitHub OAuth アプリケーション設定の承認コールバック URL には、OpenShift Cluster Manager の Add a GitHub identity provider ページに自動生成される完全な OAuth コールバック URL を指定します。完全な URL の構文は以下のとおりです。
https://oauth-openshift.apps.<cluster_name>.<cluster_domain>/oauth2callback/<idp_provider_name>
- OpenShift Cluster Manager の Edit identity provider: GitHub ダイアログに戻り、Mapping method ドロップダウンメニューから Claim を選択します。
- GitHub OAuth アプリケーションの Client ID および Client secret を入力します。OAuth アプリケーションの GitHub ページには、ID およびシークレットがあります。
オプション: ホスト名 を入力します。
注記GitHub Enterprise のホステッドインスタンスを使用する場合は、ホスト名を入力する必要があります。
- 任意手順: 認証局 (CA) ファイルを使用して、設定された GitHub Enterprise URL のサーバー証明書を検証できます。Browse をクリックして CA ファイル を見つけ、これをアイデンティティープロバイダーに割り当てます。
- Use organizations または Use teams を選択して、組織内の GitHub 組織または GitHub チームへのアクセスを制限します。
アクセスを制限する組織またはチームの名前を入力します。Add more をクリックして、複数の組織またはチームを指定します。
注記前述の手順で登録された OAuth アプリケーションを所有する組織を指定する必要があります。チームを指定する場合は、前述の手順を使用して登録された OAuth アプリケーションを所有する組織内に存在するチームを指定する必要があります。
Add をクリックしてアイデンティティープロバイダーの設定を適用します。
注記アイデンティティープロバイダー設定がアクティブになるまでに、約 2 分かかる場合があります。
検証
- 設定がアクティブになると、アイデンティティープロバイダーはクラスターの OpenShift Cluster Manager ページの Access control → Identity providers にリスト表示されます。
2.6. ユーザーへの管理者権限の付与 リンクのコピーリンクがクリップボードにコピーされました!
クラスターにアイデンティティープロバイダーを設定し、ユーザーをアイデンティティープロバイダーに追加した後に、dedicated-admin クラスターの権限をユーザーに付与できます。
前提条件
- OpenShift Cluster Manager にログインしている。
- OpenShift Dedicated クラスターを作成している。
- クラスターにアイデンティティープロバイダーを設定している。
手順
- OpenShift Cluster Manager に移動し、クラスターを選択します。
- Access control タブをクリックします。
- Cluster Roles and Access タブで、Add user をクリックします。
- アイデンティティープロバイダーユーザーのユーザー ID を入力します。
-
Add user をクリックして、
dedicated-adminクラスター権限をユーザーに付与します。
検証
-
権限の付与後、ユーザーは、クラスターの OpenShift Cluster Manager ページの Access control → Cluster Roles and Access で
dedicated-adminsグループの一部として一覧表示されます。
2.7. クラスターへのアクセス リンクのコピーリンクがクリップボードにコピーされました!
アイデンティティープロバイダーを設定したら、ユーザーは Red Hat OpenShift Cluster Manager からクラスターにアクセスできます。
前提条件
- OpenShift Cluster Manager にログインしている。
- OpenShift Dedicated クラスターを作成している。
- クラスターにアイデンティティープロバイダーを設定している。
- 設定したアイデンティティープロバイダーにユーザーアカウントを追加している。
手順
- OpenShift Cluster Manager から、アクセスするクラスターを選択します。
- Open console をクリックし、クラスターの Web コンソールを開きます。
- アイデンティティープロバイダーを選択し、認証情報を入力してクラスターにログインします。プロバイダーからの認可リクエストを完了します。
2.8. Developer Catalog からのアプリケーションのデプロイ リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Dedicated Web コンソールの、Developer Catalog からテストアプリケーションをデプロイし、ルートで公開できます。
前提条件
- Red Hat Hybrid Cloud Console にログインしている。
- OpenShift Dedicated クラスターを作成している。
- クラスターにアイデンティティープロバイダーを設定している。
- 設定したアイデンティティープロバイダーにユーザーアカウントを追加している。
手順
- OpenShift Cluster Manager の Cluster List ページに移動します。
- 表示するクラスターの横にあるオプションアイコン (⋮) をクリックします。
- Open console をクリックします。
- クラスターコンソールが新しいブラウザーウィンドウで開きます。設定済みのアイデンティティープロバイダーの認証情報を使用して Red Hat アカウントにログインします。
- Administrator パースペクティブで、Home → Projects → Create Project の順に選択します。
- プロジェクトの名前を入力し、必要に応じて Display Name および Description を追加します。
- Create をクリックしてプロジェクトを作成します。
- Developer パースペクティブに切り替え、+Add を選択します。選択した プロジェクト が、あなたが作成したプロジェクトであることを確認してください。
- Developer Catalog ダイアログで、All services を選択します。
- Developer Catalog ページで、メニューから Languages → JavaScript を選択します。
Node.js をクリックし、次に Create をクリックして、Create Source-to-Image application ページを開きます。
注記場合によっては、Clear All Filters をクリックして Node.js オプションを表示する必要があります。
- Git セクションで Try sample をクリックします。
- Name フィールドに一意の名前を追加します。この値は、関連付けられたリソースに名前を付けるために使用されます。
- Deployment と Create a route が選択されていることを確認します。
- Create をクリックしてアプリケーションをデプロイします。Pod の展開には数分かかります。
-
オプション: Node.js アプリケーションを選択してそのサイドバーを確認し、Topology ペインで Pod のステータスを確認します。
nodejsビルドが完了し、nodejsPod が Running 状態になるまで待機してから続行します。 デプロイメントが完了したら、以下のような形式のアプリケーションのルート URL をクリックします。
https://nodejs-<project>.<cluster_name>.<hash>.<region>.openshiftapps.com/ブラウザーの新しいタブが開き、以下のようなメッセージが表示されます。
Welcome to your Node.js application on OpenShiftオプション: アプリケーションを削除し、作成したリソースをクリーンアップします。
- Administrator パースペクティブで、Home → Projects に移動します。
- プロジェクトのアクションメニューをクリックし、Delete Project を選択します。
2.9. クラスターのスケーリング リンクのコピーリンクがクリップボードにコピーされました!
ロードバランサーの数、永続ストレージの容量、および OpenShift Cluster Manager の OpenShift Dedicated クラスターのノード数をスケーリングできます。
前提条件
- OpenShift Cluster Manager にログインしている。
- OpenShift Dedicated クラスターを作成している。
手順
ロードバランサーまたは永続ストレージの容量をスケーリングするには、以下を実行します。
- OpenShift Cluster Manager に移動し、クラスターを選択します。
- Actions ドロップダウンメニューから Edit load balancers and persistent storage を選択します。
- スケーリングする ロードバランサー の数を選択します。
- スケーリングする 永続ストレージ 容量を選択します。
- Apply をクリックします。スケーリングは自動的に実行されます。
ノード数をスケーリングするには、以下を実行します。
- OpenShift Cluster Manager に移動し、クラスターを選択します。
- Actions ドロップダウンメニューから Edit node count を選択します。
- マシンプール を選択します。
- ゾーンごとに ノード数 を選択します。
- Apply をクリックします。スケーリングは自動的に実行されます。
検証
- 概要 タブの 詳細 セクションでは、ロードバランサーの設定、永続ストレージの詳細、実際のノード数と必要なノード数を確認できます。
2.10. ユーザーからの管理者権限の削除 リンクのコピーリンクがクリップボードにコピーされました!
ユーザーに dedicated-admin 特権を付与した後、その特権が不要になった時点で取り消すことができます。
前提条件
- OpenShift Cluster Manager にログインしている。
- OpenShift Dedicated クラスターを作成している。
- クラスターに GitHub アイデンティティープロバイダーを設定し、アイデンティティープロバイダーユーザーを追加している。
-
ユーザーに
dedicated-admin権限が付与されている。
手順
- OpenShift Cluster Manager に移動し、クラスターを選択します。
- Access control タブをクリックします。
-
Cluster Roles and Access タブで、ユーザーの横にある
を選択し、Delete をクリックします。
検証
-
権限を取り消すと、ユーザーは、クラスターの OpenShift Cluster Manager ページの Access control → Cluster Roles および Access に
dedicated-adminsグループの一部として一覧表示されなくなります。
2.11. クラスターへのユーザーアクセスの取り消し リンクのコピーリンクがクリップボードにコピーされました!
アイデンティティープロバイダーを設定済みのアイデンティティープロバイダーから削除して、アイデンティティープロバイダーユーザーのクラスターアクセス権を取り消すことができます。
OpenShift Dedicated クラスターに異なるタイプのアイデンティティープロバイダーを設定できます。以下の手順例では、クラスターへのアイデンティティープロビジョニング用に設定された GitHub 組織またはチームのメンバーのクラスターアクセス権を取り消すことができます。
前提条件
- OpenShift Dedicated クラスターがある。
- GitHub ユーザーアカウントがある。
- クラスターに GitHub アイデンティティープロバイダーを設定し、アイデンティティープロバイダーユーザーを追加している。
手順
- github.com に移動し、GitHub アカウントにログインします。
GitHub 組織またはチームからユーザーを削除します。
- アイデンティティープロバイダー設定で GitHub 組織を使用する場合は、GitHub ドキュメントの 組織からのメンバーの削除 の手順に従います。
- アイデンティティープロバイダー設定が GitHub 組織のチームを使用する場合は、GitHub ドキュメントの チームからの組織メンバーの削除 の手順に従います。
検証
- アイデンティティープロバイダーからユーザーを削除すると、そのユーザーはクラスターで認証されません。
2.12. クラスターの削除 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat OpenShift Cluster Manager で OpenShift Dedicated クラスターを削除できます。
前提条件
- OpenShift Cluster Manager にログインしている。
- OpenShift Dedicated クラスターを作成している。
手順
- OpenShift Cluster Manager から、削除するクラスターを選択します。
- Actions ドロップダウンメニューから Delete cluster を選択します。
太字で強調表示されているクラスターの名前を入力してから Delete をクリックします。クラスターの削除は自動的に実行されます。
注記Google Cloud 共有 VPC にインストールされたクラスターを削除する場合は、ホストプロジェクトの VPC オーナーに、クラスター作成時に言及したサービスアカウントに付与された IAM ポリシーロールを削除するように通知します。